diff options
| -rw-r--r-- | ChangeLog | 4 | ||||
| -rw-r--r-- | Documentation/pbuilder-doc.xml | 40 | ||||
| -rw-r--r-- | debian/changelog | 3 |
3 files changed, 36 insertions, 11 deletions
@@ -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 |