summaryrefslogtreecommitdiffhomepage
path: root/docs
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2016-04-15 16:37:40 +0200
committerGuido Günther <agx@sigxcpu.org>2016-07-04 17:23:02 +0200
commitf9ded2f342e8b22171cbadb3d7e55830eff21823 (patch)
tree3252c1a40083a83a0b67e640c93bdb6d5e6f09c1 /docs
parent246c1d1a40ee77f29b00636c57c9109c450f1fe6 (diff)
import_orig: add support for importing additional tarballs
We expect the additional tarballs to be located next to the orig tarball and to be already named properly. Closes: #561071
Diffstat (limited to 'docs')
-rw-r--r--docs/manpages/gbp-import-orig.sgml25
1 files changed, 24 insertions, 1 deletions
diff --git a/docs/manpages/gbp-import-orig.sgml b/docs/manpages/gbp-import-orig.sgml
index f72a7411..c0a858a9 100644
--- a/docs/manpages/gbp-import-orig.sgml
+++ b/docs/manpages/gbp-import-orig.sgml
@@ -30,7 +30,8 @@
<arg><option>--[no-]sign-tags</option></arg>
<arg><option>--keyid=</option><replaceable>gpg-keyid</replaceable></arg>
<arg><option>--upstream-tag=</option><replaceable>tag-format</replaceable></arg>
- <arg><option>--filter=</option><replaceable>pattern</replaceable></arg>
+ <arg rep='repeat'><option>--filter=</option><replaceable>pattern</replaceable></arg>
+ <arg rep='repeat'><option>--component=</option><replaceable>component</replaceable></arg>
<arg><option>--[no-]pristine-tar</option></arg>
<arg><option>--[no-]filter-pristine-tar</option></arg>
<arg><option>--[no-]symlink-orig</option></arg>
@@ -193,6 +194,28 @@
</listitem>
</varlistentry>
<varlistentry>
+ <term><option>--component=</option><replaceable>COMPONENT</replaceable>
+ </term>
+ <listitem>
+ <para>
+ When importing the upstream tarball also look for an additional tarball
+ with component name <replaceable>COMPONENT</replaceable>. E.g. in
+ <filename>hello-debhelper_1.0.orig-foo.tar.gz</filename>
+ the component would be <replaceable>foo</replaceable>. The additional
+ tarball is expected to be in the same directory than the upstream tarball
+ and to use the same compression type.
+ </para>
+ <para>
+ Using additional original tarballs is a feature of the 3.0
+ (quilt) source format. See
+ the <command>dpkg-source</command> manpage for
+ details. Note that this option can't be set via &gbp.conf;
+ since it's considered an experimental feature and might
+ change incompatibly.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
<term><option>--[no-]pristine-tar</option>
</term>
<listitem>