r36882 - in /trunk/libconfig-inifiles-perl/debian: README.cdbs-tweaks README.source rules

[js at users.alioth.debian.org]

Author: js
Date: Sun May 31 01:58:07 2009
New Revision: 36882

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=36882
Log:
Add README.source (and drop other CDBS notes): Merge-in svn+tarball+misc branch of git://git.debian.org/git/collab-maint/cdbs-skel.

Added:
    trunk/libconfig-inifiles-perl/debian/README.source
Removed:
    trunk/libconfig-inifiles-perl/debian/README.cdbs-tweaks
Modified:
    trunk/libconfig-inifiles-perl/debian/rules

Added: trunk/libconfig-inifiles-perl/debian/README.source
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libconfig-inifiles-perl/debian/README.source?rev=36882&op=file
==============================================================================
--- trunk/libconfig-inifiles-perl/debian/README.source (added)
+++ trunk/libconfig-inifiles-perl/debian/README.source Sun May 31 01:58:07 2009
@@ -1,0 +1,49 @@
+Building this package for Debian
+--------------------------------
+
+This source package need no special handling for normal package builds.
+
+
+Developing this package for Debian
+----------------------------------
+
+The source of this package is developed using Subversion and the helper
+tool svn-buildpackage in mergeWithUpstream-mode.  This is documented
+below /usr/share/doc/svn-buildpackage/HOWTO.html/ .
+
+A custom build target shows current upstream and packaging versions:
+
+    debian/rules print-version
+
+Current upstream tarball can be prepared using this other build target:
+
+    debian/rules get-orig-source
+
+To switch to newer upstream source, first add a dummy changelog entry
+and comment out DEB_UPSTREAM_TARBALL_MD5 before getting the source:
+
+    dch -v ${new_upstream_version}-1 "Dummy changelog entry"
+    sed -i -e 's/^\(DEB_UPSTREAM_TARBALL_MD5\b\)/#\1/' debian/rules
+    debian/rules get-orig-source
+
+Store new md5sum to help ensure identical source is received later.
+
+Setting DEB_MAINTAINER_MODE=1 enables additional build routines helpful
+during development of the package, but unfit for normal builds.  This
+typically includes the CDBS feature of auto-updating debian/control with
+CDBS-related build-dependencies, which is forbidden by Debian Policy as
+build environment must not change during automated builds.
+
+
+Maintaining packaging build routines
+------------------------------------
+
+This source package wraps debhelper commands and other tedious parts of
+the build routines using the CDBS framework.  Please refer to the actual
+makefile snippets included from debian/rules for details on their
+purpose and ways to override defaults.  Additionally, makefile snippets
+included from below /usr/share/cdbs may also be documented in
+/usr/share/doc/cdbs/cdbs-doc.pdf.gz .
+
+
+ -- Jonas Smedegaard <dr at jones.dk>  Thu, 26 Feb 2009 21:28:29 +0100

Modified: trunk/libconfig-inifiles-perl/debian/rules
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libconfig-inifiles-perl/debian/rules?rev=36882&op=diff
==============================================================================
--- trunk/libconfig-inifiles-perl/debian/rules (original)
+++ trunk/libconfig-inifiles-perl/debian/rules Sun May 31 01:58:07 2009
@@ -2,7 +2,6 @@
 # -*- mode: makefile; coding: utf-8 -*-
 # Copyright © 2003-2009 Jonas Smedegaard <dr at jones.dk>
 
-# See debian/README.cdbs-tweaks for info on local overrides
 ifneq (,$(DEB_MAINTAINER_MODE))
   # Enable stuff not policy compliant (eg. unsuitable for build daemons)
   DEB_COPYRIGHT_CHECK_STRICT = yes