X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=doc%2Fman%2Fcommon-cmd-params-format.txt;fp=doc%2Fman%2Fcommon-cmd-params-format.txt;h=1e84571cfdb8676721289fecd988fefb0a64edbb;hb=e70712b34fcae860414660c6b10451f57b50c25d;hp=c8cefc0e8cd00db728eeda592387a6631e235dd9;hpb=0713ec72ea9f82718c4d54324d6f80eec9c357e0;p=babeltrace.git

diff --git a/doc/man/common-cmd-params-format.txt b/doc/man/common-cmd-params-format.txt
index c8cefc0e..1e84571c 100644
--- 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:
@@ -31,22 +29,29 @@ list of `NAME=VALUE` assignments:
 
 * Double-quoted string (accepts escape characters).
 
-* Array, formatted as an opening `[`, a list of comma-separated values
-  (as described by the current list) and a closing `]`.
+* Array, formatted as an opening `[`, a comma-separated list of 'VALUE',
+  and a closing `]`.
 
-You may put whitespaces around the individual `=` (assignment) and `,`
-(separator) characters.
+* 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"]
 ----
-babeltrace2 ... --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, "2", 3]'
+--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.