[DRE-commits] [ruby-rjb] 04/04: Add debian/README.source
Jérémy Bobbio
lunar at alioth.debian.org
Tue Aug 13 21:34:43 UTC 2013
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
More information about the Pkg-ruby-extras-commits
mailing list