revise documentation

3 files changed, 36 insertions, 11 deletions

diff --git a/ChangeLog b/ChangeLog
index 0d5c8c8..578f943 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2007-05-05  Junichi Uekawa  <dancer@debian.org>
+
+	* Documentation/pbuilder-doc.xml: update and clarify documentation.
+
 2007-04-22  Junichi Uekawa  <dancer@debian.org>
 
 	* examples/execute_installtest.sh: update install test so that it can handle more than one packages.
diff --git a/Documentation/pbuilder-doc.xml b/Documentation/pbuilder-doc.xml
index a367127..f9acc94 100644
--- a/Documentation/pbuilder-doc.xml
+++ b/Documentation/pbuilder-doc.xml
@@ -25,7 +25,7 @@
       <para>
 	<command>pbuilder</command> stands for
 	Personal Builder, and it is an automatic Debian Package Building system
-	for personal environments.
+	for personal development workstation environments.
 	<command>pbuilder</command> aims to be an
 	easy-to-setup system
 	for auto-building Debian packages inside a clean-room
@@ -70,18 +70,31 @@
   </chapter>
   <chapter id="usingpbuilder">
     <title>Using pbuilder</title>
+    <para>
+      There are several simple commands for operation.
+      <command>pbuilder create</command>, <command>pbuilder
+      update</command>, and <command>pbuilder build</command> commands
+      are the typical commands used.  Let us look at the commands
+      one by one.
+    </para>
     <sect1 id="creatingbase">
       <title>Creating a base chroot image</title>
       <para>
 	<command>pbuilder create</command>
 	will create a base chroot image.
-	The distribution code-name needs to be specified with
-	the <command><option>--distribution</option></command>
+	All other commands will operate on the resulting base chroot image.
+
+	If the Debian release to be created within chroot is not going
+	to be "sid" (which is the default), the distribution code-name
+	needs to be specified with the
+	<command><option>--distribution</option></command>
 	command-line option.
-	Usually, "sid" is used, and the default is now sid.
       </para>
       <para>
-	<command>debootstrap</command> is used to create
+	<command>debootstrap</command> <footnote>
+	  <para>debootstrap or cdebootstrap can be chosen</para>
+	</footnote>
+	is used to create
 	the bare minimum Debian installation,
 	and then build-essential packages are installed on top
 	of the minimum installation using <command>apt-get</command>
@@ -1165,14 +1178,21 @@ BINDMOUNTS="${CCACHE_DIR}"
 	and how things generally operate in development.
       </para>
       <para>
-	<command>pbuilder</command> is now co-maintained at alioth.
-	There is an alioth project page at
+	<command>pbuilder</command> is co-maintained with resources
+	provided by Alioth.
+
+	There is an Alioth project page at
 	<ulink url="http://alioth.debian.org/projects/pbuilder">
-	  http://alioth.debian.org/projects/pbuilder</ulink>.
-	git Repository is available through http, or if you have an account on alioth, 
-	ssh.
+	  http://alioth.debian.org/projects/pbuilder</ulink>.  
+	Home page is also available, 
+	at <ulink url="http://pbuilder.alioth.debian.org/">
+	  http://alioth.debian.org/projects/pbuilder</ulink>
+	which shows this text.
+	git repository is available through http, git, or (if you have an
+	account on alioth, ) ssh.
       </para>
       <screen>
+git-clone git://git.debian.org/git/pbuilder/pbuilder.git
 git-clone http://git.debian.org/git/pbuilder/pbuilder.git
 git-clone ssh://git.debian.org/git/pbuilder/pbuilder.git
       </screen>
diff --git a/debian/changelog b/debian/changelog
index 3693640..651bc2f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,12 +3,13 @@ pbuilder (0.167) UNRELEASED; urgency=low
   [ Junichi Uekawa ]
   * examples/execute_installtest.sh: update to support multiple packages
     as apt target.
+  * Documentation/pbuilder.xml: Improve documentation wordings.
   
   [ Loic Minier ]
   * Tune aptitude opts in pbuilder-satisfydepends-aptitude to handle complex
     dependencies in experimental and to support unsigned APT repositories.
 
- -- Loic Minier <lool@dooz.org>  Sun, 22 Apr 2007 13:55:09 +0200
+ -- Junichi Uekawa <dancer@debian.org>  Sat,  5 May 2007 19:25:12 +0900
 
 pbuilder (0.166) unstable; urgency=low