gbp-create-remote-repo: add --remote-config

This specifies an additional config file section that can be used
to preconfigure different remote locations.

2 files changed, 42 insertions, 0 deletions

diff --git a/docs/manpages/gbp-create-remote-repo.sgml b/docs/manpages/gbp-create-remote-repo.sgml
index e680f9e..93cf926 100644
--- a/docs/manpages/gbp-create-remote-repo.sgml
+++ b/docs/manpages/gbp-create-remote-repo.sgml
@@ -25,6 +25,7 @@
       <arg><option>--remote-url-pattern=</option><replaceable>url-pattern</replaceable></arg>
       <arg><option>--remote-name=</option><replaceable>name</replaceable></arg>
       <arg><option>--template-dir=</option><replaceable>directory</replaceable></arg>
+      <arg><option>--remote-config=</option><replaceable>config</replaceable></arg>
       <arg><option>--[no-]pristine-tar</option></arg>
       <arg><option>--debian-branch=</option><replaceable>branch_name</replaceable></arg>
       <arg><option>--upstream-branch=</option><replaceable>branch_name</replaceable></arg>
@@ -78,6 +79,16 @@
         </listitem>
       </varlistentry>
       <varlistentry>
+        <term><option>--remote-config</option>=<replaceable>config</replaceable>
+        </term>
+        <listitem>
+	  <para>Name of a config file section in <filename>gbp.conf</filename>
+          that specifies the above paramters. See <xref linkend="gbp.man.gbp.conf">
+          manpage for details.
+	  </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
         <term><option>--debian-branch</option>=<replaceable>branch_name</replaceable>
         </term>
         <listitem>
diff --git a/docs/manpages/gbp.conf.sgml b/docs/manpages/gbp.conf.sgml
index e0330d7..09999be 100644
--- a/docs/manpages/gbp.conf.sgml
+++ b/docs/manpages/gbp.conf.sgml
@@ -58,6 +58,11 @@
     [&lt;command&gt;]
     # Specific sections for each command, like &git-buildpackage;
     key = value
+
+    [remote-config &lt;name&gt;]
+    # Specific sections for a remote configuration. This can be used several
+    # times to set up remote configuration for gbp-create-remote-repo
+    key = value
 </programlisting>
 
 <para>
@@ -125,6 +130,32 @@ can't be configured via gbp.conf.
 </para>
 </note>
 
+<para>
+<xref linkend="gbp.man.gbp.create.remote.repo"> can additionally parse remote site
+configurations from <filename>gbp.conf</filename>. For example a configration like:
+</para>
+
+<programlisting>
+[remote-config pkg-libvirt]
+# Location of the repository
+remote-url-pattern = ssh://git.debian.org/git/pkg-libvirt/%(pkg)s
+# Template dir to passed to git-init
+template-dir = /srv/alioth.debian.org/chroot/home/groups/pkg-libvirt/git-template
+</programlisting>
+
+<para>
+Can be used to create remote repositories for the pkg-libvirt project using:
+</para>
+
+<programlisting>
+gbp-create-remote-repo --remote-config=pkg-libvirt
+</programlisting>
+
+<para>
+This can be useful if you're often creating new remote repositores for
+different projects.
+</para>
+
   </refsect1>
   <refsect1>
     <title>EXAMPLES</title>