[DRE-commits] [ruby-rjb] 04/04: Add debian/README.source

[Jérémy Bobbio]

This is an automated email from the git hooks/post-receive script.

lunar pushed a commit to branch master
in repository ruby-rjb.

commit 721947507af09e057c21d53e30a9ac13b81b6c2e
Author: Jérémy Bobbio <lunar at debian.org>
Date:   Tue Aug 13 23:33:54 2013 +0200

    Add debian/README.source
---
 debian/README.source |   42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..0f976f6
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,42 @@
+Debian packaging for rjb
+========================
+
+rjb is managed in a Git repository using git-buildpackage (with
+pristine-tar). It follows most of the advice provided by Russ Allbery at:
+http://www.eyrie.org/~eagle/notes/debian/git.html
+
+Upstream source handling is a bit complicated because:
+
+ * upstream tarballs do not contain all files in their preferred form of
+   modifications,
+ * upstream is using Git,
+ * upstream stores non-free files in their Git repository.
+
+Creating an updated package for a new upstream release goes as:
+
+0. Add a remote with upstream repository if not already done:
+
+    $ git remote add github-upstream https://github.com/arton/rjb
+
+1. Fetch new commits from upstream repository:
+
+    $ git fetch github-upstream
+
+2. Verify the tag for the new version:
+
+    $ git tag -v v$VERSION
+
+3. Create temporary source tarball from upstream tag:
+
+    $ git archive --format=tar --prefix=rjb-$VERSION/ v$VERSION |
+          gzip -c > ../upstream-rjb-$VERSION.tar.gz
+
+4. Import new upstream tarball using git-import-orig:
+
+    $ git-import-orig ../upstream-rjb-$VERSION.tar.gz --upstream-vcs-tag=v$VERSION -u$VERSION --pristine-tar
+
+5. Hack, improve, update debian/changelog…
+
+6. Build a new package:
+
+    $ git-buildpackage

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-ruby-extras/ruby-rjb.git