Bug#774730: Update manpages

2015-01-06 Thread jnqnfe
Updated patch attached, just tweaking descriptions a little further
commit 4dc31640d4e5855d99cad3ea9d58e52cbc21c30d
Author: jnqnfe jnq...@gmail.com
Date:   Tue Jan 6 20:56:05 2015 +

Bring manpages up to date (as far as v4.0.4-1)

diff --git a/manpages/en/lb_installer.1 b/manpages/en/lb_installer.1
new file mode 100644
index 000..c8dec01
--- /dev/null
+++ b/manpages/en/lb_installer.1
@@ -0,0 +1,32 @@
+.TH LIVE\-BUILD 1 2015\-01\-04 5.0~a1-1 Live Systems Project
+
+.SH NAME
+\fBlb installer\fR \- Complete the installer stage
+
+.SH SYNOPSIS
+\fBlb installer\fR [\fIlive\-build options\fR]
+
+.SH DESCRIPTION
+\fBlb installer\fR is a high\-level command (porcelain) of 
\fIlive\-build\fR(7), the live systems tool suite.
+.PP
+\fBlb installer\fR calls all necessary live\-build programs in the correct 
order to complete the installer stage.
+
+.SH OPTIONS
+\fBlb installer\fR has no specific options but understands all generic 
live\-build options. See \fIlive\-build\fR(7) for a complete list of all 
generic live\-build options.
+
+.SH FILES
+.IP \fBnone\fR 4
+
+.SH SEE ALSO
+\fIlive\-build\fR(7)
+.PP
+This program is a part of live\-build.
+
+.SH HOMEPAGE
+More information about live\-build and the Live Systems project can be found 
on the homepage at \fIhttp://live-systems.org/\fR and in the manual at 
\fIhttp://live-systems.org/manual/\fR.
+
+.SH BUGS
+Bugs can be reported by submitting a bugreport for the live\-build package in 
the Bug Tracking System at \fIhttp://bugs.debian.org/\fR or by writing a mail 
to the Live Systems mailing list at \fidebian-l...@lists.debian.org\fR.
+
+.SH AUTHOR
+live\-build was written by Daniel Baumann \fim...@daniel-baumann.ch\fR.
diff --git a/manpages/en/live-build.7 b/manpages/en/live-build.7
index 0b7e9ca..48c2e57 100644
--- a/manpages/en/live-build.7
+++ b/manpages/en/live-build.7
@@ -55,153 +55,173 @@ pages for additional documentation.
 .\ FIXME
 We separate the porcelain commands into the main commands and some ancillary 
user utilities.
 .SS Main porcelain commands
-.IP \fBlb_config\fR(1) 4
-create configuration for live\-build
-.IP \fBlb_bootstrap\fR(1) 4
-create the first stage by bootstrapping a basic debian system
-.IP \fBlb_chroot\fR(1) 4
-create the second stage by customizing the chroot
-.IP \fBlb_binary\fR(1) 4
-create the third stage by generating a binary image
-.IP \fBlb_source\fR(1) 4
-create the optional fourth stage by generating a source image
-.IP \fBlb_clean\fR(1) 4
-clean up system build directories
+.IP \fBlb config\fR(1) 4
+creates configuration for live\-build
+.IP \fBlb bootstrap\fR(1) 4
+executes the first build stage, creating (bootstraping) a basic Debian root 
filesystem
+.IP \fBlb chroot\fR(1) 4
+executes the second build stage, building the live OS filesystem
+.IP \fBlb installer\fR(1) 4
+executes the third build stage, obtaining installer components (optional)
+.IP \fBlb binary\fR(1) 4
+executes the fourth build stage, generating a binary image
+.IP \fBlb source\fR(1) 4
+executes the fifth build stage, generating a source image (optional)
+.IP \fBlb clean\fR(1) 4
+cleanes up system build directories
 .SS Ancillary Commands
 .IP \fBlb\fR(1) 4
-generic live\-build wrapper
-.IP \fBlb_build\fR(1) 4
-alias for all stages
-.IP \fBlb_local\fR(1) 4
-helper for using a local live\-build
-.IP \fBlb_testroot\fR(1) 4
-ensure that a system is built as root
+generic live\-build script execution wrapper
+.IP \fBlb build\fR(1) 4
+alias for all build stages
 .\ FIXME
 
-.SH LOW\-LEVEL COMMANDS (PLUMBING)
+.SH LOW\-LEVEL COMMANDS (PLUMBING) - BUILD STAGE COMPONENTS
 .\ FIXME
 The actual work of live\-build is implemented in the low-level commands, 
