[DRE-commits] [ruby-org] 301/303: 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-org.

commit 020efa007b1371c11b2fcaada107f907ac4285a1
Author: Jérémy Bobbio <lunar at debian.org>
Date:   Fri Aug 9 19:14:26 2013 +0200

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

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..628f52e
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,36 @@
+Debian packaging for org-ruby
+=============================
+
+This package is named "ruby-org" and not "org-ruby" to follow the conventions
+from the Debian pkg-ruby-extras policy.
+
+Upstream source requires manual handling as:
+
+ * upstream tarballs do not contain all files in their preferred form of
+   modifications,
+ * upstream is using Git.
+
+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/fiorix/cyclone
+
+1. Fetch new commits from upstream repository:
+
+    $ git fetch upstream
+
+2. Verify the tag for the new version:
+
+    $ git tag -v version-$VERSION
+
+3. Tag and merge new upstream version:
+
+    $ git tag upstream/$VERSION version-$VERSION
+    $ git merge upstream/$VERSION
+
+4. Hack, improve, update debian/changelog…
+
+5. Build a new package:
+
+    $ git-buildpackage --git-pristine-tar --git-pristine-tar-commit

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