summaryrefslogtreecommitdiff
path: root/docs/manpages/git-dch.sgml
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2013-06-26 13:09:51 +0200
committerGuido Günther <agx@sigxcpu.org>2013-06-26 13:31:27 +0200
commit1d90e73e969cebc1aaa6a151dd03da0b271fbb4d (patch)
tree9d0908fc6d625c81f14d89126ba733b952016dfa /docs/manpages/git-dch.sgml
parentdaccfa00121dcedf0b20d846f2263f3e30b457c6 (diff)
docs: Rename the entities from &git-<command>; to &gbp-<command>;
Diffstat (limited to 'docs/manpages/git-dch.sgml')
-rw-r--r--docs/manpages/git-dch.sgml18
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/manpages/git-dch.sgml b/docs/manpages/git-dch.sgml
index d1256a6..7e550f3 100644
--- a/docs/manpages/git-dch.sgml
+++ b/docs/manpages/git-dch.sgml
@@ -19,7 +19,7 @@
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
- &git-dch;
+ &gbp-dch;
<arg><option>--verbose</option></arg>
<arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg>
@@ -63,20 +63,20 @@
<refsect1>
<title>DESCRIPTION</title>
<para>
- &git-dch; reads git commit messages and generates the Debian changelog from
- it. If no arguments are given &git-dch; starts from the last tagged Debian
+ &gbp-dch; reads git commit messages and generates the Debian changelog from
+ it. If no arguments are given &gbp-dch; starts from the last tagged Debian
package version up to the current tip of the current branch. If the
distribution of the topmost section in
<filename>debian/changelog</filename> is <emphasis>UNRELEASED</emphasis>
the changelog entries will be inserted into this section. Otherwise a new
section will be created.</para>
- <para>If <option>--auto</option> is given &git-dch; tries to guess the
+ <para>If <option>--auto</option> is given &gbp-dch; tries to guess the
last &git; commit documented in the changelog - this only works in snapshot
- mode. Otherwise <option>--since</option> can be used to tell &git-dch;
+ mode. Otherwise <option>--since</option> can be used to tell &gbp-dch;
at which point it should start in the &git; history.</para>
<para>
The additional path arguments can be used to restrict the repository paths
- &git-dch; looks at. Setting <replaceable>path</replaceable> to
+ &gbp-dch; looks at. Setting <replaceable>path</replaceable> to
<emphasis>debian/</emphasis> is a good choice if upstream uses &git; and
all Debian packaging changes are restricted to the
<replaceable>debian/</replaceable> subdir. In more sophisticated cases
@@ -321,14 +321,14 @@
Snapshot mode can be used for quick test and install cycles without
having to worry about version numbers or changelog entries.
</para><para>
- When using <option>--snapshot</option> or <option>-S</option> &git-dch;
+ When using <option>--snapshot</option> or <option>-S</option> &gbp-dch;
uses a pseudo header in the Debian changelog to remember the last git
commit it added a changelog entry for. It also sets a version number
ending in
<replaceable>~&lt;snaspshotnumber&gt;.gbp&lt;commitid&gt;</replaceable>.
It automatically increments the snapshot number on subsequent invocations
- of &git-dch; <option>-S</option> so that later snapshots automatically
- have a higher version number. To leave snapshot mode invoke &git-dch;
+ of &gbp-dch; <option>-S</option> so that later snapshots automatically
+ have a higher version number. To leave snapshot mode invoke &gbp-dch;
with the <option>--release</option> option. This removes the pseudo
header and unmangles the version number so the released version has a
higher version number than the snapshots.