From a25497d846b9a79555a58cb2acb3fdd77907ef46 Mon Sep 17 00:00:00 2001 From: Junichi Uekawa Date: Sat, 20 Jan 2007 13:37:27 +0900 Subject: add EXAMPLES section to documentation --- ChangeLog | 8 ++++++++ debian/changelog | 3 ++- debuild-pbuilder.1 | 18 ++++++++++++++++++ pbuilder.8 | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ pdebuild.1 | 34 ++++++++++++++++++++++++++++++++++ 5 files changed, 111 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 885d8ba..06e3f9a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2007-01-20 Junichi Uekawa + + * pbuilder.8: add EXAMPLES section + + * pdebuild.1: add EXAMPLES section + + * debuild-pbuilder.1: add EXAMPLES section. + 2007-01-13 Junichi Uekawa * git-tag.sh: diff --git a/debian/changelog b/debian/changelog index 368be2c..7a3e369 100644 --- a/debian/changelog +++ b/debian/changelog @@ -4,8 +4,9 @@ pbuilder (0.163) UNRELEASED; urgency=low * --override-config and --mirror without --distribution leaves /proc mounted, and breaks cowbuilder. (closes: #405497) * pbuilder repository moved over to git! + * add EXAMPLES section in documentation. - -- Junichi Uekawa Sat, 13 Jan 2007 23:13:30 +0900 + -- Junichi Uekawa Sat, 20 Jan 2007 13:36:14 +0900 pbuilder (0.162) unstable; urgency=low diff --git a/debuild-pbuilder.1 b/debuild-pbuilder.1 index 4d03aaa..e464b32 100644 --- a/debuild-pbuilder.1 +++ b/debuild-pbuilder.1 @@ -12,6 +12,24 @@ does Build-Dependency satisfaction. See debuild manpage for details. +.SH "EXAMPLES" + +.TP +.B "debuild-pbuilder" +Satisfy build-dependency and run debuild. + +.nf +$ debuild-pbuilder +W: /home/dancer/.pbuilderrc does not exist + -> Attempting to parse the build-deps : pbuilder-satisfydepends,v 1.29 2006/11/06 20:20:56 lool Exp $ + -> Considering build-dep debhelper (>= 4.1.0) + -> Trying debhelper + . + . +.hy + + + .SH "AUTHOR" Initial coding, and main maintenance is done by Junichi Uekawa . diff --git a/pbuilder.8 b/pbuilder.8 index a419d87..a91c548 100644 --- a/pbuilder.8 +++ b/pbuilder.8 @@ -532,6 +532,55 @@ values that is not specified in The personal configuration file for pbuilder, which overrides settings set in other configuration files. +.SH "EXAMPLES" + +.TP +.B "pbuilder create" + +.nf +# pbuilder create +Distribution is sid. +Building the build environment + -> running debootstrap +/usr/sbin/debootstrap +I: Retrieving Release +I: Retrieving Packages +I: Validating Packages +.hy + + +.TP +.B "pbuilder update" + +.nf +# pbuilder update +W: /home/dancer/.pbuilderrc does not exist +Building the build Environment + -> extracting base tarball [/var/cache/pbuilder/base.tgz] + . + . +.hy + +.TP +.B "pbuilder build" + +.nf +# pbuilder build dsh_*.dsc +I: using fakeroot in build. +pbuilder-buildpackage/amd64 $Id: pbuilder-buildpackage-funcs,v 1.32 2006/11/06 20:06:25 lool Exp $ +$Id: pbuilder-buildpackage,v 1.127 2006/08/15 13:14:25 dancer Exp $ + +Current time: Sat Jan 20 12:03:34 JST 2007 +pbuilder-time-stamp: 1169262214 +Building the build Environment + -> extracting base tarball [/home/dancer/DEBIAN/pbuilder/pbuilder/testsuite/tmp.FeeAX18779/testimage] + -> creating local configuration + . + . + . +.hy + + .SH "BUGS" This program is starting to have too many options already. diff --git a/pdebuild.1 b/pdebuild.1 index c8a1115..4b97e19 100644 --- a/pdebuild.1 +++ b/pdebuild.1 @@ -135,6 +135,40 @@ Configuration file for pbuilder, used in pdebuild, overrides what is written in .B /etc/pbuilderrc + +.SH "EXAMPLES" + +.TP +.B "pdebuild" + +.nf +$ pwd +/home/dancer/DEBIAN/cowdancer/cowdancer +$ ls debian/rules +debian/rules +$ pdebuild +W: /home/dancer/.pbuilderrc does not exist +dpkg-buildpackage: source package is cowdancer +dpkg-buildpackage: source version is 0.26 +dpkg-buildpackage: source changed by Junichi Uekawa +dpkg-buildpackage: source version without epoch 0.26 + fakeroot debian/rules clean +dh_testdir +dh_testroot +rm -f build-stamp configure-stamp +/usr/bin/make clean +make[1]: Entering directory `/home/dancer/DEBIAN/cowdancer/cowdancer' +rm -f *~ *.o *.lo libcowdancer.so cow-shell cowbuilder +make[1]: Leaving directory `/home/dancer/DEBIAN/cowdancer/cowdancer' +dh_clean + dpkg-source -b cowdancer +dpkg-source: warning: source directory `./cowdancer' is not - `cowdancer-0.26' +dpkg-source: building cowdancer in cowdancer_0.26.tar.gz + . + . + . +.hy + .SH "BUGS" pdebuild will accept all options that pbuilder accepts as pdebuild -- cgit v1.2.3