document how to use the 'postclone' hooks

diff --git a/debian/README.source b/debian/README.source
index f4cc27bc5e5b26ed88a295b77b2bb24870f24afd..32b24a9df28ee988fa81fe808930ec19e452b876 100644 (file)
--- a/debian/README.source
+++ b/debian/README.source
@@ -9,11 +9,23 @@ As of version 1.1, the sources have been repacked:
 gbp clone
 ---------
 
-Starting with gbp>0.8.1, When cloning this repository via `gbp clone` (rather
-than `git clone`), the local repository will be automatically fine-tuned:
+Starting with gbp>0.8.1, here's an simple way to automatically fine-tune the
+repository in the following ways:
 - make git ignore any .pc/ directory (created by quilt)
 - enable the "-follow-tags" when running 'git-push', so it's harder
   to forget to push packaging tags along with the branches.
 
+To enable this, run gbp-clone with the '--postclone debian/gbp/postclone.sh'
+option.
+To enable this for ALL repositories cloned via 'gbp' (in the future), do
+something like the following:
+
+    $ mkdir -p ~/bin
+    $ cp debian/gbp/postclone.sh ~/bin/gbphook-postclone
+    $ cat >> ~/.gbp.conf <<EOF
+    [clone]
+    postclone = ~/bin/gbphook-postclone
+    EOF
+
  -- IOhannes m zmölnig (Debian/GNU) <umlaeute@debian.org>  Mon, 1 Aug 2016 12:15:50 +0200