diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/Makefile | 1 | ||||
| -rw-r--r-- | docs/common.ent | 1 | ||||
| -rw-r--r-- | docs/man.gbp.sgml | 11 | ||||
| -rw-r--r-- | docs/manpages/gbp.sgml | 184 | ||||
| -rw-r--r-- | docs/manpages/manpages.ent | 1 | ||||
| -rw-r--r-- | docs/manual.sgml | 1 |
6 files changed, 199 insertions, 0 deletions
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><command></option></arg> + </group> + + <arg><option><args></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; |