document debian packaging

diff --git a/debian/README.source b/debian/README.source
index b4ae667896926b30c9cf4d5dd36e0df638e5d9f2..9e93608297209028bfd81b762613a5678fdebd7e 100644 (file)
--- a/debian/README.source
+++ b/debian/README.source
@@ -3,3 +3,18 @@ bup for Debian
 
 The bup source is obtained via git from <git://github.com/apenwarr/bup.git>
 The debian packaging tracks the latest tagged release, rather than master.
+
+The bup package source is collaboratively maintained by the Debian collab-maint project. You can obtain a copy of the source (including the upstream source)
+from <git://git.debian.org/git/collab-maint/bup>.
+
+ * The 'master' branch is used to track upstream's master
+   * you may wish to add it as a remote to any clone:
+     git remote add upstream http://github.com/apenwarr/bup.git
+   * we fast-forward merge from upstream's master
+ * The 'debian' branch is used to track the debian packaging effort
+   * This usually tracks the most recent upstream tag
+   * we non-fast-forward merge when moving between upstream tags
+ * we carry upstream's tags, which are of the form bup-x.xxx
+ * we prefix our tags with 'debian/' e.g. debian/0.14a-1
+   * experimental releases are prefixed 'debian/experimental'
+     e.g. debian/experimental/0.14a-1