diff options
Diffstat (limited to 'docs/manpages/gbp-import-orig.sgml')
-rw-r--r-- | docs/manpages/gbp-import-orig.sgml | 239 |
1 files changed, 239 insertions, 0 deletions
diff --git a/docs/manpages/gbp-import-orig.sgml b/docs/manpages/gbp-import-orig.sgml new file mode 100644 index 0000000..2a2e015 --- /dev/null +++ b/docs/manpages/gbp-import-orig.sgml @@ -0,0 +1,239 @@ +<refentry id="man.git.import.orig"> + <refentryinfo> + <address> + &dhemail; + </address> + <author> + &dhfirstname; + &dhsurname; + </author> + </refentryinfo> + <refmeta> + <refentrytitle>gbp-import-orig</refentrytitle> + &dhsection; + </refmeta> + <refnamediv> + <refname>git-import-orig</refname> + <refname>gbp-import-orig</refname> + <refpurpose>Import an upstream source into a git repository</refpurpose> + </refnamediv> + <refsynopsisdiv> + <cmdsynopsis> + &gbp-import-orig; + + <arg><option>--verbose</option></arg> + <arg><option>--upstream-version=</option><replaceable>version</replaceable></arg> + <arg><option>--[no-]merge</option></arg> + <arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> + <arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> + <arg><option>--upstream-vcs-tag=</option><replaceable>tag_name</replaceable></arg> + <arg><option>--[no-]sign-tags</option></arg> + <arg><option>--keyid=</option><replaceable>gpg-keyid</replaceable></arg> + <arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg> + <arg><option>--filter=</option><replaceable>pattern</replaceable></arg> + <arg><option>--[no-]pristine-tar</option></arg> + <arg><option>--[no-]filter-pristine-tar</option></arg> + <arg><option>--[no-]symlink-orig</option></arg> + <arg><option>--postimport=cmd</option></arg> + <arg><option>--[no-]interactive</option></arg> + <group choice="plain"> + <arg choice="plain"><replaceable>upstream-source</replaceable></arg> + <arg><option>--uscan</option></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + <refsect1> + <title>DESCRIPTION</title> + <para> + &gbp-import-orig; imports <replaceable>upstream-source</replaceable> into + the &git; repository. <replaceable>upstream-source</replaceable> can either + be a gzip, bzip2, lzma or xz compressed tar archive, a zip archive or an + already unpacked source tree. If it is already of the form + <replaceable>package-name_version.orig.tar.gz</replaceable>, the version + information is read from the tarball's filename otherwise it can be + given on the command line via <option>--upstream-version</option>. + If the source package name or version can't be determined + &gbp-import-orig; will prompt for it unless <option>--no-interactive</option> + is given.</para> + + <para>The sources are placed on the upstream branch (default: + <replaceable>upstream</replaceable>), tagged and merged onto the debian + branch (default: <replaceable>master</replaceable>). + </para> + </refsect1> + <refsect1> + <title>OPTIONS</title> + + <variablelist> + <varlistentry> + <term><option>--upstream-version</option>=<replaceable>version</replaceable></term> + <term><option>-u</option><replaceable>version</replaceable></term> + <listitem> + <para>The upstream version number</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--merge</option></term> + <listitem> + <para>Merge the upstream branch to the debian branch after import</para> + </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>--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>. After + importing the new sources on the upstream branch, &gbp-import-orig; + will try to merge the new version onto this branch.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--upstream-vcs-tag</option>=<replaceable>tag_name</replaceable> + </term> + <listitem> + <para> + Add <replaceable>tag_name</replaceable> as additional parent to the commit + of the upstream tarball. Useful when upstream uses git and you want to + link to it's revision history. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--verbose</option></term> + <term><option>-v</option></term> + <listitem> + <para>verbose execution</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--[no-]sign-tags</option> + </term> + <listitem> + <para>GPG sign all created tags</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--keyid=</option><replaceable>gpg-keyid</replaceable> + </term> + <listitem> + <para>use this keyid for gpg signing tags</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--upstream-tag=</option><replaceable>tag-format</replaceable> + </term> + <listitem> + <para>use this tag format when tagging upstream versions, + default is <replaceable>upstream/%(version)s</replaceable></para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--import-msg=</option><replaceable>msg-format</replaceable> + </term> + <listitem> + <para>use this format string for the commit message when + importing upstream versions, default is <replaceable>Imported + Upstream version %(version)s</replaceable></para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--filter=</option><replaceable>pattern</replaceable> + </term> + <listitem> + <para>filter out files glob-matching pattern. Can be given multiple times.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--[no-]pristine-tar</option> + </term> + <listitem> + <para>generate <command>pristine-tar</command> delta file</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--[no-]filter-pristine-tar</option> + </term> + <listitem> + <para>if using a filter also filter the files out of the tarball + passed to <command>pristine-tar</command></para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--[no-]symlink-orig</option></term> + <listitem> + <para> + Whether to create and keep a symlink from the upstream tarball + to a Debian policy conformant upstream tarball name located in + <filename class='directory'>../</filename>. + </para> + <para> + This is a good idea if not using <command>pristine-tar</command> + since it avoids creating a new tarball with a different md5sum. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--postimport=<replaceable>cmd</replaceable></option></term> + <listitem> + <para>run <replaceable>cmd</replaceable> after the import.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--uscan</option></term> + <listitem> + <para>Use uscan to fetch new upstream version.</para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + <refsect1> + &man.gbp.config-files; + </refsect1> + <refsect1> + <title>SEE ALSO</title> + + <para> + <citerefentry> + <refentrytitle>gbp-buildpackage</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>gbp-import-dsc</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>gbp-import-dscs</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>gbp-dch</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> + +<!-- LocalWords: xz lzma bzip gzip tarball + --> |