summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2013-07-04 10:38:30 +0200
committerGuido Günther <agx@sigxcpu.org>2013-07-04 10:38:30 +0200
commitcef5baedcf90d2732730b8114383ab610790e9c0 (patch)
tree25e2f67ae169c2c86e60a22bf1edb9e08bb92656
parent2a233a7e6ca6002c082675059743f187460b4cee (diff)
Add gbp buildpackage example
showing git-pbuilder invocation
-rw-r--r--docs/common.ent2
-rw-r--r--docs/manpages/gbp-buildpackage.sgml21
2 files changed, 23 insertions, 0 deletions
diff --git a/docs/common.ent b/docs/common.ent
index 730d4311..58472f40 100644
--- 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 a7049399..2ba55674 100644
--- a/docs/manpages/gbp-buildpackage.sgml
+++ b/docs/manpages/gbp-buildpackage.sgml
@@ -451,6 +451,23 @@
<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>
<citerefentry>
@@ -474,6 +491,10 @@
<manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
+ <refentrytitle>cowbuilder</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>,
+ <citerefentry>
<refentrytitle>gbp.conf</refentrytitle>
&dhconfsection;
</citerefentry>