summaryrefslogtreecommitdiff
path: root/manpages
diff options
context:
space:
mode:
authorLyndon Brown <jnqnfe@gmail.com>2020-04-28 18:32:36 +0100
committerRaphaƫl Hertzog <hertzog@debian.org>2020-05-01 08:57:44 +0000
commit61aa3239c5c93d6d7bdc5b9b6a407f400799779b (patch)
treeaaeebe31a1b9924f1f8e95c8fb4b2fa2ae31466b /manpages
parent72321c2b9be15c68567efbfaca5ee24590a3a80a (diff)
downloadvyos-live-build-61aa3239c5c93d6d7bdc5b9b6a407f400799779b.tar.gz
vyos-live-build-61aa3239c5c93d6d7bdc5b9b6a407f400799779b.zip
config: remove junk config loading code
support for this has not existed since v2.0~a24-1 !! until 4d22ca948ad3def3f98fd89d32bf2ba8209460fd (v2.0~a24-1), `PROGRAM` was defined as `PROGRAM="$(basename ${0})"`. then this commit simply got rid of the definition. it then flipped back and forth a bit in a few ways, but always sticking to a simple fixed "live-build" type string after that commit, as it has been ever since. the code removed here has thus been junk since then, and the documentation corrected here out of date since then. the checking of `LB_CONFIG` is also possibly junk, but i know too little about it. it was introduced in v1.0~a43-1 in commit 705a4178e75ffc190acf2fa914a6cd1519fdae87 with a changelog entry of "Centraly evaluate LH_CONFIG for custom configuration file." Gbp-Dch: Short
Diffstat (limited to 'manpages')
-rw-r--r--manpages/en/live-build.76
1 files changed, 2 insertions, 4 deletions
diff --git a/manpages/en/live-build.7 b/manpages/en/live-build.7
index 3ede115d8..1920f6744 100644
--- a/manpages/en/live-build.7
+++ b/manpages/en/live-build.7
@@ -213,13 +213,11 @@ manages the /usr/sbin/policy\-rc.d file
manages configuration of dpkg to use a tmpfs filesystem
.SH CONFIG FILES
-Many live\-build commands make use of files in the \fIconfig/\fR directory to control what they do. Besides the common \fIconfig/common\fR, which is used by all live\-build commands, some additional files can be used to configure the behavior of specific live\-build commands. These files are typically named config/stage or config/stage_helper (where "stage" of course, is replaced with the name of the stage that they belong to, and "helper" with the name of the helper).
-.PP
-For example, lb bootstrap_debootstrap uses files named config/bootstrap and config/bootstrap_debootstrap to read the options it will use. See the man pages of individual commands for details about the names and formats of the files they use. Generally, these files contain variables with values assigned, one variable per line. Some programs in live\-build use pairs of values or slightly more complicated variable assignments.
+Many live\-build commands make use of files in the \fIconfig/\fR directory to control what they do. Besides the common \fIconfig/common\fR, which is used by all live\-build commands, some additional files can be used to configure the behavior of specific live\-build commands. These files are typically named config/stage (where "stage" of course, is replaced with the name of the stage that they belong to).
.PP
Note that live\-build will respect environment variables which are present in the context of the shell it is running. If variables can be read from config files, then they override environment variables, and if command line options are used, they override values from config files. If no value for a given variable can be found and thus is unset, live\-build will automatically set it to the default value.
.PP
-In some rare cases, you may want to have different versions of these files for different architectures or distributions. If files named config/stage.arch or config/stage_helper.arch, and config/stage.dist or config/stage_helper.dist exist, where "arch" is the same as the output of "dpkg \-\-print\-architecture" and "dist" is the same as the codename of the target distribution, then they will be used in preference to other, more general files.
+In some rare cases, you may want to have different versions of these files for different architectures or distributions. If files named config/stage.arch and config/stage.dist exist, where "arch" is the same as the output of "dpkg \-\-print\-architecture" and "dist" is the same as the codename of the target distribution, then they will be used in preference to other, more general files.
.PP
All config files are shell scripts which are sourced by a live\-build program. That means they have to follow the normal shell syntax. You can also put comments in these files; lines beginning with "#" are ignored.