From 5684b187f227de34e36349d99ff3a037dc4520f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Guido=20G=C3=BCnther?= <agx@sigxcpu.org>
Date: Wed, 26 Jun 2013 11:56:38 +0200
Subject: Add gbp manpage

---
 docs/Makefile              |   1 +
 docs/common.ent            |   1 +
 docs/man.gbp.sgml          |  11 +++
 docs/manpages/gbp.sgml     | 184 +++++++++++++++++++++++++++++++++++++++++++++
 docs/manpages/manpages.ent |   1 +
 docs/manual.sgml           |   1 +
 6 files changed, 199 insertions(+)
 create mode 100644 docs/man.gbp.sgml
 create mode 100644 docs/manpages/gbp.sgml

(limited to 'docs')

diff --git a/docs/Makefile b/docs/Makefile
index 36790188..3540e676 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -5,6 +5,7 @@ MAN1S = git-buildpackage  \
         git-import-dscs   \
         git-import-orig   \
         git-dch           \
+        gbp               \
         gbp-pull          \
         gbp-clone         \
         gbp-pq            \
diff --git a/docs/common.ent b/docs/common.ent
index 2ac025be..43d82104 100644
--- a/docs/common.ent
+++ b/docs/common.ent
@@ -9,6 +9,7 @@
   <!ENTITY git-import-dsc	"<command>git-import-dsc</command>">
   <!ENTITY git-import-dscs	"<command>git-import-dscs</command>">
   <!ENTITY git-dch		"<command>git-dch</command>">
+  <!ENTITY gbp		        "<command>gbp</command>">
   <!ENTITY gbp-pull		"<command>gbp-pull</command>">
   <!ENTITY gbp-clone		"<command>gbp-clone</command>">
   <!ENTITY gbp-pq		"<command>gbp-pq</command>">
diff --git a/docs/man.gbp.sgml b/docs/man.gbp.sgml
new file mode 100644
index 00000000..829184a0
--- /dev/null
+++ b/docs/man.gbp.sgml
@@ -0,0 +1,11 @@
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+  <!ENTITY % COMMON SYSTEM "common.ent">
+  %COMMON;
+  <!ENTITY % MANPAGES SYSTEM "manpages/manpages.ent">
+  %MANPAGES;
+]>
+
+<reference>
+<title>git-buildpackage Manual</title>
+&man.gbp;
+</reference>
diff --git a/docs/manpages/gbp.sgml b/docs/manpages/gbp.sgml
new file mode 100644
index 00000000..d8f0716d
--- /dev/null
+++ b/docs/manpages/gbp.sgml
@@ -0,0 +1,184 @@
+<refentry id="man.gbp">
+  <refentryinfo>
+    <address>
+      &dhemail;
+    </address>
+    <author>
+      &dhfirstname;
+      &dhsurname;
+    </author>
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>gbp</refentrytitle>
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>&gbp;</refname>
+    <refpurpose>Maintain Debian packages in Git</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      &gbp;
+      <arg><option>--verbose</option></arg>
+      <group choice="plain">
+	<arg><option>&lt;command&gt;</option></arg>
+      </group>
+
+      <arg><option>&lt;args&gt;</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+    <para>
+    &gbp; is used to maintain Debian source packages in the &git; version control system.
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>OPTIONS</title>
+    <variablelist>
+      <varlistentry>
+        <term><option>--verbose</option>
+        </term>
+        <listitem>
+          <para>verbose execution</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+    <title>GBP COMMANDS</title>
+    <variablelist>
+      <varlistentry>
+        <term>buildpackage
+        </term>
+        <listitem>
+          <para>Build source and binary packages from a &git; repository</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>import-orig
+        </term>
+        <listitem>
+          <para>Import a new upstream version into a &git; repository</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>import-dsc
+        </term>
+        <listitem>
+          <para>Import a Debian source package into a &git; repository</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>import-dscs
+        </term>
+        <listitem>
+          <para>Import several Debian source packages into a &git; repository, sorted
+	  by version number</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>dch
+        </term>
+        <listitem>
+          <para>Generate the <filename>debian/changelog</filename> from  &git; commit history</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>pq
+        </term>
+        <listitem>
+          <para>Manage <filename>debian/patches</filename> using &git; <option>rebase</option></para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>pull
+        </term>
+        <listitem>
+          <para>Update a &git; repository from a remote</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>clone
+        </term>
+        <listitem>
+          <para>Clone a &git; repository from a remote and set up the necessary branch tracking.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <variablelist>
+      <varlistentry>
+        <term>create-remote-repo
+        </term>
+        <listitem>
+          <para>Create a remote &git; repository</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+      &man.git.config-files;
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+    <para>
+      <citerefentry>
+        <refentrytitle>git-import-dsc</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-import-dscs</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-import-orig</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-dch</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-pbuilder</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-create-remote-repo</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-pull</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-clone</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>gbp.conf</refentrytitle>
+	&dhconfsection;
+      </citerefentry>
+      &man.seealso.common;
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>&dhusername; &dhemail;</para>
+
+  </refsect1>
+</refentry>
diff --git a/docs/manpages/manpages.ent b/docs/manpages/manpages.ent
index 058b66d4..f305b303 100644
--- a/docs/manpages/manpages.ent
+++ b/docs/manpages/manpages.ent
@@ -3,6 +3,7 @@
 <!ENTITY man.git.importdscs SYSTEM "git-import-dscs.sgml">
 <!ENTITY man.git.buildpackage SYSTEM "git-buildpackage.sgml">
 <!ENTITY man.git.dch SYSTEM "git-dch.sgml">
+<!ENTITY man.gbp SYSTEM "gbp.sgml">
 <!ENTITY man.gbp.pull SYSTEM "gbp-pull.sgml">
 <!ENTITY man.gbp.clone SYSTEM "gbp-clone.sgml">
 <!ENTITY man.gbp.pq SYSTEM "gbp-pq.sgml">
diff --git a/docs/manual.sgml b/docs/manual.sgml
index eab37452..5db1a15b 100644
--- a/docs/manual.sgml
+++ b/docs/manual.sgml
@@ -27,6 +27,7 @@
 
   <appendix id="man.reference">
     <title>Command Reference</title>
+    &man.gbp;
     &man.git.buildpackage;
     &man.git.importdsc;
     &man.git.importdscs;
-- 
cgit v1.2.3