called plumbing. They are not supposed to be used by end users, they should 
stick with porcelains as they ensure that all the different plumbing commands 
are executed in the right order. However, if you intend to reuse live\-build 
commands in your own scripts, then the plumbings might be of interest for you.
 .PP
 Note that the interface (set of options and the semantics) to these low\-level 
commands are meant to be a lot more stable than Porcelain level commands. The 
interface to Porcelain commands on the other hand are subject to change in 
order to improve the end user experience.
-.SS Bootstrap commands
-.IP \fBlb_bootstrap_cache\fR(1) 4
-cache bootstrap stage
-.IP \fBlb_bootstrap_debootstrap\fR(1) 4
-bootstrap a Debian system with debootstrap(8)
-.SS Chroot commands
-.IP \fBlb_chroot_apt\fR(1) 4
-manage /etc/apt/apt.conf
-.IP \fBlb_chroot_cache\fR(1) 4
-cache chroot stage
-.IP \fBlb_chroot_debianchroot\fR(1) 4
-manage /etc/debian_chroot
-.IP \fBlb_chroot_devpts\fR(1) 4
-mount /dev/pts
-.IP \fBlb_chroot_dpkg\fR(1) 4
-manage /sbin/dpkg
-.IP \fBlb_chroot_hacks\fR(1) 4
-execute hacks in chroot
-.IP \fBlb_chroot_hostname\fR(1) 4
-manage /bin/hostname
-.IP \fBlb_chroot_hosts\fR(1) 4
-manage /etc/hosts
-.IP \fBlb_chroot_install\-packages\fR(1) 4
-install queued packages into chroot
-.IP 

Bug#774730: Update manpages

2015-01-06 Thread jnqnfe
Damn it, further update, noticed two un-escaped dashes
commit 51e762d10d29eb3c2387f66df89aacf51a577ce0
Author: jnqnfe jnq...@gmail.com
Date:   Tue Jan 6 20:56:05 2015 +

Bring manpages up to date (as far as v4.0.4-1)

diff --git a/manpages/en/lb_installer.1 b/manpages/en/lb_installer.1
new file mode 100644
index 000..c8dec01
--- /dev/null
+++ b/manpages/en/lb_installer.1
@@ -0,0 +1,32 @@
+.TH LIVE\-BUILD 1 2015\-01\-04 5.0~a1-1 Live Systems Project
+
+.SH NAME
+\fBlb installer\fR \- Complete the installer stage
+
+.SH SYNOPSIS
+\fBlb installer\fR [\fIlive\-build options\fR]
+
+.SH DESCRIPTION
+\fBlb installer\fR is a high\-level command (porcelain) of 
\fIlive\-build\fR(7), the live systems tool suite.
+.PP
+\fBlb installer\fR calls all necessary live\-build programs in the correct 
order to complete the installer stage.
+
+.SH OPTIONS
+\fBlb installer\fR has no specific options but understands all generic 
live\-build options. See \fIlive\-build\fR(7) for a complete list of all 
generic live\-build options.
+
+.SH FILES
+.IP \fBnone\fR 4
+
+.SH SEE ALSO
+\fIlive\-build\fR(7)
+.PP
+This program is a part of live\-build.
+
+.SH HOMEPAGE
+More information about live\-build and the Live Systems project can be found 
on the homepage at \fIhttp://live-systems.org/\fR and in the manual at 
\fIhttp://live-systems.org/manual/\fR.
+
+.SH BUGS
+Bugs can be reported by submitting a bugreport for the live\-build package in 
the Bug Tracking System at \fIhttp://bugs.debian.org/\fR or by writing a mail 
to the Live Systems mailing list at \fidebian-l...@lists.debian.org\fR.
+
+.SH AUTHOR
+live\-build was written by Daniel Baumann \fim...@daniel-baumann.ch\fR.
diff --git a/manpages/en/live-build.7 b/manpages/en/live-build.7
index 0b7e9ca..a41be55 100644
--- a/manpages/en/live-build.7
+++ b/manpages/en/live-build.7
@@ -55,153 +55,173 @@ pages for additional documentation.
 .\ FIXME
 We separate the porcelain commands into the main commands and some ancillary 
user utilities.
 .SS Main porcelain commands
-.IP \fBlb_config\fR(1) 4
-create configuration for live\-build
-.IP \fBlb_bootstrap\fR(1) 4
-create the first stage by bootstrapping a basic debian system
-.IP \fBlb_chroot\fR(1) 4
-create the second stage by customizing the chroot
-.IP \fBlb_binary\fR(1) 4
-create the third stage by generating a binary image
-.IP \fBlb_source\fR(1) 4
-create the optional fourth stage by generating a source image
-.IP \fBlb_clean\fR(1) 4
-clean up system build directories
+.IP \fBlb config\fR(1) 4
+creates configuration for live\-build
+.IP \fBlb bootstrap\fR(1) 4
+executes the first build stage, creating (bootstraping) a basic Debian root 
filesystem
+.IP \fBlb chroot\fR(1) 4
+executes the second build stage, building the live OS filesystem
+.IP \fBlb installer\fR(1) 4
+executes the third build stage, obtaining installer components (optional)
+.IP \fBlb binary\fR(1) 4
+executes the fourth build stage, generating a binary image
+.IP \fBlb source\fR(1) 4
+executes the fifth build stage, generating a source image (optional)
+.IP \fBlb clean\fR(1) 4
+cleanes up system build directories
 .SS Ancillary Commands
 .IP \fBlb\fR(1) 4
-generic live\-build wrapper
-.IP \fBlb_build\fR(1) 4
-alias for all stages
-.IP \fBlb_local\fR(1) 4
-helper for using a local live\-build
-.IP \fBlb_testroot\fR(1) 4
-ensure that a system is built as root
+generic live\-build script execution wrapper
+.IP \fBlb build\fR(1) 4
+alias for all build stages
 .\ FIXME
 
-.SH LOW\-LEVEL COMMANDS (PLUMBING)
+.SH LOW\-LEVEL COMMANDS (PLUMBING) - BUILD STAGE COMPONENTS
 .\ FIXME
 The actual work of live\-build is implemented in the low-level commands, 
called plumbing. They are not supposed to be used by end users, they should 
stick with porcelains as they ensure that all the different plumbing commands 
are executed in the right order. However, if you intend to reuse live\-build 
commands in your own scripts, then the plumbings might be of interest for you.
 .PP
 Note that the interface (set of options and the semantics) to these low\-level 
commands are meant to be a lot more stable than Porcelain level commands. The 
interface to Porcelain commands on the other hand are subject to change in 
order to improve the end user experience.
-.SS Bootstrap commands
-.IP \fBlb_bootstrap_cache\fR(1) 4
-cache bootstrap stage
-.IP \fBlb_bootstrap_debootstrap\fR(1) 4
-bootstrap a Debian system with debootstrap(8)
-.SS Chroot commands
-.IP \fBlb_chroot_apt\fR(1) 4
-manage /etc/apt/apt.conf
-.IP \fBlb_chroot_cache\fR(1) 4
-cache chroot stage
-.IP \fBlb_chroot_debianchroot\fR(1) 4
-manage /etc/debian_chroot
-.IP \fBlb_chroot_devpts\fR(1) 4
-mount /dev/pts
-.IP \fBlb_chroot_dpkg\fR(1) 4
-manage /sbin/dpkg
-.IP \fBlb_chroot_hacks\fR(1) 4
-execute hacks in chroot
-.IP \fBlb_chroot_hostname\fR(1) 4
-manage /bin/hostname
-.IP \fBlb_chroot_hosts\fR(1) 4
-manage /etc/hosts
-.IP \fBlb_chroot_install\-packages\fR(1) 4
-install queued packages into chroot
-.IP 

Bug#774730: Update manpages

2015-01-06 Thread jnqnfe
Package: live-build
Version: 4.0.4-1
Tags: patch

Man pages brought fully up to date as far as v4.0.4-1

Note, chroot_ profixed files split into two separate sections to provide
much greater clarity. This also helps pave the way to a new prefix used
for one of these sets in a large set of restructuring work I have been
preparing.
commit d20e8e5d3b1768ff61cdbb14c652e75527845544
Author: jnqnfe jnq...@gmail.com
Date:   Tue Jan 6 20:56:05 2015 +

Bring manpages up to date (as far as v4.0.4-1)

