changed manpage pbuilder.1 to pbuilder.8

1 files changed, 289 insertions, 0 deletions

diff --git a/pbuilder.8 b/pbuilder.8
new file mode 100644
index 0000000..8a68cc2
--- /dev/null
+++ b/pbuilder.8
@@ -0,0 +1,289 @@
+.TH "pbuilder" 8 "2001 Aug 25" "Debian" "pbuilder"
+.SH NAME
+pbuilder \- personal package builder
+.SH SYNOPSIS
+.BI "pbuilder create [" "options" "]"
+.PP
+.BI "pbuilder update [" "options" "]"
+.PP
+.BI "pbuilder build [" "options" "] " ".dsc-file"
+.PP
+.BI "pbuilder clean"
+.PP
+.BI "pbuilder login"
+.SH DESCRIPTION
+Front end program to the 
+.B "pbuilder"
+suite of programs, used for creating and maintaining chroot environment 
+and building Debian package in the chroot environment.
+.SH OPTIONS
+.TP
+.B "create"
+Creates a 
+.B "base.tgz" 
+for the specified distribution.
+
+.TP
+.B "update"
+Updates the 
+.B "base.tgz"
+for the specified distribution.
+Also, by specifying the 
+.B "--distribution"
+option, it is possible to switch the distribution.
+Specify a dummy distribution value 
+even for custom apt config files.
+
+.TP
+.B "build"
+Builds the package specified by
+.I ".dsc-file"
+in the chroot environment created using the 
+.B "base.tgz"
+
+.TP
+.B "clean"
+Cleans up the directory specified by the configuration
+.B "BUILDPLACE"
+and
+.B "APTCACHE"
+specified in 
+.I "/etc/pbuilderrc"
+
+.TP
+.B "login"
+Logs into the chroot, and cleaned up afterwards.
+Any changes you make will not be kept.
+
+.TP
+.B "debuild"
+Builds a Debian package from the Debian source directory.
+There needs to be a 
+.I "debian/"
+directory in the current directory.
+
+This command is a convenience script, 
+and it does not accept most command-line options.
+This may change in the future.
+
+.TP
+.BI "--basetgz [" "basetgz-location" "]"
+Specifies the location of 
+.B "base.tgz"
+
+This option will define the default distribution and 
+apt-lines when used in
+.B "pbuilder update"
+and 
+.B "pbuilder create"
+
+.TP
+.BI "--buildplace [" "location of build" "]"
+Specifies the location where building and 
+.B "base.tgz"
+updating and creation takes place. This is 
+a temporary work directory.
+.TP
+.BI "--buildresult [" "location to put build result" "]"
+Specifies the location the build result gets into after building.
+The deb files and other files that have resulted from build 
+is copied there.
+Note that the default value is not the current directory,
+or 
+.B ".."
+but somewhere else entirely. 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 
+specified in 
+.B "sources.list"
+inside the chroot.
+This option is only valid when distribution is being specified, for 
+update and build targets.
+The format is something like:
+.I "http://http.us.debian.org/debian" 
+which should point to your favorite mirror.
+
+This option can optionally be omitted, and left blank,
+in which case, this part is skipped.
+
+Note that these URLs specified to pbuilder will be used from within
+the chroot, and specifying 
+.B "file:/somewhere/"
+will most probably fail.
+
+.TP
+.BI "--nonusmirror [" "mirror location" "]"
+The non-US mirror, specified like the 
+.B "--mirror"
+option
+.TP
+.BI "--othermirror [" "apt deb line " "|" " other deb lines... " "]"
+The lines which is added to the sources.list, delimited with 
+.B "|"
+Like 
+.B "deb http://local/mirror stable main|deb file:/usr/local/mirror ./"
+
+The deb lines here are the ones that will appear at the top of the 
+.B sources.list
+inside the chroot.
+
+.TP
+.BI "--http-proxy [" "proxy" "]"
+Specifies the http proxy url. Something like
+.B "http://xxx.xxx.xxx.xxx:8080/"
+should do. 
+.TP
+.BI "--distribution [" "distribution" "]"
+Specifies the distribution used. Currently the supported values are
+.B "sid"
+and 
+.B "woody".
+.TP
+.BI "--removepackages [" "packages to remove" "]"
+Removes the packages on creating the 
+.BI "base.tgz" "."
+Use this option to remove potentially dangerous or undesirable
+packages, like
+.B "lilo"
+which nobody will need to have inside a chroot.
+
+Packages should be specified in a space-delimited manner, 
+surrounded in double quotations, like 
+.B """lilo gcc mawk"""
+
+.TP
+.BI "--extrapackages [" "packages to add" "]"
+Adds packages specified as an addition to the default,
+which is 
+.B build-essential
+by default.
+This is used in 
+.B "build"
+and 
+.B "create"
+and 
+.B "update"
+
+The packages should be specified as a space-delimited list.
+
+.TP
+.BI "--configfile [" "configuration file to load" "]"
+Loads the configuration file.
+
+
+\" START OF hookdir description
+
+.TP
+.BI "--hookdir [" "location of user scripts" "]"
+Specifies the location where scripts for user intervention during
+the create and update process are stored. Currently scripts are
+executed at only one point, on exit from the chrooted environment,
+just before either a create or a build regenerated the base.tgz
+file. The script names must be in the form 
+.B "X<digit><digit><whatever-else-you-want>"
+much like boot scripts. The scripts must be executable and may
+be either binaries or interpreted scripts. If it is a script
+in other than Bourne Shell or Perl, it is up to the user to
+ensure the interpreter was previously installed in the chrooted
+environment. Files ending in ~ or .bak are ignored.
+
+Although it may not seem necessary, 
+.B "pbuilder update" 
+does not invoke the hooks if 
+.B "--hookdir"
+is empty, so if you want to avoid running hooks,
+run pbuilder with
+.B "--hookdir """""
+
+If there is a distribution hook, for example, if 
+there was a file 
+.B "sid"
+inside the hook directory, and the script was creating the 
+chroot for
+.B "sid"
+distribution, pbuilder will call debootstrap with that 
+as the 4th parameter in the chroot creation process.
+This allows for use of custom debootstrap hook script.
+
+.B "A<digit><digit><whatever-else-you-want>"
+is for 
+.B build 
+target. 
+It is executed before build starts, after
+unpacking the build system, and unpacking the source.
+
+.B "B<digit><digit><whatever-else-you-want>"
+is executed after build system finishes building,
+successfully, before copying back the build result.
+
+.B "C<digit><digit><whatever-else-you-want>"
+is executed after build fails, before cleanup.
+
+.B "D<digit><digit><whatever-else-you-want>"
+is executed before unpacking the source inside the chroot,
+after setting up the chroot environment.
+Create $TMP, and $TMPDIR if necessary.
+
+
+
+\" End of hookdir description
+
+.TP
+.BI "--debemail [" "email-address" "]"
+
+Specifies that dpkg-buildpackage be called with
+.B "-m$DEBEMAIL"
+instead of default value specified in the environmental
+variable, or pbuilderrc
+
+.B "This option is almost obsolete, use --debbuildopts instead"
+
+.TP
+.BI "--debbuildopts [" "options" "]"
+
+List of options that are passed on to dpkg-buildpackage. Overrides
+any value given in DEBBUILDOPTS as specified in
+pbuilderrc.
+
+.TP
+.BI "--logfile [" "file to log" "]"
+Specifies the logfile to create. 
+The messages generated during execution will be written to the file, 
+instead of messages coming to the 
+standard output.
+
+.TP
+.BI "--aptconfdir [" "APT configuration directory to use" "]"
+Uses the apt configuration file found in the specified directory 
+as the chroot configuration.
+.B "/etc/apt"
+is one example, so that  the same configuration can be used inside the
+chroot.
+
+This option overrides other options, and may cause some inconsistency
+problems.
+
+.SH "FILES"
+.TP
+.I "/etc/pbuilderrc"
+The system-wide configuration file for pbuilder.
+.TP
+.I "/usr/share/pbuilder/pbuilderrc"
+The default settings for pbuilder, used as fallback.
+.TP
+.I "${HOME}/.pbuilderrc"
+The personal configuration file for pbuilder.
+.SH BUGS
+This program is starting to have too many options already.
+.SH AUTHOR
+Initial coding, and main maintenance is done by 
+Junichi Uekawa <dancer@debian.org>.
+User hooks code added by Dale Amon <amon@vnl.com>
+.SH "SEE ALSO"
+.RI "pdebuild (" 1 "), "
+.RI "pbuilderrc (" 5 ") "
+