1 files changed, 112 insertions, 0 deletions
diff --git a/docs/manpages/gbp-import-dscs.sgml b/docs/manpages/gbp-import-dscs.sgml
new file mode 100644
index 0000000..b494e29
--- /dev/null
+++ b/docs/manpages/gbp-import-dscs.sgml
@@ -0,0 +1,112 @@
+<refentry id="man.git.import.dscs">
+  <refentryinfo>
+    <address>
+      &dhemail;
+    </address>
+    <author>
+      &dhfirstname;
+      &dhsurname;
+    </author>
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>gbp-import-dscs</refentrytitle>
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>git-import-dscs</refname>
+    <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 informations 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>
+      <citerefentry>
+        <refentrytitle>gbp-import-dsc</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>gbp.conf</refentrytitle>
+	&dhconfsection;
+      </citerefentry>,
+      &man.seealso.common;
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>&dhusername; &dhemail;</para>
+
+  </refsect1>
+</refentry>