From 630dc4ccf3207f7cdd5b410582e1e572081b80e8 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Sat, 16 Dec 2017 09:43:38 +0200 Subject: Add support for structured result output (--structured-result) --- build2/b.cli | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) (limited to 'build2/b.cli') diff --git a/build2/b.cli b/build2/b.cli index 724a676..d7634c0 100644 --- a/build2/b.cli +++ b/build2/b.cli @@ -21,7 +21,7 @@ namespace build2 \h|DESCRIPTION| - The \cb{build2} driver performs a set of meta-operations on operations on + The \cb{build2} driver executes a set of meta-operations on operations on targets according to the build specification, or for short. This process can be controlled by specifying driver and build system . @@ -424,6 +424,30 @@ namespace build2 \c{-j 0} for default concurrency)." } + bool --structured-result + { + "Write the result of execution in a structured form. In this mode, + instead of printing to \cb{STDERR} diagnostics messages about the + outcome of executing actions on targets, the driver writes to + \cb{STDOUT} a structured result description one line per the + buildspec action/target pair. Each line has the following format: + + \c{\i{state} \i{meta-operation} \i{operation} \i{target}} + + Where \ci{state} can be one of \cb{unchanged}, \cb{changed}, or + \cb{failed}. If the action is a pre or post operation, then the + outer operation is specified in parenthesis. For example: + + \ + unchanged perform update(test) dir{./} + changed perform test dir{./} + \ + + Currently only the \cb{perform} meta-operation supports the structured + result output. + " + } + bool --match-only { "Match the rules but do not execute the operation. This mode is primarily -- cgit v1.1