Allows additional options to be provided in files (--options-file)

Implemented using the new argv_file_scanner scanner implementation.

2 files changed, 19 insertions, 0 deletions

diff --git a/doc/cli.1 b/doc/cli.1
index 0a2021f..8daec4e 100644
--- a/doc/cli.1
+++ b/doc/cli.1
@@ -178,6 +178,15 @@ Add \fIname\fP with an optional \fIrep\fP replacement to the list of names
 that should not be used as identifiers\. If provided, the replacement name
 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\.
+
 .\"
 .\" DIAGNOSTICS
 .\"
diff --git a/doc/cli.xhtml b/doc/cli.xhtml
index 3389c77..3a09c96 100644
--- a/doc/cli.xhtml
+++ b/doc/cli.xhtml
@@ -204,6 +204,16 @@
   that should not be used as identifiers. If provided, the replacement name is
   used instead. All C++ keywords are already in this list.</dd>
 
+  <dt><code><b>--options-file</b></code> <i>file</i></dt>
+  <dd>Read additional options from <i>file</i> with each option appearing on a
+  separate line optionally followed by space and an option value. Empty lines
+  and lines starting with <code><b>#</b></code> 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
+  <code><b>--options-file</b></code> option is specified except that shell
+  escaping and quoting is not required. Repeat this option to specify more
+  than one options files.</dd>
+
 </dl>
   <h1>DIAGNOSTICS</h1>