Adding live-helper 1.0~a2-1.

7 files changed, 390 insertions, 0 deletions

diff --git a/manpages/lh_binary.1 b/manpages/lh_binary.1
new file mode 100644
index 000000000..cb6079511
--- /dev/null
+++ b/manpages/lh_binary.1
@@ -0,0 +1,56 @@
+.TH LH_BINARY 1 "2007\-03\-19" "1.0~a2" "live\-helper"
+
+.SH NAME
+lh_binary \- meta-helper for lh_binary_*
+
+.SH SYNOPSIS
+.B lh_binary [\fIlive\-helper\ options\fR\|]
+
+.SH DESCRIPTION
+lh_binary is a meta-helper. It calls all necessary helpers to complete the binary stage.
+
+.SH OPTIONS
+lh_bootstrap has no options (FIXME).
+
+.SH BINARY HELPERS
+Here is the complete list of available binary helper commands. See their man pages for additional documentation.
+.IP "\fIlh_binary_encryption\fR(1)" 4
+encrypts the root filesystem.
+.IP "\fIlh_binary_includes\fR(1)" 4
+copies files into the binary image.
+.IP "\fIlh_binary_hdd\fR(1)" 4
+creates the harddisk binary tarball.
+.IP "\fIlh_binary_iso\fR(1)" 4
+creates the CD/DVD binary image.
+.IP "\fIlh_binary_linuximage\fR(1)" 4
+copies linux-image into the binary image.
+.IP "\fIlh_binary_localincludes\fR(1)" 4
+copies local files into the binary image.
+.IP "\fIlh_binary_manifest\fR(1)" 4
+creates the package list of the root filesystem.
+.IP "\fIlh_binary_md5sum\fR(1)" 4
+creates md5sum.txt in the binary image.
+.IP "\fIlh_binary_memtest86\fR(1)" 4
+copies memtest86 into the binary image.
+.IP "\fIlh_binary_net\fR(1)" 4
+creates the netboot binary tarball.
+.IP "\fIlh_binary_rootfs\fR(1)" 4
+creates the root filesystem.
+.IP "\fIlh_binary_syslinux\fR(1)" 4
+copies syslinux into the binary image.
+.IP "\fIlh_binary_usb\fR(1)" 4
+creates the USB binary image.
+
+.SH SEE ALSO
+\fIlive\-helper\fR(7)
+.PP
+This program is a part of live-helper.
+
+.SH BUGS
+Report bugs against live\-helper <\fIhttp://packages.qa.debian.org/live\-helper/\fR>.
+
+.SH HOMEPAGE
+More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
+
+.SH AUTHOR
+live\-helper was written by Daniel Baumann <\fIdaniel@debian.org\fR> and Marco Amadori <\fImarco.amadori@gmail.com\fR>, for the Debian project.
diff --git a/manpages/lh_bootstrap.1 b/manpages/lh_bootstrap.1
new file mode 100644
index 000000000..4dcfc0e18
--- /dev/null
+++ b/manpages/lh_bootstrap.1
@@ -0,0 +1,42 @@
+.TH LH_BOOTSTRAP 1 "2007\-03\-19" "1.0~a2" "live\-helper"
+
+.SH NAME
+lh_bootstrap \- meta-helper for lh_bootstrap_*
+
+.SH SYNOPSIS
+.B lh_bootstrap [\fIlive\-helper\ options\fR\|]
+
+.SH DESCRIPTION
+lh_bootstrap is a meta-helper. It calls all necessary helpers to complete the bootstrap stage.
+
+.SH CONFIGURATION FILE
+lh_bootstrap reads config/common if available. See ENVIRONMENT for the correct environment variables to use.
+
+.SH ENVIRONMENT
+lh_bootstrap respects the following environment variables if available, otherwise uses default values for it.
+.IP "\fI$LH_BOOTSTRAP\fR" 4
+select the bootstrap program (Default: cdebootstrap)
+
+.SH OPTIONS
+lh_bootstrap has no options (FIXME).
+
+.SH BOOTSTRAP HELPERS
+Here is the complete list of available bootstrap helper commands. See their man pages for additional documentation.
+.IP "\fIlh_bootstrap_cdebootstrap\fR(1)" 4
+bootstraps system with cdebootstrap.
+.IP "\fIlh_bootstrap_debootstrap\fR(1)" 4
+bootstraps system with debootstrap.
+
+.SH SEE ALSO
+\fIlive\-helper\fR(7)
+.PP
+This program is a part of live-helper.
+
+.SH BUGS
+Report bugs against live\-helper <\fIhttp://packages.qa.debian.org/live\-helper/\fR>.
+
+.SH HOMEPAGE
+More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
+
+.SH AUTHOR
+live\-helper was written by Daniel Baumann <\fIdaniel@debian.org\fR> and Marco Amadori <\fImarco.amadori@gmail.com\fR>, for the Debian project.
diff --git a/manpages/lh_bootstrap_cdebootstrap.1 b/manpages/lh_bootstrap_cdebootstrap.1
new file mode 100644
index 000000000..812bc379e
--- /dev/null
+++ b/manpages/lh_bootstrap_cdebootstrap.1
@@ -0,0 +1,49 @@
+.TH LH_BOOTSTRAP_CDEBOOTSTRAP 1 "2007\-03\-19" "1.0~a2" "live\-helper"
+
+.SH NAME
+lh_bootstrap_cdebootstrap \- bootstrap a Debian system with \fIcdebootstrap\fR(1)
+
+.SH SYNOPSIS
+.B lh_bootstrap_cdebootstrap [\fIlive\-helper\ options\fR\|]
+
+.SH DESCRIPTION
+lh_bootstrap_cdebootstrap uses \fIcdebootstrap\fR(1) to create a Debian base system from scratch.
+
+.SH CONFIGURATION FILE
+lh_bootstrap_cdebootstrap reads config/common and config/bootstrap if available. See ENVIRONMENT for the correct environment variables to use.
+
+.SH ENVIRONMENT
+lh_bootstrap_cdebootstrap respects the following environment variables if available, otherwise uses default values for it.
+.IP "\fI$LH_CACHE\fR" 4
+control if downloaded packages should be cached (Default: enabled)
+.IP "\fI$LH_ROOT\fR" 4
+set the root directory (Default: debian-live)
+.IP "\fI$LIVE_ARCHITECTURE\fR" 4
+select the chroot architecture (Default: autodetected)
+.IP "\fI$LIVE_DISTRIBUTION\fR" 4
+select the distribution to use (Default: sid)
+.IP "\fI$LIVE_DISTRIBUTION_CONFIG\fR" 4
+set distribution config directory (Default: empty)
+.IP "\fI$LIVE_FLAVOUR\fR" 4
+select the flavour to use (Default: standard)
+.IP "\fI$LIVE_MIRROR_LOCAL\fR" 4
+set the local mirror to use (Default: http://ftp.debian.org/debian/)
+
+.SH OPTIONS
+lh_bootstrap_cdebootstrap has no options (FIXME).
+
+.SH SEE ALSO
+\fIcdebootstrap\fR(1)
+.PP
+\fIlive\-helper\fR(7)
+.PP
+This program is a part of live-helper.
+
+.SH BUGS
+Report bugs against live\-helper <\fIhttp://packages.qa.debian.org/live\-helper/\fR>.
+
+.SH HOMEPAGE
+More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
+
+.SH AUTHOR
+live\-helper was written by Daniel Baumann <\fIdaniel@debian.org\fR> and Marco Amadori <\fImarco.amadori@gmail.com\fR>, for the Debian project.
diff --git a/manpages/lh_bootstrap_debootstrap.1 b/manpages/lh_bootstrap_debootstrap.1
new file mode 100644
index 000000000..3ccb509e1
--- /dev/null
+++ b/manpages/lh_bootstrap_debootstrap.1
@@ -0,0 +1,49 @@
+.TH LH_BOOTSTRAP_DEBOOTSTRAP 1 "2007\-03\-19" "1.0~a2" "live\-helper"
+
+.SH NAME
+lh_bootstrap_debootstrap \- bootstrap a Debian system with \fIdebootstrap\fR(8)
+
+.SH SYNOPSIS
+.B lh_bootstrap_debootstrap [\fIlive\-helper\ options\fR\|]
+
+.SH DESCRIPTION
+lh_bootstrap_debootstrap uses \fIdebootstrap\fR(8) to create a Debian base system from scratch.
+
+.SH CONFIGURATION FILE
+lh_bootstrap_debootstrap reads config/common and config/bootstrap if available. See ENVIRONMENT for the correct environment variables to use.
+
+.SH ENVIRONMENT
+lh_bootstrap_debootstrap respects the following environment variables if available, otherwise uses default values for it.
+.IP "\fI$LH_CACHE\fR" 4
+control if downloaded packages should be cached (Default: enabled)
+.IP "\fI$LH_ROOT\fR" 4
+set the root directory (Default: debian-live)
+.IP "\fI$LIVE_ARCHITECTURE\fR" 4
+select the chroot architecture (Default: autodetected)
+.IP "\fI$LIVE_DISTRIBUTION\fR" 4
+select the distribution to use (Default: sid)
+.IP "\fI$LIVE_DISTRIBUTION_CONFIG\fR" 4
+set distribution config directory (Default: empty)
+.IP "\fI$LIVE_FLAVOUR\fR" 4
+select the flavour to use (Default: standard)
+.IP "\fI$LIVE_MIRROR_LOCAL\fR" 4
+set the local mirror to use (Default: http://ftp.debian.org/debian/)
+
+.SH OPTIONS
+lh_bootstrap_debootstrap has no options (FIXME).
+
+.SH SEE ALSO
+\fIdebootstrap\fR(8)
+.PP
+\fIlive\-helper\fR(7)
+.PP
+This program is a part of live-helper.
+
+.SH BUGS
+Report bugs against live\-helper <\fIhttp://packages.qa.debian.org/live\-helper/\fR>.
+
+.SH HOMEPAGE
+More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
+
+.SH AUTHOR
+live\-helper was written by Daniel Baumann <\fIdaniel@debian.org\fR> and Marco Amadori <\fImarco.amadori@gmail.com\fR>, for the Debian project.
diff --git a/manpages/lh_clean.1 b/manpages/lh_clean.1
new file mode 100644
index 000000000..d520a28d8
--- /dev/null
+++ b/manpages/lh_clean.1
@@ -0,0 +1,27 @@
+.TH LH_CLEAN 1 "2007\-03\-19" "1.0~a2" "live\-helper"
+
+.SH NAME
+lh_clean \- clean up system build directories
+
+.SH SYNOPSIS
+.B lh_clean [\fIlive\-helper\ options\fR\|]
+
+.SH DESCRIPTION
+lh_clean is a live\-helper program that is responsible for cleaning up after a system is built. It removes the system build directories, and removes some other files including stage files, and any detritus left behind by other live\-helper commands.
+
+.SH OPTIONS
+lh_clean has no options (FIXME).
+
+.SH SEE ALSO
+\fIlive\-helper\fR(7)
+.PP
+This program is a part of live-helper.
+
+.SH BUGS
+Report bugs against live\-helper <\fIhttp://packages.qa.debian.org/live\-helper/\fR>.
+
+.SH HOMEPAGE
+More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
+
+.SH AUTHOR
+live\-helper was written by Daniel Baumann <\fIdaniel@debian.org\fR> and Marco Amadori <\fImarco.amadori@gmail.com\fR>, for the Debian project.
diff --git a/manpages/lh_testroot.1 b/manpages/lh_testroot.1
new file mode 100644
index 000000000..76ff77213
--- /dev/null
+++ b/manpages/lh_testroot.1
@@ -0,0 +1,27 @@
+.TH LH_TESTROOT 1 "2007\-03\-19" "1.0~a2" "live\-helper"
+
+.SH NAME
+lh_testroot \- ensure that a system is built as root
+
+.SH SYNOPSIS
+.B lh_testroot [\fIlive\-helper\ options\fR\|]
+
+.SH DESCRIPTION
+lh_testroot simply checks to see if you are root. If not, it exits with an error. Debian Live images must currently be built as real root, \fIfakeroot\fR(1) or \fIsudo\fR(8) does not work.
+
+.SH OPTIONS
+lh_testroot has no options (FIXME).
+
+.SH SEE ALSO
+\fIlive\-helper\fR(7)
+.PP
+This program is a part of live-helper.
+
+.SH BUGS
+Report bugs against live\-helper <\fIhttp://packages.qa.debian.org/live\-helper/\fR>.
+
+.SH HOMEPAGE
+More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
+
+.SH AUTHOR
+live\-helper was written by Daniel Baumann <\fIdaniel@debian.org\fR> and Marco Amadori <\fImarco.amadori@gmail.com\fR>, for the Debian project.
diff --git a/manpages/live-helper.7 b/manpages/live-helper.7
new file mode 100644
index 000000000..4f5587f6e
--- /dev/null
+++ b/manpages/live-helper.7
@@ -0,0 +1,140 @@
+.TH LIVE\-HELPER 7 "2007\-03\-19" "1.0~a2" "live\-helper"
+
+.SH NAME
+live\-helper \- Debian Live helper programs
+
+.SH SYNOPSIS
+.B lh_* [\fIlive\-helper\ options\fR\|]
+
+.SH DESCRIPTION
+Live\-helper is a collection of programs that can be used to build Debian Live system images. The philosophy behind live\-helper is to provide a collection of small, simple, and easily understood tools that can be used in your own program to automate building of a Live system.
+.PP
+A typical program that uses live\-helper will call several live\-helper commands in sequence. Live\-helper commands are all named with a "lh_" prefix. Examples of such a program that uses live\-helper is \fImake\-live\fR(1).
+
+.\" .SH CONFIGURATION FILE
+.\" live-helper reads debian-live/config/live-helper if available. See ENVIRONMENT for the correct environment variables to use.
+
+.\" .SH ENVIRONMENT
+.\" Every live-helper command respects the following environment variables if available.
+.\" .IP "\fI$LH_DEBUG\fR" 4
+.\" enables debug (Default: false)
+.\" .IP "\fI$LH_QUIET\fR" 4
+.\" be quiet (Default: false)
+.\" .IP "\fI$LH_VERBOSE\fR" 4
+.\" be verbose (Default: false)
+
+.SH LIVE\-HELPER COMMANDS
+Here is the complete list of available live\-helper commands. See their man pages for additional documentation.
+.IP "\fIlh_binary\fR(1)" 4
+meta-helper for lh_binary_*.
+.IP "\fIlh_binary_encryption\fR(1)" 4
+encrypts the root filesystem.
+.IP "\fIlh_binary_includes\fR(1)" 4
+copies files into the binary image.
+.IP "\fIlh_binary_hdd\fR(1)" 4
+creates the harddisk binary tarball.
+.IP "\fIlh_binary_iso\fR(1)" 4
+creates the CD/DVD binary image.
+.IP "\fIlh_binary_linuximage\fR(1)" 4
+copies linux-image into the binary image.
+.IP "\fIlh_binary_localincludes\fR(1)" 4
+copies local files into the binary image.
+.IP "\fIlh_binary_manifest\fR(1)" 4
+creates the package list of the root filesystem.
+.IP "\fIlh_binary_md5sum\fR(1)" 4
+creates md5sum.txt in the binary image.
+.IP "\fIlh_binary_memtest86\fR(1)" 4
+copies memtest86 into the binary image.
+.IP "\fIlh_binary_net\fR(1)" 4
+creates the netboot binary tarball.
+.IP "\fIlh_binary_rootfs\fR(1)" 4
+creates the root filesystem.
+.IP "\fIlh_binary_syslinux\fR(1)" 4
+copies syslinux into the binary image.
+.IP "\fIlh_binary_usb\fR(1)" 4
+creates the USB binary image.
+.IP "\fIlh_bootstrap\fR(1)" 4
+meta-helper for lh_bootstrap_*.
+.IP "\fIlh_bootstrap_cdebootstrap\fR(1)" 4
+bootstraps system with cdebootstrap.
+.IP "\fIlh_bootstrap_debootstrap\fR(1)" 4
+bootstraps system with debootstrap.
+.IP "\fIlh_build\fR(1)" 4
+meta-helper for lh_bootstrap, lh_chroot, lh_binary and lh_source.
+.IP "\fIlh_chroot\fR(1)" 4
+meta-helper for lh_chroot_*.
+.IP "\fIlh_chroot_apt\fR(1)" 4
+configures /etc/apt/apt.conf in chroot.
+.IP "\fIlh_chroot_debianchroot\fR(1)" 4
+configures /etc/debian_chroot in chroot.
+.IP "\fIlh_chroot_hacks\fR(1)" 4
+does evil (temporary) hacks in the chroot.
+.IP "\fIlh_chroot_hooks\fR(1)" 4
+executes additional commands in the chroot.
+.IP "\fIlh_chroot_hosts\fR(1)" 4
+configures /etc/hosts in the chroot.
+.IP "\fIlh_chroot_linuximage\fR(1)" 4
+configures /etc/kernel-img.conf in the chroot.
+.IP "\fIlh_chroot_localhooks\fR(1)" 4
+executes additional local commands in the chroot.
+.IP "\fIlh_chroot_localincludes\fR(1)" 4
+copies local files into the binary image.
+.IP "\fIlh_chroot_localization\fR(1)" 4
+installs localization packages in the chroot.
+.IP "\fIlh_chroot_localpackages\fR(1)" 4
+installs local packages in the chroot.
+.IP "\fIlh_chroot_localpackageslist\fR(1)" 4
+installs local packages lists in the chroot.
+.IP "\fIlh_chroot_packages\fR(1)" 4
+installs packages in the chroot.
+.IP "\fIlh_chroot_packageslist\fR(1)" 4
+installs packages lists in the chroot.
+.IP "\fIlh_chroot_proc\fR(1)" 4
+mounts /proc in the chroot.
+.IP "\fIlh_chroot_resolv\fR(1)" 4
+configures /etc/resolf.conf in the chroot.
+.IP "\fIlh_chroot_sources\fR(1)" 4
+configures /etc/apt/sources.list in the chroot.
+.IP "\fIlh_chroot_symlinks\fR(1)" 4
+converts symlinks in the chroot.
+.IP "\fIlh_chroot_sysfs\fR(1)" 4
+mounts /sys in the chroot.
+.IP "\fIlh_chroot_sysvinit\fR(1)" 4
+minimizes daemon startup in the chroot.
+.IP "\fIlh_chroot_sysvrc\fR(1)" 4
+installs policy-id hack in the chroot.
+.IP "\fIlh_chroot_tasks\fR(1)" 4
+installs packages tasks in the chroot.
+.IP "\fIlh_clean\fR(1)" 4
+cleans up build directory.
+.IP "\fIlh_config\fR(1)" 4
+creates sample configuration.
+.IP "\fIlh_losetup\fR(1)" 4
+manages loop device handling
+.IP "\fIlh_source\fR(1)" 4
+meta-helper for lh_source_*.
+.IP "\fIlh_source_config\fR(1)" 4
+copies config into source directory.
+.IP "\fIlh_source_download\fR(1)" 4
+downloads source packages.
+.IP "\fIlh_source_hdd\fR(1)" 4
+creates harddisk source tarball.
+.IP "\fIlh_source_generic\fR(1)" 4
+creates generic source tarball.
+.IP "\fIlh_source_iso\fR(1)" 4
+creates CD/DVD source image.
+.IP "\fIlh_source_net\fR(1)" 4
+creates netboot source tarball.
+.IP "\fIlh_source_usb\fR(1)" 4
+creates USB source image.
+.IP "\fIlh_testroot\fR(1)" 4
+checks for root privileges.
+
+.SH BUGS
+Report bugs against live\-helper <\fIhttp://packages.qa.debian.org/live\-helper/\fR>.
+
+.SH HOMEPAGE
+More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
+
+.SH AUTHOR
+live\-helper was written by Daniel Baumann <\fIdaniel@debian.org\fR> and Marco Amadori <\fImarco.amadori@gmail.com\fR>, for the Debian project.