From 74dfffa9df361e35a5910f1cf5b1734571bbef91 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Thu, 10 Dec 2009 10:50:23 +0200
Subject: Allows additional options to be provided in files (--options-file)

Implemented using the new argv_file_scanner scanner implementation.
---
 doc/cli.1     |  9 +++++++++
 doc/cli.xhtml | 10 ++++++++++
 2 files changed, 19 insertions(+)

(limited to 'doc')

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>
 
-- 
cgit v1.1