aboutsummaryrefslogtreecommitdiff
path: root/docs/manpages/gbp-pull.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/manpages/gbp-pull.sgml')
-rw-r--r--docs/manpages/gbp-pull.sgml114
1 files changed, 114 insertions, 0 deletions
diff --git a/docs/manpages/gbp-pull.sgml b/docs/manpages/gbp-pull.sgml
new file mode 100644
index 0000000..de5ac8c
--- /dev/null
+++ b/docs/manpages/gbp-pull.sgml
@@ -0,0 +1,114 @@
+<refentry id="gbp.man.gbp.pull">
+ <refentryinfo>
+ <address>
+ &dhemail;
+ </address>
+ <author>
+ &dhfirstname;
+ &dhsurname;
+ </author>
+ </refentryinfo>
+ <refmeta>
+ <refentrytitle>gbp-pull</refentrytitle>
+ &dhsection;
+ </refmeta>
+ <refnamediv>
+ <refname>&gbp-pull;</refname>
+
+ <refpurpose>Safely update a repository from remote</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ &gbp-pull;
+
+ <arg><option>--verbose</option></arg>
+ <arg><option>--redo-pq</option></arg>
+ <arg><option>--force</option></arg>
+ <arg><option>--[no-]pristine-tar</option></arg>
+ <arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg>
+ <arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>DESCRIPTION</title>
+ <para>
+ &gbp-pull; updates the <emphasis>debian</emphasis>,
+ <emphasis>upstream</emphasis> and <emphasis>pristine-tar</emphasis>
+ branches from a remote repository in one go. It checks if the update is safe (would
+ result in a <emphasis>fast-forward</emphasis> merge) and aborts otherwise.
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>OPTIONS</title>
+
+ <variablelist>
+ <varlistentry>
+ <term><option>--force</option></term>
+ <listitem>
+ <para>force update even if this results in a non fast forward update</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--redo-pq</option></term>
+ <listitem>
+ <para>also rebuild the corresponding patch-queue using &gbp-pq;</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--debian-branch</option>=<replaceable>branch_name</replaceable>
+ </term>
+ <listitem>
+ <para>The branch in the Git repository the Debian package is being
+ developed on, default is <replaceable>master</replaceable>.
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--upstream-branch</option>=<replaceable>branch_name</replaceable>
+ </term>
+ <listitem>
+ <para>The branch in the &git; repository the upstream sources are put
+ onto. Default is <replaceable>upstream</replaceable>.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--verbose</option></term>
+ <term><option>-v</option></term>
+ <listitem>
+ <para>verbose execution</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--pristine-tar</option>
+ </term>
+ <listitem>
+ <para>generate pristine-tar delta file</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <refsect1>
+ &man.git.config-files;
+ </refsect1>
+ <refsect1>
+ <title>SEE ALSO</title>
+ <para>
+ <citerefentry>
+ <refentrytitle>git-buildpackage</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>gbp-clone</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ <citerefentry>
+ <refentrytitle>gbp-pq</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ </para>
+ </refsect1>
+ <refsect1>
+ <title>AUTHOR</title>
+
+ <para>&dhusername; &dhemail;</para>
+
+ </refsect1>
+</refentry>