[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#774734: Add init stage to manpages



Package: live-build
Version: 5.0~a2-1
Tags: patch

The attached patch updates manpages with info regarding the new init
build stage that has been added by my bug #718225 solution.

This must be applied after the bug #774730 manpage update, and should
also be applied after my bug #718225 solution.
commit 988330e06a5c3efe2f308a4af50a84654b51a10e
Author: jnqnfe <jnqnfe@gmail.com>
Date:   Tue Jan 6 21:40:49 2015 +0000

    Update manpages with new init build stage info
    
    This stage was added by the bug #718225 solution provided by jnqnfe <jnqnfe@gmail.com>

diff --git a/manpages/en/lb_init.1 b/manpages/en/lb_init.1
new file mode 100644
index 0000000..05ff5cf
--- /dev/null
+++ b/manpages/en/lb_init.1
@@ -0,0 +1,32 @@
+.TH LIVE\-BUILD 1 2015\-01\-04 5.0~a1-1 "Live Systems Project"
+
+.SH NAME
+\fBlb init\fR \- Complete the init stage
+
+.SH SYNOPSIS
+\fBlb init\fR [\fIlive\-build options\fR]
+
+.SH DESCRIPTION
+\fBlb init\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite.
+.PP
+\fBlb init\fR calls all necessary live\-build programs in the correct order to complete the init stage.
+
+.SH OPTIONS
+\fBlb init\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-live@lists.debian.org\fR>.
+
+.SH AUTHOR
+live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>.
diff --git a/manpages/en/live-build.7 b/manpages/en/live-build.7
index a41be55..3355c14 100644
--- a/manpages/en/live-build.7
+++ b/manpages/en/live-build.7
@@ -57,16 +57,18 @@ We separate the porcelain commands into the main commands and some ancillary use
 .SS Main porcelain commands
 .IP "\fBlb config\fR(1)" 4
 creates configuration for live\-build
+.IP "\fBlb init\fR(1)" 4
+executes the first build stage, initialising things for a new build process
 .IP "\fBlb bootstrap\fR(1)" 4
-executes the first build stage, creating (bootstraping) a basic Debian root filesystem
+executes the second 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
+executes the third build stage, building the live OS filesystem
 .IP "\fBlb installer\fR(1)" 4
-executes the third build stage, obtaining installer components (optional)
+executes the fourth build stage, obtaining installer components (optional)
 .IP "\fBlb binary\fR(1)" 4
-executes the fourth build stage, generating a binary image
+executes the fifth build stage, generating a binary image
 .IP "\fBlb source\fR(1)" 4
-executes the fifth build stage, generating a source image (optional)
+executes the sixth build stage, generating a source image (optional)
 .IP "\fBlb clean\fR(1)" 4
 cleanes up system build directories
 .SS Ancillary Commands
@@ -81,6 +83,9 @@ alias for all build stages
 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 Init stage specific commands
+.IP "\fBlb init_flush\-cache\fR(1)" 4
+flushes out certain previously cached data if requested (by way of configuration options)
 .SS Bootstrap stage specific commands
 .IP "\fBlb bootstrap_archive\-keys\fR(1)" 4
 installs derivative distribution archive keys into bootstrap directory (currently applies to progress-linux builds only)

Reply to: