<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 rep='repeat'><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><option>--upstream-vcs-tag=</option><replaceable>tag-format</replaceable></arg>
      <arg><option>--repo-user=</option><option>[GIT|DEBIAN]</option></arg>
      <arg><option>--repo-email=</option><option>[GIT|DEBIAN]</option></arg>
      <arg choice="plain"><replaceable>debian-source.dsc</replaceable></arg>
      <arg choice="opt"><replaceable>target</replaceable></arg>
    </cmdsynopsis>
    <cmdsynopsis>
      &gbp-import-dsc;
      <arg><option>options</option></arg>
      <arg><option>--[no-]allow-unauthenticated</option></arg>
      <group choice="plain">
        <arg><replaceable>URL</replaceable></arg>
      </group>
      <arg choice="opt"><replaceable>target</replaceable></arg>
    </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; modifications and upstream
      source, is automatically detected from the source package. After
      import the repository can be used with the other &gbp; tools.
    </para>
    <para>
    If the command is run from within an existing &git; repository, it will import
    into it; if not, a new repository named as the Debian source package is
    created. You can override the location of the new repository by specifying
    the optional <replaceable>target</replaceable> argument.
    </para>
    <para>
      When given a <replaceable>URL</replaceable> &gbp-import-dsc;
      will download the source package prior to importing it. &dget;
      is used for all schemes except for the special
      scheme <replaceable>apt:///</replaceable> which uses &apt-get;
      (and therefore needs <replaceable>deb-src</replaceable>
      entries in your <filename>/etc/apt/sources.list</filename>).
      The later can be abbreviated by using the pseudo URL
      <replaceable>apt:</replaceable>.
    </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>--upstream-vcs-tag</option>=<replaceable>tag-format</replaceable>
        </term>
        <listitem>
          <para>
          Add <replaceable>tag-format</replaceable> as additional parent to the
          commit of the upstream tarball. Useful when upstream uses git and you
          want to link to its revision history. The
          <replaceable>tag-format</replaceable> can be a pattern similar to
          what <option>--upstream-tag</option> supports.
          </para>
	  <para>
	    The default is to not add upstream tags as additional
	    parents since this requires additional setup to have the upstream
	    sources in the same repository.
	  </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
          <option><replaceable>pattern</replaceable></option> from
          upstream tarballs and the debian tarball of 3.0(quilt)
          packages. Note that the <emphasis>.diff.gz</emphasis> of 1.0
          source format packages is currently not filtered.
	  </para>
	  <para>
	  This option 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>--allow-unauthenticated</option>
        </term>
        <listitem>
          <para>
            Whether to skip signature verification on
            downloads. Passed on verbatim to &dget; and &apt-get;
            respectively. Use with care.
          </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 upstream and debian branch if missing.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
	<term><option>--repo-user=</option><option>[GIT|DEBIAN]</option></term>
        <listitem>
          <para>
	    When set to <option>DEBIAN</option>
	    use the <envar>DEBFULLNAME</envar> environment variable to set the
	    user.name &git; configuration otherwise use &git;'s
	    defaults. Only affects newly created repos.
          </para>
        </listitem>
      </varlistentry>
      <varlistentry>
	<term><option>--repo-email=</option><option>[GIT|DEBIAN]</option></term>
        <listitem>
          <para>
	    When set to <option>DEBIAN</option>
	    use the <envar>DEBEMAIL</envar> environment variable to set the
	    user.email &git; configuration otherwise use &git;'s
	    defaults. Only affects newly created repos.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    &man.gbp.config-files;
  </refsect1>
  <refsect1>
    <title>EXAMPLES</title>
    <para>
      Download and import a source package from a URL:
    </para>
    <screen>
      &gbp-import-dsc; http://http.debian.net/debian/pool/main/h/hello/hello_2.10-1.dsc
    </screen>
    <para>
      Download and import a source package via <command>apt-get
      source</command> from unstable:
    </para>
    <screen>
      &gbp-import-dsc; apt:hello/sid
    </screen>
    <para>
      Import a source package in the local file system:
    </para>
    <screen>
      &gbp-import-dsc; ../hello_2.10-1.dsc
    </screen>
  </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>sources.list</refentrytitle>
        <manvolnum>5</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>
