aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--bpkg/common-options.cli19
-rw-r--r--bpkg/diagnostics2
2 files changed, 17 insertions, 4 deletions
diff --git a/bpkg/common-options.cli b/bpkg/common-options.cli
index 8088ccc..04c67e3 100644
--- a/bpkg/common-options.cli
+++ b/bpkg/common-options.cli
@@ -2,7 +2,6 @@
// copyright : Copyright (c) 2014-2015 Code Synthesis Ltd
// license : MIT; see accompanying LICENSE file
-include <vector>;
include <bpkg/types>;
namespace bpkg
@@ -25,8 +24,22 @@ namespace bpkg
{
"<level>",
"Set the diagnostics verbosity to <level> between 0 (disabled) and
- 6 (lots of information). The default is 1. @@ Need to document
- further."
+ 6 (lots of information). The default is 1. The following additional
+ classes of diagnostics are produced at each level:
+
+ \ol|
+
+ \li|high-level information messages|
+
+ \li|essential underlying commands that are being executed|
+
+ \li|all underlying commands that are being executed|
+
+ \li|information that could be helpful to the user|
+
+ \li|information that could be helpful to the developer|
+
+ \li|even more detailed information||"
};
path --fetch
diff --git a/bpkg/diagnostics b/bpkg/diagnostics
index 68aac63..3f95ffe 100644
--- a/bpkg/diagnostics
+++ b/bpkg/diagnostics
@@ -54,7 +54,7 @@ namespace bpkg
print_process (args.data (), args.size ());
}
- // Verbosity level.
+ // Verbosity level. Update documentation for --verbose if changing.
//
// 0 - disabled
// 1 - high-level information messages