From comment from Sesse, note that the

default place build results are placed is
/var/cache/pbuilder/result.

5 files changed, 36 insertions, 15 deletions

diff --git a/ChangeLog b/ChangeLog
index 99f7adf..086f44d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2006-05-28  Junichi Uekawa  <dancer@debian.org>
+
+	* pbuilder-user-mode-linux.1: uppercase url->URL
+
+	* pbuilder.8: ditto
+
+	* pdebuild.1: From comment from Sesse, note that the
+	default place build results are placed is
+	/var/cache/pbuilder/result.
+
 2006-05-27  Junichi Uekawa  <dancer@debian.org>
 
 	* Documentation/pbuilder-doc.xml: document cowdancer and pdebuild
diff --git a/debian/changelog b/debian/changelog
index ce3c01f..e5399dd 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,8 +2,11 @@ pbuilder (0.154) UNRELEASED; urgency=low
 
   [Junichi Uekawa]
   * Document cowdancer and pdebuild.
+  * pbuilder.8, pdebuild.1: document that default build result directory
+    is /var/cache/pbuilder/result, instead of expecting users to read
+    somewhere else.
 
- -- Junichi Uekawa <dancer@debian.org>  Sat, 27 May 2006 17:40:13 +0900
+ -- Junichi Uekawa <dancer@debian.org>  Sun, 28 May 2006 08:00:45 +0900
 
 pbuilder (0.153) unstable; urgency=low
 
diff --git a/pbuilder-user-mode-linux.1 b/pbuilder-user-mode-linux.1
index f414688..eba928a 100644
--- a/pbuilder-user-mode-linux.1
+++ b/pbuilder-user-mode-linux.1
@@ -183,7 +183,7 @@ options.
 
 .TP
 .BI "\-\-mirror [" "mirror location" "]"
-Specifies the url of Debian mirror to be 
+Specifies the URL of Debian mirror to be 
 specified in 
 .B "sources.list"
 inside the chroot.
diff --git a/pbuilder.8 b/pbuilder.8
index fae08c3..fd3ea7b 100644
--- a/pbuilder.8
+++ b/pbuilder.8
@@ -132,13 +132,15 @@ is copied there.
 Note that the default value is not the current directory,
 or 
 .B ".."
-but somewhere else entirely. This is to avoid
+but another place, 
+.B "/var/cache/pbuilder/result"
+This is to avoid
 overwriting already existing deb files with
 the newly generated ones.
 
 .TP
 .BI "\-\-mirror [" "mirror location" "]"
-Specifies the url of Debian mirror to be 
+Specifies the URL of Debian mirror to be 
 specified in 
 .B "sources.list"
 inside the chroot.
@@ -185,7 +187,7 @@ is being called.
 
 .TP
 .BI "\-\-http\-proxy [" "proxy" "]"
-Specifies the http proxy url. Something like
+Specifies the http proxy URL. Something like
 .B "http://xxx.xxx.xxx.xxx:8080/"
 should do. 
 .TP
@@ -544,3 +546,5 @@ The homepage is available at
 .RI "pdebuild (" 1 "), "
 .RI "pbuilderrc (" 5 ") "
 
+
+\"  LocalWords:  buildresult
diff --git a/pdebuild.1 b/pdebuild.1
index 07642e3..0f2d6f2 100644
--- a/pdebuild.1
+++ b/pdebuild.1
@@ -6,11 +6,11 @@ pdebuild \- pbuilder way of doing debuild
 .PP
 .SH DESCRIPTION
 A convenience program for 
-.B pbuilder
+.B "pbuilder"
 which invokes pbuilder after obtaining appropriate root privilege 
 in a Debian source directory.
 One must be inside the source tree containing the
-.B debian
+.B "debian"
 directory, in order to make it work.
 
 .SH "PDEBUILD OPTIONS"
@@ -22,8 +22,6 @@ which will modify the semantics as explained below.
 They are applied from left-to-right, and when there are 
 conflicting options, the rightmost options will have effect.
 
-
-
 .TP
 .BI "\-\-buildsourceroot [" "fakeroot" "]"
 The command used to gain root privilege for 
@@ -53,10 +51,16 @@ The place which build result is stored.
 Note that for pdebuild, buildresult needs to be specified as pdebuild
 option in the command-line, not as pbuilder option.
 
+Note that the default value for buildresult is what is defined for
+pbuilder,
+.B "/var/cache/pbuilder/result"
+and not 
+.B ".."
+
 .TP
 .BI "\-\-configfile [" "Extra config file to use" "]"
 
-The configuration file is used, and passed on to 
+The configuration file is used, and passed on to
 .BR "pbuilder" .
 
 .TP
@@ -128,10 +132,10 @@ overrides what is written in
 .B /etc/pbuilderrc
 
 .SH "BUGS"
-pdebuid will accept all options that pbuilder accepts as 
-pdebuild option.
-However, unless the option is documented in the manual page, it 
-may be ignored.
+
+pdebuid will accept all options that pbuilder accepts as pdebuild
+option.  However, unless the option is documented in the manual page,
+it may be ignored.
 
 .SH "AUTHOR"
 Initial coding, and main maintenance is done by 
@@ -144,4 +148,4 @@ The homepage is available at
 .RI "pbuilder (" 8 "), "
 .RI "pbuilderrc (" 5 ") "
 
-\"  LocalWords:  pdebuild pbuilder debuild debian debsign pdebuid
+\"  LocalWords:  pdebuild pbuilder debuild debian debsign pdebuid buildresult