From: martin f. krafft <madduck@debian.org>
Date: Mon, 17 Nov 2008 22:39:16 +0000 (+0100)
Subject: update workflow to use tg-export debian/rules target
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=topgit.git;a=commitdiff_plain;h=f609666a07395f6eaf735ac27a9a2be0883419d9;hp=60f7d3c29807cebf9c45540a37616dd940ea7c91

update workflow to use tg-export debian/rules target

Signed-off-by: martin f. krafft <madduck@debian.org>
---

diff --git a/debian/README.source b/debian/README.source
index ba9cdd0..6717ff4 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -62,22 +62,31 @@ The upstream tarball for $VERSION can be obtained using pristine-tar:
 
 4. Building the package
 ~~~~~~~~~~~~~~~~~~~~~~~
-To build the package, you check out the build branch, recreate debian/patches,
-commit, build, test, upload, tag:
+To build the package, you are encouraged to include the TopGit make snippet at
+the top of debian/rules:
 
-1. git checkout build
-2. git merge master
-3. rm -r debian/patches
-4. tg export -b debian/locations --quilt debian/patches
-5. git add debian/patches
-6. git commit -m'preparing 0.5-1'
-7. build, test, upload, tag ('debian/topgit-0.5-1')
+  -include /usr/share/topgit/topgit.mk
+
+This will provide the tg-export target, which will create a quilt series of
+all TopGit branches in the current repository.
+
+You can also set the variable TG_BRANCHES to a space- or comma-separated list
+(but not comma and space) of feature branches to export, e.g.:
 
-This process is still very cumbersome and needs to be improved, ideally within
-TopGit.
+  TG_BRANCH := branch1,branch2
+  TG_BRANCH := 'branch3 branch4 branch 5'
 
-TODO: provide Makefile snippet for the above to prevent useless duplication (#501991)
-TODO: rewrite to use tg-export -b, which will be fixed in TopGit 0.5 (#500273)
+(The TopGit package actually uses the local version of the file)
+
+When you are ready to build, you check out the build branch, recreate
+debian/patches, commit, build, test, upload, tag:
+
+1. git checkout build
+2. git merge master
+3. ./debian/rules tg-export
+4. git add debian/patches
+5. git commit -m'preparing 0.5-1'
+6. build, test, upload, tag ('debian/topgit-0.5-1')
 
 5. Importing a new upstream version
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~