aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2016-01-31 11:12:47 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2016-01-31 11:12:47 +0200
commit4715996fbd3ac4f333ec45ab3ef38b54f82e9bc9 (patch)
tree9e1b9f8a35c82fe354580c547d94b8185cce3f6f
parent1d8e01cdff59aac7b154d6506bc02e85d880228b (diff)
Don't put extended description into usage, like in bpkg
-rw-r--r--build2/b.cli21
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 \