diff options
Diffstat (limited to 'docs/manpages/gbp-import-dsc.sgml')
-rw-r--r-- | docs/manpages/gbp-import-dsc.sgml | 221 |
1 files changed, 221 insertions, 0 deletions
diff --git a/docs/manpages/gbp-import-dsc.sgml b/docs/manpages/gbp-import-dsc.sgml new file mode 100644 index 0000000..52d8d43 --- /dev/null +++ b/docs/manpages/gbp-import-dsc.sgml @@ -0,0 +1,221 @@ +<refentry id="man.git.import.dsc"> + <refentryinfo> + <address> + &dhemail; + </address> + <author> + &dhfirstname; + &dhsurname; + </author> + </refentryinfo> + <refmeta> + <refentrytitle>gbp-import-dsc</refentrytitle> + &dhsection; + </refmeta> + <refnamediv> + <refname>git-import-dsc</refname> + <refname>gbp-import-dsc</refname> + <refpurpose>Import Debian packages into a Git repository</refpurpose> + </refnamediv> + <refsynopsisdiv> + <cmdsynopsis> + &gbp-import-dsc; + + <arg><option>--verbose</option></arg> + <arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg> + <arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg> + <arg><option>--[no-]sign-tags</option></arg> + <arg><option>--keyid=</option><replaceable>gpg-keyid</replaceable></arg> + <arg><option>--debian-tag=</option><replaceable>tag-format</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>--download</option></arg> + <arg><option>--allow-same-versions</option></arg> + <arg><option>--author-is-committer</option></arg> + <arg><option>--author-date-is-committer-date</option></arg> + <arg choice="plain"><replaceable>debian-source.dsc</replaceable></arg> + </cmdsynopsis> + <cmdsynopsis> + &gbp-import-dsc; + + <arg><option>options</option></arg> + <arg choice="req"><option>--download</option></arg> + <arg><option>--[no-]allow-unauthenticated</option></arg> + <group choice="plain"> + <arg><replaceable>URL</replaceable></arg> + <arg><replaceable>source-package</replaceable></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + <refsect1> + <title>DESCRIPTION</title> + <para> + &gbp-import-dsc; imports a Debian source package into a &git; repository, + notes the package version in the commit logs, and commits the change. All + information, including package name, version, Debian diffs, and upstream + source is automatically detected from the source package. + </para> + </refsect1> + <refsect1> + <title>OPTIONS</title> + + <variablelist> + <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 sources are put + onto. Default is <replaceable>master</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>--[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>--debian-tag=</option><replaceable>tag-format</replaceable> + </term> + <listitem> + <para>use this tag format when tagging Debian versions, + default is <replaceable>debian/%(version)s</replaceable></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>--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>--pristine-tar</option> + </term> + <listitem> + <para>generate pristine-tar delta file</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--download</option> + </term> + <listitem> + <para>Download the source package instead of looking for it in the local + file system. The argument can either be a + <replaceable>source-package</replaceable> name or an + <replaceable>URL</replaceable>. The former uses &apt-get; to download + the source while the later uses &dget;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--allow-unauthenticated</option> + </term> + <listitem> + <para>Whether to skip signature verification on downloads.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--allow-same-version</option> + </term> + <listitem> + <para>Allow to import a package with the same debian version.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--author-is-committer</option> + </term> + <listitem> + <para>When importing the Debian patch, use the author identity as + comitter identity.</para> + </listitem> + </varlistentry> + <varlistentry> + <term><option>--author-date-is-committer-date</option> + </term> + <listitem> + <para>When importing the Debian patch, use the author date as + comitter date. <warning><para>Git will subtly misbehave if the + committer date of a commit is not later than or equal to all + its parents.</para></warning></para> + </listitem> + </varlistentry> + </variablelist> + </refsect1> + <refsect1> + &man.gbp.config-files; + </refsect1> + <refsect1> + <title>SEE ALSO</title> + + <para> + <citerefentry> + <refentrytitle>gbp-import-dscs</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>gbp-buildpackage</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>gbp-import-orig</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>gbp-dch</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>apt-get</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>, + <citerefentry> + <refentrytitle>dget</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> |