summaryrefslogtreecommitdiff
path: root/manpages
diff options
context:
space:
mode:
authorLyndon Brown <jnqnfe@gmail.com>2020-02-22 08:47:05 +0000
committerRaphaƫl Hertzog <hertzog@debian.org>2020-03-05 11:28:19 +0000
commit28d2e88ba87eae24de1f79a4b2901619af463d5e (patch)
tree154fdfd3e670fc64fe683ccd336cec7fae2e982c /manpages
parent4037226376946be38e37dbe5c78c1ca61eec0ac6 (diff)
downloadvyos-live-build-28d2e88ba87eae24de1f79a4b2901619af463d5e.tar.gz
vyos-live-build-28d2e88ba87eae24de1f79a4b2901619af463d5e.zip
manpage: separate first and secondary build commands
`lb build` is a top level command and the one most users will want. listing the secondary component build stages alongside it just confuses things. here we clarify things by moving the second-level build stages to a separate list. Gbp-Dch: Short
Diffstat (limited to 'manpages')
-rw-r--r--manpages/en/live-build.719
1 files changed, 12 insertions, 7 deletions
diff --git a/manpages/en/live-build.7 b/manpages/en/live-build.7
index 45c27e9b8..4648b82bd 100644
--- a/manpages/en/live-build.7
+++ b/manpages/en/live-build.7
@@ -57,6 +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 build\fR(1)" 4
+executes the build process (by executing all of the secondary level build stages in sequence)
+.IP "\fBlb clean\fR(1)" 4
+cleans up system build directories
+.SS Ancillary Commands
+.IP "\fBlb\fR(1)" 4
+generic live\-build script execution wrapper
+.\" FIXME
+
+.SH SECONDARY\-LEVEL BUILD COMMANDS (PORCELAIN)
+.\" FIXME
+The following are the commands that execute each major stage of the build process, in their necessary order of execution. Normally a user might just execute the higher level \fBlb build\fR(1) command.
.IP "\fBlb bootstrap\fR(1)" 4
executes the first build stage, creating (bootstraping) a basic Debian root filesystem
.IP "\fBlb chroot\fR(1)" 4
@@ -67,13 +79,6 @@ executes the third build stage, obtaining installer components (optional)
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
-cleans up system build directories
-.SS Ancillary Commands
-.IP "\fBlb\fR(1)" 4
-generic live\-build script execution wrapper
-.IP "\fBlb build\fR(1)" 4
-alias for all build stages
.\" FIXME
.SH LOW\-LEVEL COMMANDS (PLUMBING) - BUILD STAGE COMPONENTS