[SCM] ezstream/master: Add README.source. Drop custom hints about CDBS.

js at users.alioth.debian.org js at users.alioth.debian.org
Wed Oct 20 08:24:44 UTC 2010


The following commit has been merged in the master branch:
commit d7e648c752695900e0a03839ef0e2f78abf0e0f7
Author: Jonas Smedegaard <dr at jones.dk>
Date:   Wed Oct 20 10:14:30 2010 +0200

    Add README.source. Drop custom hints about CDBS.

diff --git a/debian/README.cdbs-tweaks b/debian/README.cdbs-tweaks
deleted file mode 100644
index 5880b2f..0000000
--- a/debian/README.cdbs-tweaks
+++ /dev/null
@@ -1,111 +0,0 @@
-CDBS tweak
-==========
-
-CDBS is great. In some corner cases, however, some parts of CDBS
-sometimes needs a few tweaks to work optimally.
-
-This is a collection of such tweaks. The goal is for these tweaks to be
-absorbed into upstream CDBS. We just haven't found time yet to discuss
-them at the CDBS developers' mailinglist. And possible we do not all
-agree that the tweaks are so great - therefore this "staging area".
-
-If you found this file below debian/ subdir in a source package, most
-probably only a subset of the below mentioned tweaks are relevant and
-have been shipped with the package. The repository of all these tweaks
-is here: svn://svn.debian.org/build-common/people/js/overlay/
-
-Web access: http://svn.debian.org/wsvn/build-common/people/js/overlay/
-
-
-
-New buildinfo rule
-------------------
-
-See package description for "buildinfo" for more info.
-
-
-
-Improved support for multiple compilations
-------------------------------------------
-
-Create and clean builddir _after_ resolving per-package DEB_BUILDDIR.
-
-Honour per-package DEB_BUILDDIR in makefile and autotools classes.
-
-Support multiple build flavors in makefile and autotools classes.
-
-
-
-Various improvements to python-distutils class
-----------------------------------------------
-
-Use full path to Python interpreter (Python Policy section 1.3.2).
-
-Add CDBS_BUILD_DEPENDS to old policy method.
-
-Fix CDBS_BUILD_DEPENDS in new policy methods to only depend on debhelper
-when actually used.
-
-Fix DEB_PYTHON_SIMPLE_PACKAGES sometimes installed twice (and only one
-of them honouring DEB_PYTHON_COMPILE_VERSION).
-
-Unify install path using new DEB_PYTHON_DESTDIR.
-
-Quote install path.
-
-
-
-New python-autotools class
---------------------------
-
-Handle autotools-based Python packaging.
-
-
-
-New python-sugar class
-----------------------
-
-Handle packaging of Sugar activities.
-
-
-
-New copyright-check rule
-------------------------
-
-Refuse to build if the source is found to contain different copyright
-info than earlier builds.
-
-
-
-New kernelpatches rule
-----------------------
-
-Small wrapper around dh-kpatches, taking care of build-dependencies too.
-
-
-
-New routines for handling upstream tarball
-------------------------------------------
-
-Rules and variables to help downloading, validating and repackaging
-upstream tarball.
-
-Implements the rules print-version and get-orig-source commonly used
-for group-maintained packages with Debian-specific patches maintained in
-SVN or some other VCS, and automated fetching virgin upstream tarball
-(possibly massaged after download e.g. to strip non-DFSG material).
-
-
-
-Support for custom BTS info
----------------------------
-
-Include BTS control info found in debian/*.bts files, or alternatively
-redirect bug reports to the email address defined in DEB_BTS_EMAIL.
-
-
-
-New dict class
---------------
-
-Rules for packaging ispell, aspell, myspell and wordlist dictionaries.
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

-- 
ezstream packaging



More information about the pkg-multimedia-commits mailing list