[SCM] gmerlin-avdecoder/master: Document use of CDBS and git in README.source (not comments in debian/rules).

[js at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 2bae89bab1d6b6569e8e025fc6dfa60ab4779d66
Author: Jonas Smedegaard <dr at jones.dk>
Date:   Sun Mar 25 18:57:08 2012 +0200

    Document use of CDBS and git in README.source (not comments in debian/rules).

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..75efe2f
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,50 @@
+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 git and the helper tool
+git-buildpackage, with all official releases tagged and signed and
+binary diffs of tarballs stored using pristine-tar.  This is documented
+below /usr/share/doc/git-buildpackage/manual-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
diff --git a/debian/rules b/debian/rules
index 0f81138..77f751d 100755
--- a/debian/rules
+++ b/debian/rules
@@ -40,10 +40,6 @@ DEB_UPSTREAM_REPACKAGE_EXCLUDES += ./lib/os_inet_aton.c
 
 DEB_UPSTREAM_TARBALL_MD5 = c1ea663e9da631453eec4ac79138b6c5
 
-# In order to regenerate 'debian/control' :
-#    DEB_AUTO_UPDATE_DEBIAN_CONTROL=yes fakeroot debian/rules clean
-# Then check manually if everything's ok
-
 DEB_CONFIGURE_EXTRA_FLAGS := --docdir=\$${prefix}/share/doc/libgmerlin-avdec-doc
 DEB_DH_MAKESHLIBS_ARGS_ALL := -- -v$(DEB_UPSTREAM_VERSION)
 

-- 
gmerlin-avdecoder packaging