From 1acd0bbdfe62d0559ea907867d1e06e73e9a30bc Mon Sep 17 00:00:00 2001
From: Guido Günther <agx@sigxcpu.org>
Date: Fri, 26 Apr 2019 13:58:39 +0200
Subject: docs: import-dsc: Document --upstream-vcs-tag

---
 docs/manpages/gbp-import-dsc.xml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/docs/manpages/gbp-import-dsc.xml b/docs/manpages/gbp-import-dsc.xml
index 39a37ec2..ff0ebbdf 100644
--- a/docs/manpages/gbp-import-dsc.xml
+++ b/docs/manpages/gbp-import-dsc.xml
@@ -33,6 +33,7 @@
       <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>
@@ -137,6 +138,24 @@
           </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 upsteam 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>
-- 
cgit v1.2.3