diff options
| author | Boris Kolpackov <boris@codesynthesis.com> | 2016-02-12 10:58:26 +0200 |
|---|---|---|
| committer | Boris Kolpackov <boris@codesynthesis.com> | 2016-02-12 10:58:26 +0200 |
| commit | 840354da0c54a5036c68cc75eb069d19ac36d0e5 (patch) | |
| tree | bfe3aa4bf8eb8d9b6f63c4ad42aedcf5ca32aec0 /build2/b.cli | |
| parent | 83ea171c180e0bc0ece8f4070489c1ee10a99e5e (diff) | |
Support specifying options/variables/buildspec in any order
Diffstat (limited to 'build2/b.cli')
| -rw-r--r-- | build2/b.cli | 19 |
1 files changed, 13 insertions, 6 deletions
diff --git a/build2/b.cli b/build2/b.cli index 2657872..84daee9 100644 --- a/build2/b.cli +++ b/build2/b.cli @@ -1,4 +1,4 @@ -// file : build2/options.cli +// file : build2/b.cli // copyright : Copyright (c) 2014-2016 Code Synthesis Ltd // license : MIT; see accompanying LICENSE file @@ -23,8 +23,14 @@ namespace build2 The \cb{build2} driver performs a set of meta-operations on operations on targets according to the build specification, or <buildspec> for short. - Before <buildspec> (but after <options>) you can set one or more - \cb{build2} <variables>." + This process can be controlled by specifying driver <options> and build + system <variables>. + + Note that <options>, <variables>, and <buildspec> fragments can be + specified in any order. To avoid treating an argument that starts with + \cb{'-'} as an option, add the \cb{'--'} separator. To avoid treating an + argument that contains \cb{'='} as a variable, add the second \cb{'--'} + separator." } // For usage it's nice to see the list of options on the first page. So @@ -116,7 +122,8 @@ namespace build2 b 'clean(foo-out/exe{foo})' # no need to specify src_base \ - \cb{build2} has the following built-in and pre-defined meta-operations: + The build system has the following built-in and pre-defined + meta-operations: \dl| @@ -141,7 +148,7 @@ namespace build2 Prepare a distribution containing all files necessary to perform all operations in a project. Implemented by the \cb{dist} module.|| - \cb{build2} has the following built-in and pre-defined operations: + The build system has the following built-in and pre-defined operations: \dl| @@ -163,7 +170,7 @@ namespace build2 Install a target. Performs \cb{update} as a pre-operation. Implemented by the \cb{install} module.|| - The ability to specify \c{build2} variables as part of the command line + The ability to specify \cb{build2} variables as part of the command line is normally used to pass configuration values, for example: \ |