<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;
      <group choice='req'>
	<arg><option>--help</option></arg>
	<arg><option>--version</option></arg>
	<arg><option>--list-cmds</option></arg>
	<arg><option>command</option><arg choice='opt' rep='repeat'><option>args</option></arg></arg>
      </group>
    </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>--help</option>
        </term>
        <listitem>
          <para>Print help</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--version</option>
        </term>
        <listitem>
          <para>Print the programs version</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--list-cmds</option>
        </term>
        <listitem>
          <para>List all available commands</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>GBP COMMANDS</title>
    <para>
      These are the possible commands. For possible arguments to these commands please
      see the corresponding man pages.
    </para>
    <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.gbp.config-files;
  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <xref linkend="man.gbp.buildpackage">,
      <xref linkend="man.gbp.import.dsc">,
      <xref linkend="man.gbp.import.dscs">,
      <xref linkend="man.gbp.import.orig">,
      <xref linkend="man.gbp.dch">,
      <xref linkend="man.gbp.pq">,
      <xref linkend="man.gbp.create.remote.repo">,
      <xref linkend="man.gbp.pull">,
      <xref linkend="man.gbp.clone">,
      <citerefentry>
        <refentrytitle>git-pbuilder</refentrytitle>
        <manvolnum>1</manvolnum>
      </citerefentry>,
      <xref linkend="man.gbp.conf">,
      &man.seealso.common;
    </para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>

    <para>&dhusername; &dhemail;</para>

  </refsect1>
</refentry>
