aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGuido Guenther <agx@sigxcpu.org>2007-10-10 18:11:34 +0200
committerGuido Guenther <agx@sigxcpu.org>2007-10-10 18:11:34 +0200
commit571840e828ef098a03229435d713693a33b18902 (patch)
treec0c3f3eabd9ca0799b590f1ca739fedce9353c03 /docs
parentf7a4e0919a649527ab9b24f82eb06016fe842b85 (diff)
document --snapshot-number
Diffstat (limited to 'docs')
-rw-r--r--docs/chapters/releases.sgml12
-rw-r--r--docs/manpages/git-dch.sgml8
2 files changed, 20 insertions, 0 deletions
diff --git a/docs/chapters/releases.sgml b/docs/chapters/releases.sgml
index 58ac40f9..0ff1d4ad 100644
--- a/docs/chapters/releases.sgml
+++ b/docs/chapters/releases.sgml
@@ -59,4 +59,16 @@ git-buildpackage (0.3.7~1.gbp470ce2) UNRELEASED; urgency=low
or tag instead of <option>HEAD</option> if you want to add further changelog
entries - or you can (of course) use <option>--auto</option> again.
</para>
+<sect1 id="gbp.release.numbers">
+ <title>Special snapshot numbers</title>
+ <para>If the auto incrementing of the snapshot number doesn't suite you needs you
+ can give any python expression that evaluates to a positive integer to
+ calculate the new snapshot number:</para>
+<screen>
+git-dch -S -a --snapshot-number=1
+git-dch -S -a --snapshot-number='snapshot + 2'
+git-dch -S -a --snapshot-number='os.popen("git-log --pretty=oneline | wc -l").readlines()[0]
+git-dch -S -a --snapshot-number=`git-log --pretty=oneline debian/0.3.3 | wc -l`
+</screen>
+</sect1>
</chapter>
diff --git a/docs/manpages/git-dch.sgml b/docs/manpages/git-dch.sgml
index 9b058bb7..0208a651 100644
--- a/docs/manpages/git-dch.sgml
+++ b/docs/manpages/git-dch.sgml
@@ -28,6 +28,7 @@
<arg><option>--snapshot</option></arg>
<arg><option>--release</option></arg>
<arg><option>--auto</option></arg>
+ <arg><option>--snapshot-number=</option><replaceable>expression</replaceable></arg>
<arg><option>--git-log=</option><replaceable>git-log-options</replaceable></arg>
<arg choice="plain"><replaceable>[path1 path2]</replaceable></arg>
</cmdsynopsis>
@@ -106,6 +107,13 @@
</listitem>
</varlistentry>
<varlistentry>
+ <term><option>--snapshot-number=</option><replaceable>expression</replaceable>
+ </term>
+ <listitem>
+ <para>Python expression that gets eval()ed to the new snapshot number</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
<term><option>--release</option></term>
<listitem>
<para>Remove any snapshot release banners and version suffixes, set