add git-import-dscs

to import mutiple dscs in one go
Closes: #471580

5 files changed, 93 insertions, 0 deletions

diff --git a/docs/common.ent b/docs/common.ent
index 28cd7d39..98974da2 100644
--- a/docs/common.ent
+++ b/docs/common.ent
@@ -6,6 +6,7 @@
   <!ENTITY git-buildpackage 	"<command>git-buildpackage</command>">
   <!ENTITY git-import-orig	"<command>git-import-orig</command>">
   <!ENTITY git-import-dsc	"<command>git-import-dsc</command>">
+  <!ENTITY git-import-dscs	"<command>git-import-dscs</command>">
   <!ENTITY git-dch		"<command>git-dch</command>">
   <!ENTITY gitcmd		"<command>git</command>">
   <!ENTITY gitkcmd		"<command>gitk</command>">
diff --git a/docs/man.git-import-dscs.sgml b/docs/man.git-import-dscs.sgml
new file mode 100644
index 00000000..3777e895
--- /dev/null
+++ b/docs/man.git-import-dscs.sgml
@@ -0,0 +1,11 @@
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+  <!ENTITY % COMMON SYSTEM "common.ent">
+  %COMMON;
+  <!ENTITY % MANPAGES SYSTEM "manpages/manpages.ent">
+  %MANPAGES;
+]>
+
+<reference>
+<title>git-buildpackage Manual</title>
+&man.git.importdscs;
+</reference>
diff --git a/docs/manpages/git-import-dscs.sgml b/docs/manpages/git-import-dscs.sgml
new file mode 100644
index 00000000..c9ea7d8a
--- /dev/null
+++ b/docs/manpages/git-import-dscs.sgml
@@ -0,0 +1,79 @@
+<refentry id="gbp.man.git.import.dscs">
+  <refentryinfo>
+    <address>
+      &dhemail;
+    </address>
+    <author>
+      &dhfirstname;
+      &dhsurname;
+    </author>
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>git-import-dscs</refentrytitle>
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>&git-import-dscs;</refname>
+
+    <refpurpose>Import multiple versions of a Debian source packages into a Git repository</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      &git-import-dscs;
+      <arg><option>git-import-dsc ptions</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>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+    <para>
+    &git-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 &git-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>
+    <para>
+    All options are passed on verbatim to &git-import-dsc;.
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>
+      <citerefentry>
+        <refentrytitle>git-import-dsc</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-buildpackage</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-import-orig</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      <citerefentry>
+        <refentrytitle>git-dch</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>,
+      &man.seealso.common;
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>&dhusername; &dhemail;</para>
+
+  </refsect1>
+</refentry>
diff --git a/docs/manpages/manpages.ent b/docs/manpages/manpages.ent
index 6f22e564..21c5bf0d 100644
--- a/docs/manpages/manpages.ent
+++ b/docs/manpages/manpages.ent
@@ -1,5 +1,6 @@
 <!ENTITY man.git.importorig SYSTEM "git-import-orig.sgml">
 <!ENTITY man.git.importdsc SYSTEM "git-import-dsc.sgml">
+<!ENTITY man.git.importdscs SYSTEM "git-import-dscs.sgml">
 <!ENTITY man.git.buildpackage SYSTEM "git-buildpackage.sgml">
 <!ENTITY man.git.dch SYSTEM "git-dch.sgml">
 <!ENTITY man.git.config-files SYSTEM "man.conffiles.sgml">
diff --git a/docs/manual.sgml b/docs/manual.sgml
index e72ebec5..eb977536 100644
--- a/docs/manual.sgml
+++ b/docs/manual.sgml
@@ -29,6 +29,7 @@
     <title>Command Reference</title>
     &man.git.buildpackage;
     &man.git.importdsc;
+    &man.git.importdscs;
     &man.git.importorig;
     &man.git.dch;
   </appendix>