diff --git a/manpages/en/lb_installer.1 b/manpages/en/lb_installer.1
new file mode 100644
index 000..c8dec01
--- /dev/null
+++ b/manpages/en/lb_installer.1
@@ -0,0 +1,32 @@
+.TH LIVE\-BUILD 1 2015\-01\-04 5.0~a1-1 Live Systems Project
+
+.SH NAME
+\fBlb installer\fR \- Complete the installer stage
+
+.SH SYNOPSIS
+\fBlb installer\fR [\fIlive\-build options\fR]
+
+.SH DESCRIPTION
+\fBlb installer\fR is a high\-level command (porcelain) of 
\fIlive\-build\fR(7), the live systems tool suite.
+.PP
+\fBlb installer\fR calls all necessary live\-build programs in the correct 
order to complete the installer stage.
+
+.SH OPTIONS
+\fBlb installer\fR has no specific options but understands all generic 
live\-build options. See \fIlive\-build\fR(7) for a complete list of all 
generic live\-build options.
+
+.SH FILES
+.IP \fBnone\fR 4
+
+.SH SEE ALSO
+\fIlive\-build\fR(7)
+.PP
+This program is a part of live\-build.
+
+.SH HOMEPAGE
+More information about live\-build and the Live Systems project can be found 
on the homepage at \fIhttp://live-systems.org/\fR and in the manual at 
\fIhttp://live-systems.org/manual/\fR.
+
+.SH BUGS
+Bugs can be reported by submitting a bugreport for the live\-build package in 
the Bug Tracking System at \fIhttp://bugs.debian.org/\fR or by writing a mail 
to the Live Systems mailing list at \fidebian-l...@lists.debian.org\fR.
+
+.SH AUTHOR
+live\-build was written by Daniel Baumann \fim...@daniel-baumann.ch\fR.
diff --git a/manpages/en/live-build.7 b/manpages/en/live-build.7
index 0b7e9ca..1af92ce 100644
--- a/manpages/en/live-build.7
+++ b/manpages/en/live-build.7
@@ -55,153 +55,173 @@ pages for additional documentation.
 .\ FIXME
 We separate the porcelain commands into the main commands and some ancillary 
user utilities.
 .SS Main porcelain commands
-.IP \fBlb_config\fR(1) 4
-create configuration for live\-build
-.IP \fBlb_bootstrap\fR(1) 4
-create the first stage by bootstrapping a basic debian system
-.IP \fBlb_chroot\fR(1) 4
-create the second stage by customizing the chroot
-.IP \fBlb_binary\fR(1) 4
-create the third stage by generating a binary image
-.IP \fBlb_source\fR(1) 4
-create the optional fourth stage by generating a source image
-.IP \fBlb_clean\fR(1) 4
-clean up system build directories
+.IP \fBlb config\fR(1) 4
+creates configuration for live\-build
+.IP \fBlb bootstrap\fR(1) 4
+executes the first build stage by bootstrapping a basic debian system
+.IP \fBlb chroot\fR(1) 4
+executes the second build stage by customizing the chroot
+.IP \fBlb installer\fR(1) 4
+executes the third build stage by obtaining installer components (optional)
+.IP \fBlb binary\fR(1) 4
+executes the fourth build stage by generating a binary image
+.IP \fBlb source\fR(1) 4
+executes the fifth build stage by generating a source image (optional)
+.IP \fBlb clean\fR(1) 4
+cleanes up system build directories
 .SS Ancillary Commands
 .IP \fBlb\fR(1) 4
-generic live\-build wrapper
-.IP \fBlb_build\fR(1) 4
-alias for all stages
-.IP \fBlb_local\fR(1) 4
-helper for using a local live\-build
-.IP \fBlb_testroot\fR(1) 4
-ensure that a system is built as root
+generic live\-build script execution wrapper
+.IP \fBlb build\fR(1) 4
+alias for all build stages
 .\ FIXME
 
-.SH LOW\-LEVEL COMMANDS (PLUMBING)
+.SH LOW\-LEVEL COMMANDS (PLUMBING) - BUILD STAGE COMPONENTS
 .\ FIXME
 The actual work of live\-build is implemented in the low-level commands, 
called plumbing. They are not supposed to be used by end users, they should 
stick with porcelains as they ensure that all the different plumbing commands 
are executed in the right order. However, if you intend to reuse live\-build 
commands in your own scripts, then the plumbings might be of interest for you.
 .PP
 Note that the interface (set of options and the semantics) to these low\-level 
commands are meant to be a lot more stable than Porcelain level commands. The 
interface to Porcelain commands on the other hand are subject to change in 
order to improve the end user experience.
-.SS Bootstrap commands
-.IP \fBlb_bootstrap_cache\fR(1) 4
-cache bootstrap stage
-.IP \fBlb_bootstrap_debootstrap\fR(1) 4
-bootstrap a Debian system with debootstrap(8)
-.SS Chroot commands
-.IP \fBlb_chroot_apt\fR(1) 4
-manage /etc/apt/apt.conf
-.IP \fBlb_chroot_cache\fR(1) 4
-cache chroot stage
-.IP \fBlb_chroot_debianchroot\fR(1) 4
-manage /etc/debian_chroot
-.IP \fBlb_chroot_devpts\fR(1) 4
-mount /dev/pts
-.IP \fBlb_chroot_dpkg\fR(1) 4
-manage /sbin/dpkg
-.IP