[med-svn] [htslib] 01/01: Add README.source to explain the workflow of this Git repository

[Andreas Tille]

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

tille pushed a commit to branch debian/unstable
in repository htslib.

commit d4dbf8d886899adb6d13d80b2073da94801947a7
Author: Andreas Tille <tille at debian.org>
Date:   Tue Jul 28 12:06:57 2015 +0200

    Add README.source to explain the workflow of this Git repository
---
 debian/README.source | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..95e020a
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,34 @@
+Since this Git repository does not follow the usual Debian Med
+workflow it is documented here, how the package can be updated:
+
+  1. in the master branch, pull the upstream master branch and its tags.
+
+       checkout master
+       git pull https://github.com/samtools/htslib --tags
+
+     Remark: If this pull fails with a lot of stuff to merge you might
+     have some ~/.gitconfig that breaks the pull above.  Please try to
+     deactivate it for the moment.
+
+  2. download the upstream tarball
+
+       uscan --force-download
+
+  3. Register the upstream tarball in the pristine-tar branch directly with
+     the pristine-tar command directly (stay in master branch when doing this)
+
+       pristine-tar commit ../htslib_<version>.orig.tar.gz v<version>
+
+  4. Merge the tag in the debian/unstable branch
+
+       git checkout debian/unstable ; git merge v<version>
+
+  5. Update the packaging files, build with gbp - debian-branch and
+     upstream-branch are properly set in debian/gbp.conf
+
+According to Charles Plessy this workflow has the advantage to propose
+upstream via pull requests on GitHub.  The Debian Med policy currently
+does only contain a short paragraph to mention the derived workflow:
+
+    http://debian-med.alioth.debian.org/docs/policy.html#git-without-tarball
+

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-med/htslib.git