Add gbp buildpackage example

showing git-pbuilder invocation

diff --git a/docs/common.ent b/docs/common.ent
index 730d4311941c7217f61f3e71678ffd1a8abafb15..58472f4083f3b9e0e8eba0c0366f2e8fa58fc592 100644 (file)
--- a/docs/common.ent
+++ b/docs/common.ent
@@ -14,8 +14,10 @@
   <!ENTITY gbp-clone           "<command>gbp clone</command>">
   <!ENTITY gbp-pq              "<command>gbp pq</command>">
   <!ENTITY gbp-create-remote-repo "<command>gbp create-remote-repo</command>">
+  <!ENTITY git-pbuilder                "<command>git pbuilder</command>">
   <!ENTITY gitcmd              "<command>git</command>">
   <!ENTITY gitkcmd             "<command>gitk</command>">
+  <!ENTITY cowbuildercmd       "<command>cowbuilder</command>">
   <!ENTITY pbuildercmd         "<command>pbuilder</command>">
   <!ENTITY pdebuildcmd         "<command>pdebuild</command>">
   <!ENTITY debuildcmd          "<command>debuild</command>">

diff --git a/docs/manpages/gbp-buildpackage.sgml b/docs/manpages/gbp-buildpackage.sgml
index a7049399fb7d0c979c4da2e912238f7b8819ea51..2ba556740fa88e942c7ea167a4e3b93462cec89f 100644 (file)
--- a/docs/manpages/gbp-buildpackage.sgml
+++ b/docs/manpages/gbp-buildpackage.sgml
@@ -450,6 +450,23 @@
       &man.gbp.config-files;
       <para>All options in the config files are specified without the 'git-' prefix.</para>
   </refsect1>
+  <refsect1>
+    <title>EXAMPLES</title>
+    <para>Build a Debian package using &git-pbuilder; which in turn invokes &cowbuildercmd;.
+      Instruct cowbuilder to build within a Wheezy chroot for i386.</para>
+    <screen>
+      &gbp-buildpackage; --git-pbuilder --git-arch=i386 --git-dist=wheezy
+    </screen>
+    <para>
+      Note that the above needs a &cowbuildercmd; chroot already. This can be created using:
+    </para>
+    <screen>
+      DIST=wheezy DIST=i386 &git-pbuilder; create
+    </screen>
+  </refsect1>
+  <refsect1>
+      &man.gbp.config-files;
+  </refsect1>
   <refsect1>
     <title>SEE ALSO</title>
     <para>
@@ -473,6 +490,10 @@
         <refentrytitle>git-pbuilder</refentrytitle>
         <manvolnum>1</manvolnum>
       </citerefentry>,
+      <citerefentry>
+        <refentrytitle>cowbuilder</refentrytitle>
+        <manvolnum>8</manvolnum>
+      </citerefentry>,
       <citerefentry>
         <refentrytitle>gbp.conf</refentrytitle>
        &dhconfsection;