Replace `diamon.org/babeltrace` with `babeltrace.org`

[babeltrace.git] / doc / man / common-cmd-params-format.txt

diff --git a/doc/man/common-cmd-params-format.txt b/doc/man/common-cmd-params-format.txt
index c3ee8d4fe7e0846bedcbc1384752655035eb1985..1e84571cfdb8676721289fecd988fefb0a64edbb 100644 (file)
--- a/doc/man/common-cmd-params-format.txt
+++ b/doc/man/common-cmd-params-format.txt
@@ -1,14 +1,12 @@
-[[params-fmt]]
-Parameters format
-~~~~~~~~~~~~~~~~~
-The format of the 'PARAMS' option's argument is a comma-separated
-list of `NAME=VALUE` assignments:
+The format of 'PARAMS' is a comma-separated list of 'NAME'='VALUE'
+assignments:
 
 [verse]
 'NAME'='VALUE'[,'NAME'='VALUE']...
 
 'NAME'::
-    Parameter name (C{nbsp}identifier plus the `:`, `.`, and `-` characters).
+    Parameter name (C~identifier plus the `:`, `.`, and `-`
+    characters).
 
 'VALUE'::
     One of:
@@ -21,7 +19,7 @@ list of `NAME=VALUE` assignments:
 * `false`, `FALSE`, `no`, `NO`: false boolean value.
 
 * Binary (`0b` prefix), octal (`0` prefix), decimal, or hexadecimal
-  (`0x` prefix) signed 64-bit integer.
+  (`0x` prefix) unsigned (with `+` prefix) or signed 64-bit integer.
 
 * Double precision floating point number (scientific notation is
   accepted).
@@ -31,18 +29,29 @@ list of `NAME=VALUE` assignments:
 
 * Double-quoted string (accepts escape characters).
 
-You may put whitespaces around the individual `=` (assignment) and `,`
-(separator) characters.
+* Array, formatted as an opening `[`, a comma-separated list of 'VALUE',
+  and a closing `]`.
+
+* Map, formatted as an opening `{`, a comma-separated list of
+  'NAME'='VALUE' assignments, and a closing `}`.
+
+You may put whitespaces around the individual `=` (assignment), `,`
+(separator), `[` (array beginning), `]` (array end), `{` (map
+beginning), and `}` (map end) characters.
 --
 
 Example:
 
+[role="term"]
 ----
-babeltrace ... --params='many=null, fresh=yes, condition=false,
-                         squirrel=-782329, observe=3.14,
-                         simple=beef, needs-quotes="some string",
-                         escape.chars-are:allowed="a \" quote"'
+--params='many=null, fresh=yes, condition=false, squirrel=-782329,
+          play=+23, observe=3.14, simple=beef,
+          needs-quotes="some string",
+          escape.chars-are:allowed="a \" quote",
+          things=[1, "hello", 2.71828],
+          frog={slow=2, bath=[bike, 23], blind=NO}'
 ----
 
 IMPORTANT: Like in the example above, make sure to single-quote the
-whole argument when you run this command from a shell.
+whole argument when you run this command from a shell, as it can contain
+many special characters.