fetching upstream sources
-------------------------
Upstream of 'mrpeach' doesn't do any proper releases.
Fortunately the library is pretty stable, and only receives the occasional
bugfix and new feature via the SVN repository.
The Debian packaging therefore uses SVN snapshots.

The debian/watch file checks the SVN repository for new revisions.

Because we cannot directly download an archive of a specific revision of an SVN
subdirectory from SourceForge, we cannot use uscan's download feature.
Instead the most recent snapshot can be downloaded with the
"debian/get-orig-source.sh" script (without any argument it will fetch the
latest <revision>, check whether the <version> in the included mrpeach-meta.pd
file and calculate the upstream version as "<version>~svn<revision>".

On success, the debian/get-orig-source.sh script will instruct you how to
proceed for importing the sources into git-buildpackage and updating the
upstream ChangeLog.

 -- IOhannes m zmölnig (Debian/GNU) <umlaeute@debian.org>  Tue, 6 Mar 2018 17:06:03 +0100


gbp clone
---------

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 for ALL repositories cloned via 'gbp' (in the future), do
something like the following:

~~~
$ mkdir -p ~/bin
$ cat >> ~/bin/gbphook-postclone <<EOF
#!/bin/sh
## script to initialize a cloned repository

# - enable the "--follow-tags" mode for pushing
echo "tuning git-repository for ${NAME}"
git config push.followTags true && echo "enabled push.followTags"

# - ignore quilt's .pc/ directory
GITEXCLUDE=".git/info/exclude"
egrep "^/?\.pc/?$" "${GITEXCLUDE}" >/dev/null 2>&1 \
  || (echo "/.pc/" >> "${GITEXCLUDE}" && echo "ignoring /.pc/")
EOF

$ chmod u+x ~/bin/gbphook-postclone
$ cat >> ~/.gbp.conf <<EOF
[clone]
postclone = ~/bin/gbphook-postclone
EOF

$ gbp clone ...
~~~

 -- IOhannes m zmölnig (Debian/GNU) <umlaeute@debian.org>  Mon, 1 Aug 2016 12:15:50 +0200
