debian_git-buildpackage/docs/manpages/gbp-import-dsc.sgml

<refentry id="man.gbp.import.dsc">
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
  </refentryinfo>
  <refmeta>
    <refentrytitle>gbp-import-dsc</refentrytitle>
    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>gbp-import-dsc</refname>
    <refpurpose>Import &debian; packages into a &git; repository</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      &gbp-import-dsc;
      &man.common.options.synopsis;
      <arg><option>--allow-same-versions</option></arg>
      <arg><option>--author-date-is-committer-date</option></arg>
      <arg><option>--author-is-committer</option></arg>
      <arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg>
      <arg><option>--debian-tag=</option><replaceable>tag-format</replaceable></arg>
      <arg><option>--download</option></arg>
      <arg><option>--filter=</option><replaceable>pattern</replaceable></arg>
      <arg><option>--keyid=</option><replaceable>gpg-keyid</replaceable></arg>
      <arg><option>--[no-]create-missing-branches</option></arg>
      <arg><option>--[no-]pristine-tar</option></arg>
      <arg><option>--[no-]sign-tags</option></arg>
      <arg><option>--skip-debian-tag=</option></arg>
      <arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg>
      <arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></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>
    <para>
    If the command is run from within an existing repository, it will import
    into this; if not, a new repository named as the Debian source package is
    created.
    </para>
  </refsect1>
  <refsect1>
    <title>OPTIONS</title>
    <variablelist>
      &man.common.options.description;

      <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>--[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>--skip-debian-tag</option>
        </term>
        <listitem>
          <para>
          Don't create &debian; tag after importing the &debian; patch. This can be
          useful if you already created a package but want to further work on
          it after importing it into git.
          </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 a
          <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 one 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
          committer 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
          committer 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>
      <varlistentry>
        <term><option>--[no-]create-missing-branches</option>
        </term>
        <listitem>
          <para>
          Create missing upstream and debian branch if missing.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    &man.gbp.config-files;
  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>

    <para>
      <xref linkend="man.gbp.import.dscs"/>,
      <xref linkend="man.gbp.buildpackage"/>,
      <xref linkend="man.gbp.import.orig"/>,
      <xref linkend="man.gbp.dch"/>,
      <citerefentry>
        <refentrytitle>apt-get</refentrytitle>
        <manvolnum>1</manvolnum>
      </citerefentry>,
      <citerefentry>
        <refentrytitle>dget</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>