aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog4
-rw-r--r--Documentation/pbuilder-doc.xml40
-rw-r--r--debian/changelog3
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