diff options
Diffstat (limited to 'doc/html/program_options/howto.html')
-rw-r--r--[-rwxr-xr-x] | doc/html/program_options/howto.html | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/doc/html/program_options/howto.html b/doc/html/program_options/howto.html index c9b870bcf6..a94e5dc16a 100755..100644 --- a/doc/html/program_options/howto.html +++ b/doc/html/program_options/howto.html @@ -26,24 +26,24 @@ <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="program_options.howto"></a>How To</h2></div></div></div> <div class="toc"><dl> -<dt><span class="section"><a href="howto.html#id2501876">Non-conventional Syntax</a></span></dt> -<dt><span class="section"><a href="howto.html#id2501928">Response Files</a></span></dt> -<dt><span class="section"><a href="howto.html#id2502006">Winmain Command Line</a></span></dt> -<dt><span class="section"><a href="howto.html#id2502052">Option Groups and Hidden Options</a></span></dt> -<dt><span class="section"><a href="howto.html#id2502184">Custom Validators</a></span></dt> -<dt><span class="section"><a href="howto.html#id2502257">Unicode Support</a></span></dt> -<dt><span class="section"><a href="howto.html#id2502434">Allowing Unknown Options</a></span></dt> +<dt><span class="section"><a href="howto.html#id2549735">Non-conventional Syntax</a></span></dt> +<dt><span class="section"><a href="howto.html#id2549787">Response Files</a></span></dt> +<dt><span class="section"><a href="howto.html#id2549865">Winmain Command Line</a></span></dt> +<dt><span class="section"><a href="howto.html#id2549911">Option Groups and Hidden Options</a></span></dt> +<dt><span class="section"><a href="howto.html#id2550043">Custom Validators</a></span></dt> +<dt><span class="section"><a href="howto.html#id2550116">Unicode Support</a></span></dt> +<dt><span class="section"><a href="howto.html#id2550293">Allowing Unknown Options</a></span></dt> </dl></div> <p>This section describes how the library can be used in specific situations.</p> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2501876"></a>Non-conventional Syntax</h3></div></div></div> +<a name="id2549735"></a>Non-conventional Syntax</h3></div></div></div> <p>Sometimes, standard command line syntaxes are not enough. For example, the gcc compiler has "-frtti" and -fno-rtti" options, and this syntax is not directly supported. </p> -<a class="indexterm" name="id2501888"></a><p>For such cases, the library allows the user to provide an +<a class="indexterm" name="id2549747"></a><p>For such cases, the library allows the user to provide an <em class="firstterm">additional parser</em> -- a function which will be called on each command line element, before any processing by the library. If the additional parser recognises the syntax, it returns the option name and @@ -80,8 +80,8 @@ store(command_line_parser(ac, av).options(desc).extra_parser(reg_foo) </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2501928"></a>Response Files</h3></div></div></div> -<a class="indexterm" name="id2501934"></a><p>Some operating system have very low limits of the command line +<a name="id2549787"></a>Response Files</h3></div></div></div> +<a class="indexterm" name="id2549793"></a><p>Some operating system have very low limits of the command line length. The common way to work around those limitations is using <em class="firstterm">response files</em>. A response file is just a configuration file which uses the same syntax as the command line. If @@ -148,7 +148,7 @@ if (vm.count("response-file")) { </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2502006"></a>Winmain Command Line</h3></div></div></div> +<a name="id2549865"></a>Winmain Command Line</h3></div></div></div> <p>On the Windows operating system, GUI applications receive the command line as a single string, not split into elements. For that reason, the command line parser cannot be used directly. At least on some @@ -170,7 +170,7 @@ store(command_line_parser(args).options(desc).run(), vm); </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2502052"></a>Option Groups and Hidden Options</h3></div></div></div> +<a name="id2549911"></a>Option Groups and Hidden Options</h3></div></div></div> <p>Having a single instance of the <code class="computeroutput"><a class="link" href="../boost/program_options/options_description.html" title="Class options_description">options_description</a></code> class with all the program's options can be problematic: </p> @@ -269,7 +269,7 @@ if (vm.count("num-threads")) { </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2502184"></a>Custom Validators</h3></div></div></div> +<a name="id2550043"></a>Custom Validators</h3></div></div></div> <p>By default, the conversion of option's value from string into C++ type is done using iostreams, which sometimes is not convenient. The library allows the user to customize the conversion for specific @@ -332,7 +332,7 @@ void validate(boost::any& v, </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2502257"></a>Unicode Support</h3></div></div></div> +<a name="id2550116"></a>Unicode Support</h3></div></div></div> <p>To use the library with Unicode, you'd need to: </p> <div class="itemizedlist"><ul class="itemizedlist" type="disc"> @@ -402,14 +402,14 @@ $ export LC_CTYPE=ru_RU.KOI8-R </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="id2502434"></a>Allowing Unknown Options</h3></div></div></div> +<a name="id2550293"></a>Allowing Unknown Options</h3></div></div></div> <p>Usually, the library throws an exception on unknown option names. This behaviour can be changed. For example, only some part of your application uses <a class="link" href="../program_options.html" title="Chapter 18. Boost.Program_options">Program_options</a>, and you wish to pass unrecognized options to another part of the program, or even to another application.</p> <p>To allow unregistered options on the command line, you need to use the <code class="computeroutput"><a class="link" href="../boost/program_options/basic_command_line_parser.html" title="Class template basic_command_line_parser">basic_command_line_parser</a></code> class for parsing (not <code class="computeroutput"><a class="link" href="../boost/program_options/parse_command_line.html" title="Function template parse_command_line">parse_command_line</a></code>) - and call the <code class="computeroutput"><a class="link" href="../boost/program_options/basic_command_line_parser.html#id1160210-bb">allow_unregistered</a></code> + and call the <code class="computeroutput"><a class="link" href="../boost/program_options/basic_command_line_parser.html#id1139869-bb">allow_unregistered</a></code> method of that class: </p> <pre class="programlisting"> |