From 10db737c2cde44017cad91d480e29d62437381cd Mon Sep 17 00:00:00 2001 From: Ben Finney Date: Tue, 19 Apr 2016 17:00:05 +1000 Subject: [PATCH] Document how the source package is built. --- debian/README.source | 28 ++++++++++++++++++++++++++++ debian/changelog | 2 ++ 2 files changed, 30 insertions(+) diff --git a/debian/README.source b/debian/README.source index 9603a9d..67d0827 100644 --- a/debian/README.source +++ b/debian/README.source @@ -8,6 +8,7 @@ The source tarballs for ComixCursors are stored at a $FOO-Forge site with awkward redirection done via HTML. Currently ‘uscan(1)’ is unable to recognise or download these files automatically. + Getting the latest upstream source ---------------------------------- @@ -27,6 +28,33 @@ specific versions of the upstream source, this must be done manually: You can then update the ‘debian/changelog’ as usual and use ‘bzr-buildpackage --source’ as usual to create a Debian source package. + +Build source package from VCS +----------------------------- + +The source for the Debian packaging is managed in these conventional +Git branches: + +* master: The current released code base. +* packaging: Debian packaging development branch. +* upstream: Upstream source code base, as imported from tarballs. +* pristine-tar: Metadata for reproducibly generating upstream tarball. + +To build the source package from the Git VCS, use the Debian ‘gitpkg’ +tool to generate all the files:: + + $ git checkout master + $ gitpkg packaging upstream + +The ‘dpkg-source’ process will complain about the “deletion” of +upstream source. This is because the upstream source is not present at +all in the ‘packaging’ branch exported, but in the ‘upstream’ branch. +The upstream source is safely exported earlier in its own tarball. + +The generated source package is the source control file +‘../deb-packages/comixcursors/comixcursors_$DEBIANVER.dsc’ and its +associated files in that directory. + .. Local variables: diff --git a/debian/changelog b/debian/changelog index 98fdf02..8d1b338 100644 --- a/debian/changelog +++ b/debian/changelog @@ -8,6 +8,8 @@ comixcursors (0.8.2-2) UNRELEASED; urgency=low * Add editor hints. * Update copyright notices. * Distinguish license conditions from license grants. + * debian/README.source: + * Document how the source package is built. -- -- 2.11.4.GIT