[SCM] supercollider/master: Replace README.source: Drop notes on no longer used quilt. Add notes on git-buildpackage and CDBS.

[js at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit b6c188e0afa958ca2f2d04a6da1e6886eee1d5b6
Author: Jonas Smedegaard <dr at jones.dk>
Date:   Wed Feb 8 00:26:13 2012 +0100

    Replace README.source: Drop notes on no longer used quilt. Add notes on git-buildpackage and CDBS.

diff --git a/debian/README.source b/debian/README.source
index 85880c2..f449937 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -1,35 +1,33 @@
-This package uses CDBS (and therefore simple-patchsys.mk) in order to 
-apply patches to the upstream source. Patches are stored in 
-debian/patches and their filenames usually end in .patch or .diff .
-For further details, see the man page for cdbs-edit-patch.
+Building this package for Debian
+--------------------------------
 
-All commands described below should be run from the top directory of the 
-package source tree, unless otherwise stated.
+This source package need no special handling for normal package builds.
 
- * To generate the fully patched source, in a form ready for
-   editing, that would be built to create Debian packages, run: 
 
-     make -f debian/rules apply-patches
+Developing this package for Debian
+----------------------------------
 
-   Note: It has been proposed that, in future, this should happen 
-   automatically when you run dpkg-source -x on a CDBS 
-   simple-patchsys.mk source package.  However, this proposal has 
-   apparently not yet been implemented, so for now you have to do 
-   it yourself like this.
+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/ .
 
- * To modify the source and save those modifications so that
-   they will be applied when building the package, pick a
-   suitably informative patch file name, for example
-   01_add_README.source_file.patch, and then run:
+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.
 
-     cdbs-edit-patch 01_add_README.source_file.patch
 
-   This will place you in a new shell in a temporary copy of the 
-   source tree.  Make your desired modifications to it, and then 
-   exit the shell to create the patch file containing them (this 
-   file will appear in debian/patches).
+Maintaining packaging build routines
+------------------------------------
 
- * To remove source modifications that are currently being
-   applied when building the package, run:
+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 .
 
-     make -f debian/rules reverse-patches
+
+ -- Jonas Smedegaard <dr at jones.dk>  Thu, 26 Feb 2009 21:28:29 +0100

-- 
supercollider packaging