summaryrefslogtreecommitdiff
path: root/doc/cli.1
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2010-06-02 19:00:38 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2010-06-02 19:00:38 +0200
commit840f2fae3995a3e263801ad07d1285d35ddd9485 (patch)
treeafbc65a206b3b45c25cb2afb3fc18040ba6b02c5 /doc/cli.1
parent5653d0317e60cea2fb9bb2eed464cb6f024879cb (diff)
Update description of the --options-file option
Diffstat (limited to 'doc/cli.1')
-rw-r--r--doc/cli.121
1 files changed, 16 insertions, 5 deletions
diff --git a/doc/cli.1 b/doc/cli.1
index b42652e..739b845 100644
--- a/doc/cli.1
+++ b/doc/cli.1
@@ -73,6 +73,10 @@ Write the generated files to \fIdir\fP instead of the current directory\.
.IP "\fB--generate-modifier\fP"
Generate option value modifiers in addition to accessors\.
+.IP "\fB--generate-specifier\fP"
+Generate functions for determining whether the option was specified on the
+command line\.
+
.IP "\fB--generate-file-scanner\fP"
Generate the argv_file_scanner implementation\. This scanner is capable of
reading command line arguments from the argv array as well as files
@@ -181,11 +185,18 @@ is used instead\. All C++ keywords are already in this list\.
.IP "\fB--options-file\fP \fIfile\fP"
Read additional options from \fIfile\fP with each option appearing on a
separate line optionally followed by space and an option value\. Empty lines
-and lines starting with \fB#\fP are ignored\. The semantics of providing
-options in a file is equivalent to providing the same set of options in the
-same order on the command line at the point where the \fB--options-file\fP
-option is specified except that shell escaping and quoting is not required\.
-Repeat this option to specify more than one options files\.
+and lines starting with \fB#\fP are ignored\. Option values can be enclosed
+in double quotes (\fB""\fP) to preserve leading and trailing whitespaces as
+well as to specify empty values\. If the value itself contains trailing or
+leading double quote, enclose it with an extra pair of double quotes, for
+example \fB""x""\fP\. Non-leading and non-trailing quotes are interpreted as
+being part of the option value\.
+
+The semantics of providing options in a file is equivalent to providing the
+same set of options in the same order on the command line at the point where
+the \fB--options-file\fP option is specified except that the shell escaping
+and quoting is not required\. Repeat this option to specify more than one
+options files\.
.\"
.\" DIAGNOSTICS