[SCM] pd-pduino/master: Document how to properly 'gbp clone' the packaging repo.

[umlaeute at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit d299b88980baeea756a92224a9a1b7ae521184a8
Author: IOhannes m zmölnig <zmoelnig at umlautQ.umlaeute.mur.at>
Date:   Mon Jun 19 15:46:58 2017 +0200

    Document how to properly 'gbp clone' the packaging repo.

diff --git a/debian/README.source b/debian/README.source
index 024a331..502eec8 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -1,18 +1,29 @@
+gbp clone
+---------
 
-git-tuneclone.sh
-----------------
-
-This package comes with a script 'debian/git-tuneclone.sh'.
-Running it after a fresh clone of the packaging repository
-will fine-tune your local copy, namely:
+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
+- enable the "--follow-tags" when running 'git-push', so it's harder
   to forget to push packaging tags along with the branches.
-- do an initial checkout of the 3 packaging branches (master, pristine-tar,
-  upstream)
-The script only needs to run once (though running it multiple times shouldn't
-matter).
-You are of course free to *not* run the script, if you prefer.
 
- -- IOhannes m zmölnig (Debian/GNU) <umlaeute at debian.org>  Tue, 11 Nov 2015 11:11:03 +0100
+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
+    $ cat >> ~/bin/gbphook-postclone <<EOF
+    #!/bin/sh
+    git config push.followTags true && echo "enabled push.followTags"
+    GITEXCLUDE=".git/info/exclude"
+    egrep "^/?\.pc/?$" "${GITEXCLUDE}" >/dev/null 2>&1 \
+      || (echo "/.pc/" >> "${GITEXCLUDE}" && echo "ignoring /.pc/")
+    EOF
+
+    $ cat >> ~/.gbp.conf <<EOF
+    [clone]
+    postclone = ~/bin/gbphook-postclone
+    EOF
 
+ -- IOhannes m zmölnig (Debian/GNU) <umlaeute at debian.org>  Mon, 19 Jun 2017 12:15:50 +0200

-- 
pd-pduino packaging