diff options
author | Boris Kolpackov <boris@codesynthesis.com> | 2019-04-05 09:41:18 +0200 |
---|---|---|
committer | Boris Kolpackov <boris@codesynthesis.com> | 2019-04-08 12:51:00 +0200 |
commit | 01d848149c22a69a62eada5fedc2406c54d95ba8 (patch) | |
tree | 66a3b59619f32f7f7244200f810f4d4cc9115ca5 /build2/b.cli | |
parent | 3392226a2248b5cd93a899afb986917ce9e7ad74 (diff) |
Support for --dry-run|-n mode, perform update part
Diffstat (limited to 'build2/b.cli')
-rw-r--r-- | build2/b.cli | 65 |
1 files changed, 38 insertions, 27 deletions
diff --git a/build2/b.cli b/build2/b.cli index 35d5e2e..03de044 100644 --- a/build2/b.cli +++ b/build2/b.cli @@ -14,15 +14,15 @@ namespace build2 { "<options> <variables> - <build-spec> <meta-operation> <operation> <target> <parameters>", + <buildspec> <meta-operation> <operation> <target> <parameters>", "\h|SYNOPSIS| \c{\b{b --help}\n \b{b --version}\n - \b{b} [<options>] [<variables>] [<build-spec>]} + \b{b} [<options>] [<variables>] [<buildspec>]} - \c{<build-spec> = <meta-operation>\b{(}<operation>\b{(}<target>...[\b{,}<parameters>]\b{)}...\b{)}...} + \c{<buildspec> = <meta-operation>\b{(}<operation>\b{(}<target>...[\b{,}<parameters>]\b{)}...\b{)}...} \h|DESCRIPTION| @@ -31,7 +31,7 @@ namespace build2 This process can be controlled by specifying driver <options> and build system <variables>. - Note that <options>, <variables>, and <build-spec> fragments can be + 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{'--'} @@ -401,18 +401,6 @@ namespace build2 \cb{--verbose 3}." } - bool --progress - { - "Display build progress. If printing to a terminal the progress is - displayed by default for low verbosity levels. Use \cb{--no-progress} - to suppress." - } - - bool --no-progress - { - "Don't display build progress." - } - bool --quiet|-q { "Run quietly, only printing error messages. This is equivalent to @@ -456,6 +444,18 @@ namespace build2 state after multiple phases." } + bool --progress + { + "Display build progress. If printing to a terminal the progress is + displayed by default for low verbosity levels. Use \cb{--no-progress} + to suppress." + } + + bool --no-progress + { + "Don't display build progress." + } + size_t --jobs|-j { "<num>", @@ -508,17 +508,21 @@ namespace build2 example \cb{-j\ 0} for default concurrency)." } - bool --mtime-check + bool --dry-run|-n { - "Perform file modification time sanity checks. These checks can be - helpful in diagnosing spurious rebuilds and are enabled by default - for the staged version of the build system. Use \cb{--no-mtime-check} - to disable." + "Print commands without actually executing them. Note that commands + that are required to create an accurate build state will still be + executed and the extracted auxiliary dependency information saved. In + other words, this is not the \i{\"don't touch the filesystem\"} mode + but rather \i{\"do minimum amount of work to show what needs to be + done\"}. Note also that only the \cb{perform} meta-operation supports + this mode." } - bool --no-mtime-check + bool --match-only { - "Don't perform file modification time sanity checks." + "Match the rules but do not execute the operation. This mode is primarily + useful for profiling." } bool --structured-result @@ -540,15 +544,22 @@ namespace build2 changed perform test /tmp/dir{hello/} \ - Currently only the \cb{perform} meta-operation supports the structured + Note that only the \cb{perform} meta-operation supports the structured result output. " } - bool --match-only + bool --mtime-check { - "Match the rules but do not execute the operation. This mode is primarily - useful for profiling." + "Perform file modification time sanity checks. These checks can be + helpful in diagnosing spurious rebuilds and are enabled by default + for the staged version of the build system. Use \cb{--no-mtime-check} + to disable." + } + + bool --no-mtime-check + { + "Don't perform file modification time sanity checks." } bool --no-column |