diff options
| author | Boris Kolpackov <boris@codesynthesis.com> | 2017-03-31 12:17:14 +0200 |
|---|---|---|
| committer | Boris Kolpackov <boris@codesynthesis.com> | 2017-03-31 12:17:14 +0200 |
| commit | 2ae123ce8e8a874ada7e8c776abfc0742d862277 (patch) | |
| tree | f41c9d6ffc8c1e52d0a1742dfe9910ae633b28d5 | |
| parent | ec9f5f3a59dd30573524c453b04807797d7eb7d7 (diff) | |
Various manual updates (quoting, buildtab)
| -rw-r--r-- | doc/manual.cli | 26 |
1 files changed, 21 insertions, 5 deletions
diff --git a/doc/manual.cli b/doc/manual.cli index 7835163..ec61e74 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -250,7 +250,22 @@ build configuration to use for building the package. \li|\n\c{config: <config-vars>}\n - Additional build system configuration variables.|| + Additional build system configuration variables. + + A single level of quotes (either single or double) is removed in each + variable before being passed to \c{bpkg}. For example, the following value: + + \ + config: config.cc.coptions=\"-O3 -stdlib='libc++'\" + \ + + Will be passed to \c{bpkg} as the following (single) argument: + + \ + config.cc.coptions=-O3 -stdlib='libc++' + \ + + || \h#arch-result-manifest|Result Manifest| @@ -470,7 +485,7 @@ exec \"$2\" --build \"$3\" cc config.c=gcc-6 A \c{bbot} controller that issues own build tasks maps available build machines (as reported by agents) to \i{build configurations} according to the -\c{conftab} configuration file. Blank lines and lines that start with \c{#} +\c{buildtab} configuration file. Blank lines and lines that start with \c{#} are ignored. All other lines in this file have the following format: \ @@ -479,9 +494,10 @@ are ignored. All other lines in this file have the following format: Where \c{<machine-name-pattern>} is filesystem wildcard pattern that is matched against available machine names, \c{<config-name>} is the -configuration name, optional \c{<target>} is the build target, and -optional \c{<config-vars>} is a list of additional build system configuration -variables. The matched machine name, the target, and configuration variables +configuration name, optional \c{<target>} is the build target, and optional +\c{<config-vars>} is a list of additional build system configuration variables +with the same quoting semantics as in the \c{config} value in the build task +manifest. The matched machine name, the target, and configuration variables are included into the build task manifest. Note that each machine name is matched against every pattern and all the |