diff options
| author | Boris Kolpackov <boris@codesynthesis.com> | 2016-01-31 11:12:47 +0200 |
|---|---|---|
| committer | Boris Kolpackov <boris@codesynthesis.com> | 2016-01-31 11:12:47 +0200 |
| commit | 4715996fbd3ac4f333ec45ab3ef38b54f82e9bc9 (patch) | |
| tree | 9e1b9f8a35c82fe354580c547d94b8185cce3f6f | |
| parent | 1d8e01cdff59aac7b154d6506bc02e85d880228b (diff) | |
Don't put extended description into usage, like in bpkg
| -rw-r--r-- | build2/b.cli | 21 |
1 files changed, 15 insertions, 6 deletions
diff --git a/build2/b.cli b/build2/b.cli index 414c3c1..2657872 100644 --- a/build2/b.cli +++ b/build2/b.cli @@ -11,8 +11,7 @@ include <build2/types>; namespace build2 { { - "<options> <variables> <buildspec> - <meta-operation> <operation> <target> <src-base>", + "<options> <variables> <buildspec>", "\h|SYNOPSIS| @@ -24,7 +23,18 @@ 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. - The buildspec has the following form: + Before <buildspec> (but after <options>) you can set one or more + \cb{build2} <variables>." + } + + // For usage it's nice to see the list of options on the first page. So + // let's not put this "extended" description into usage. + // + { + "<meta-operation> <operation> <target> <src-base>", + "", + + "The buildspec has the following form: \c{<meta-operation>(<operation>...(<target>...))...} @@ -153,9 +163,8 @@ namespace build2 Install a target. Performs \cb{update} as a pre-operation. Implemented by the \cb{install} module.|| - Before <buildspec> (but after <options>) you can set one or more - \cb{build2} <variables>. This is normally used to specify the - configuration values, for example: + The ability to specify \c{build2} variables as part of the command line + is normally used to pass configuration values, for example: \ b config.cxx=clang++ config.cxx.coptions=-O3 \ |