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

<refentry id="man.gbp.import.dscs">
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
  </refentryinfo>
  <refmeta>
    <refentrytitle>gbp-import-dscs</refentrytitle>
    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>gbp-import-dscs</refname>
    <refpurpose>Import multiple versions of a Debian source packages into a Git repository</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      &gbp-import-dscs;
      <arg><option>options</option></arg>
      <arg><option>git-import-dsc options</option></arg>
      <arg choice="plain"><replaceable>pkg_1.dsc</replaceable></arg>
      <arg choice="plain"><replaceable>pkg_2.dsc</replaceable></arg>
      <arg choice="plain"><replaceable>...</replaceable></arg>
    </cmdsynopsis>

    <para>or</para>

    <cmdsynopsis>
      &gbp-import-dscs;
      <arg choice="req">--debsnap</arg>
      <arg><option>options</option></arg>
      <arg><option>git-import-dsc options</option></arg>
      <arg choice="req"><replaceable>package</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>
    <para>
    &gbp-import-dscs; imports several versions of a Debian source package into
    a &git; repository. To do so, it sorts the packages by their versions first,
    and then imports them via calling &gbp-import-dsc; on each package. 
    </para> 

    <para>
    If the current directory isn't a &git; repository already, the repository is
    created in a subdir of the current working directory, named after the first
    imported package, otherwise the &git; repository in the current working
    directory is being used. This allows for incremental imports.
    </para>
  </refsect1>
  <refsect1>
    <title>OPTIONS</title>
    <variablelist>
      <varlistentry>
        <term><option>--debsnap</option>
        </term>
        <listitem>
	  <para>Fetch snapshots from snapshots.debian.org using debsnap.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term><option>--ignore-repo-config</option>
        </term>
        <listitem>
	  <para>Ignore <filename>gbp.conf</filename> files stored in the git
repository itself. This can be useful to ignore branch information and other
options shipped in the package source.</para>
        </listitem>
      </varlistentry>
     </variablelist>
    <para>
    All other options are passed on verbatim to &gbp-import-dsc;.
    </para>
  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>

    <para>
      <xref linkend="man.gbp.import.dsc"/>,
      <xref linkend="man.gbp.buildpackage"/>,
      <xref linkend="man.gbp.import.orig"/>,
      <xref linkend="man.gbp.dch"/>,
      <xref linkend="man.gbp.conf"/>,
      &man.seealso.common;
    </para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>

    <para>&dhusername; &dhemail;</para>

  </refsect1>
</refentry>