<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>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>--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><option>--verbose</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>--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 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>
      <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>
      <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>
