diff options
-rw-r--r-- | doc/manual.cli | 20 |
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 |