aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2022-03-23 09:28:48 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2022-03-23 09:28:48 +0200
commit6c9d18b66c94c6ac14c8529690b3b0c700fe05f5 (patch)
tree0149cced680b8dea0099dfc8253c911d68338f7f
parente6b40289f227428901e246149c25ffef18dd4491 (diff)
Document config.config.disfigure
-rw-r--r--doc/manual.cli20
1 files changed, 19 insertions, 1 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index fcee403..910ca0a 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -1705,9 +1705,18 @@ $ b
...
\
-Let's take a look at \c{config.build}:
+To remove the persistent configuration we use the \c{disfigure}
+meta-operation:
\
+$ b disfigure
+\
+
+Let's again configure our project and take a look at \c{config.build}:
+
+\
+$ b configure config.cxx=clang++ config.cxx.coptions=-g
+
$ cat build/config.build
config.cxx = clang++
@@ -1742,6 +1751,15 @@ Any variable value specified on the command line overrides those specified in
the \c{buildfiles}. As a result, \c{config.cxx} was updated while the value of
\c{config.cxx.coptions} was preserved.
+\N|To revert a configuration variable to its default value, list its name in
+the special \c{config.config.disfigure} variable. For example:
+
+\
+$ b configure config.config.disfigure=config.cxx
+\
+
+|
+
Command line variable overrides are also handy to adjust the configuration for
a single build system invocation. For example, let's say we want to quickly
check that our project builds with optimization but without permanently