add EXAMPLES section to documentation

5 files changed, 111 insertions, 1 deletions

diff --git a/ChangeLog b/ChangeLog
index 885d8ba..06e3f9a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2007-01-20  Junichi Uekawa  <dancer@debian.org>
+
+	* pbuilder.8: add EXAMPLES section
+
+	* pdebuild.1: add EXAMPLES section
+
+	* debuild-pbuilder.1: add EXAMPLES section.
+
 2007-01-13  Junichi Uekawa  <dancer@debian.org>
 
 	* 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 <dancer@debian.org>  Sat, 13 Jan 2007 23:13:30 +0900
+ -- Junichi Uekawa <dancer@debian.org>  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 <dancer@debian.org>.
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 <dancer@debian.org>
+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 <sourcepackage>-<upstreamversion> `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