documentation update

4 files changed, 35 insertions, 4 deletions

diff --git a/ChangeLog b/ChangeLog
index 0a94f71..612fa34 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2002-12-16  Junichi Uekawa  <dancer@debian.org>
+
+	* THANKS: update.
+
+	* pdebuild.1: More vigorously document pdebuild option, which changed.
+	From: Jose Carlos Garcia Sogo <jsogo@debian.org>.
+
 2002-12-15  Junichi Uekawa  <dancer@debian.org>
 
 	* THANKS: update this file, thinking that this file is probably autogenerated from
diff --git a/THANKS b/THANKS
index 912316b..baa5f78 100644
--- a/THANKS
+++ b/THANKS
@@ -21,6 +21,7 @@ Clint Adams <schizo@debian.org>
 Daniel Schepler <schepler@math.berkeley.edu>
 Andrew Lau <netsnipe@debianplanet.org>
 Sam Couter <sam@couter.dropbear.id.au> 
+Jose Carlos Garcia Sogo <jsogo@debian.org>
 
 I thank them all!
 
diff --git a/debian/changelog b/debian/changelog
index 8a8cc49..36bd90f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,12 @@
+pbuilder (0.55) unstable; urgency=low
+
+  * Update documentation on pdebuild to make it clear that pdebuild option behavior
+  changed since 0.52. --buildplace option now needs to be specified before "--"
+  (closes: #173150)
+  thanks to Jose Carlos Garcia Sogo <jsogo@debian.org> for butting me.
+
+ -- Junichi Uekawa <dancer@debian.org>  Mon, 16 Dec 2002 11:51:52 +0900
+
 pbuilder (0.54) unstable; urgency=low
 
   * Fixed ordering of messages so that concurrent-building experience is 
diff --git a/pdebuild.1 b/pdebuild.1
index 259695b..0e7eb53 100644
--- a/pdebuild.1
+++ b/pdebuild.1
@@ -2,7 +2,7 @@
 .SH NAME
 pdebuild \- pbuilder way of doing debuild
 .SH SYNOPSIS
-.BI "pdebuild [" "options" "] -- [" "pbuilder options" "]"
+.BI "pdebuild [" "pdebuild options" "] -- [" "pbuilder options" "]"
 .PP
 .SH DESCRIPTION
 A convenience program for 
@@ -13,7 +13,7 @@ One must be inside the source tree containing the
 .B debian
 directory, in order to make it work.
 
-.SH OPTIONS
+.SH "PDEBUILD OPTIONS"
 .TP
 .BI "--buildsourceroot [" "fakeroot" "]"
 The command used to gain root privilege for 
@@ -40,17 +40,31 @@ The place which build result is stored.
 After the 
 .B "--"
 symbol, an arbitrary number of pbuilder options can be specified.
+See pbuilder.8 for full list of options.
 
-Except for
+
+There is an exception that
 .B "--buildresult"
-which needs to be specified before the 
+needs to be specified as pdebuild option before the 
 .B "--"
+to be effective.
 
 .SH "FILES"
 .TP
 .I "/etc/pbuilderrc"
 The configuration file for pbuilder, used in pdebuild.
 
+.TP
+.I "/usr/share/pbuilder/pbuilderrc"
+The default configuration file for pbuilder, used in pdebuild.
+
+.TP
+.I "${HOME}/.pbuilderrc"
+Configuration file for pbuilder, used in pdebuild,
+overrides what is written in
+.B /etc/pbuilderrc
+
+
 .SH "AUTHOR"
 Initial coding, and main maintenance is done by 
 Junichi Uekawa <dancer@debian.org>.