diff options
Diffstat (limited to 'doc/html/program_options/overview.html')
| -rw-r--r-- | doc/html/program_options/overview.html | 64 |
1 files changed, 32 insertions, 32 deletions
diff --git a/doc/html/program_options/overview.html b/doc/html/program_options/overview.html index fdb5e6f4a7..550bcd5b30 100644 --- a/doc/html/program_options/overview.html +++ b/doc/html/program_options/overview.html @@ -6,7 +6,7 @@ <link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css"> <meta name="generator" content="DocBook XSL Stylesheets V1.78.1"> <link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> -<link rel="up" href="../program_options.html" title="Chapter 21. Boost.Program_options"> +<link rel="up" href="../program_options.html" title="Chapter 22. Boost.Program_options"> <link rel="prev" href="tutorial.html" title="Tutorial"> <link rel="next" href="howto.html" title="How To"> </head> @@ -27,11 +27,11 @@ <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="program_options.overview"></a>Library Overview</h2></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="overview.html#idp343157936">Options Description Component</a></span></dt> -<dt><span class="section"><a href="overview.html#idp343221840">Parsers Component</a></span></dt> -<dt><span class="section"><a href="overview.html#idp343232256">Storage Component</a></span></dt> -<dt><span class="section"><a href="overview.html#idp343243632">Specific parsers</a></span></dt> -<dt><span class="section"><a href="overview.html#idp343275424">Annotated List of Symbols</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218399280">Options Description Component</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218336304">Parsers Component</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218325888">Storage Component</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218314512">Specific parsers</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218282592">Annotated List of Symbols</a></span></dt> </dl></div> <p>In the tutorial section, we saw several examples of library usage. Here we will describe the overall library design including the primary @@ -75,11 +75,11 @@ </p> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp343157936"></a>Options Description Component</h3></div></div></div> +<a name="idm45555218399280"></a>Options Description Component</h3></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="overview.html#idp343185296">Syntactic Information</a></span></dt> -<dt><span class="section"><a href="overview.html#idp343205008">Semantic Information</a></span></dt> -<dt><span class="section"><a href="overview.html#idp343209600">Positional Options</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218371856">Syntactic Information</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218353200">Semantic Information</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218348608">Positional Options</a></span></dt> </dl></div> <p>The options description component has three main classes: <code class="computeroutput"><a class="link" href="../boost/program_options/option_description.html" title="Class option_description">option_description</a></code>, <code class="computeroutput"><a class="link" href="../boost/program_options/value_semantic.html" title="Class value_semantic">value_semantic</a></code> and <code class="computeroutput"><a class="link" href="../boost/program_options/options_description.html" title="Class options_description">options_description</a></code>. The @@ -147,8 +147,8 @@ desc.add_options() </p> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp343185296"></a>Syntactic Information</h4></div></div></div> -<div class="toc"><dl class="toc"><dt><span class="section"><a href="overview.html#idp343195056">Description formatting</a></span></dt></dl></div> +<a name="idm45555218371856"></a>Syntactic Information</h4></div></div></div> +<div class="toc"><dl class="toc"><dt><span class="section"><a href="overview.html#idm45555218362096">Description formatting</a></span></dt></dl></div> <p>The syntactic information is provided by the <code class="computeroutput"><a class="link" href="../boost/program_options/options_description.html" title="Class options_description">boost::program_options::options_description</a></code> class and some methods of the @@ -196,7 +196,7 @@ desc.add_options() </p> <div class="section"> <div class="titlepage"><div><div><h5 class="title"> -<a name="idp343195056"></a>Description formatting</h5></div></div></div> +<a name="idm45555218362096"></a>Description formatting</h5></div></div></div> <p> Sometimes the description can get rather long, for example, when several option's values need separate documentation. Below we @@ -292,7 +292,7 @@ bla bla bla bla bla bla bla bla bla bla bla bla bla bla bla"); </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp343205008"></a>Semantic Information</h4></div></div></div> +<a name="idm45555218353200"></a>Semantic Information</h4></div></div></div> <p>The semantic information is completely provided by the <code class="computeroutput"><a class="link" href="../boost/program_options/value_semantic.html" title="Class value_semantic">boost::program_options::value_semantic</a></code> class. For example: @@ -315,7 +315,7 @@ desc.add_options() </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp343209600"></a>Positional Options</h4></div></div></div> +<a name="idm45555218348608"></a>Positional Options</h4></div></div></div> <p>Our definition of option as (name, value) pairs is simple and useful, but in one special case of the command line, there's a problem. A command line can include a <em class="firstterm">positional option</em>, @@ -338,7 +338,7 @@ desc.add_options() </pre> <p> </p> -<p>The <code class="computeroutput"><a class="link" href="../boost/program_options/positional_op_idp150873344.html" title="Class positional_options_description">positional_options_description</a></code> class allows the command line +<p>The <code class="computeroutput"><a class="link" href="../boost/program_options/position_idm45507094291136.html" title="Class positional_options_description">positional_options_description</a></code> class allows the command line parser to assign the names. The class specifies how many positional options are allowed, and for each allowed option, specifies the name. For example: </p> @@ -364,7 +364,7 @@ pd.add("output-file", 2).add("input-file", -1); <td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../../../doc/src/images/warning.png"></td> <th align="left">Warning</th> </tr> -<tr><td align="left" valign="top"><p>The <code class="computeroutput"><a class="link" href="../boost/program_options/positional_op_idp150873344.html" title="Class positional_options_description">positional_options_description</a></code> class only specifies translation from +<tr><td align="left" valign="top"><p>The <code class="computeroutput"><a class="link" href="../boost/program_options/position_idm45507094291136.html" title="Class positional_options_description">positional_options_description</a></code> class only specifies translation from position to name, and the option name should still be registered with an 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.</p></td></tr> </table></div> @@ -372,7 +372,7 @@ pd.add("output-file", 2).add("input-file", -1); </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp343221840"></a>Parsers Component</h3></div></div></div> +<a name="idm45555218336304"></a>Parsers Component</h3></div></div></div> <p>The parsers component splits input sources into (name, value) pairs. Each parser looks for possible options and consults the options description component to determine if the option is known and how its value @@ -423,7 +423,7 @@ pd.add("output-file", 2).add("input-file", -1); </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp343232256"></a>Storage Component</h3></div></div></div> +<a name="idm45555218325888"></a>Storage Component</h3></div></div></div> <p>The storage component is responsible for: </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> @@ -466,15 +466,15 @@ notify(vm); </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp343243632"></a>Specific parsers</h3></div></div></div> +<a name="idm45555218314512"></a>Specific parsers</h3></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="overview.html#idp343244304">Configuration file parser</a></span></dt> -<dt><span class="section"><a href="overview.html#idp343256080">Environment variables parser</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218313840">Configuration file parser</a></span></dt> +<dt><span class="section"><a href="overview.html#idm45555218302000">Environment variables parser</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp343244304"></a>Configuration file parser</h4></div></div></div> -<p>The <code class="computeroutput"><a class="link" href="../boost/program_options/parse_config__idp206025792.html" title="Function template parse_config_file">parse_config_file</a></code> function implements parsing +<a name="idm45555218313840"></a>Configuration file parser</h4></div></div></div> +<p>The <code class="computeroutput"><a class="link" href="../boost/program_options/parse_co_idm45507106389456.html" title="Function template parse_config_file">parse_config_file</a></code> function implements parsing of simple INI-like configuration files. Configuration file syntax is line based: </p> @@ -509,7 +509,7 @@ gui.accessibility.visual_bell=yes </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp343256080"></a>Environment variables parser</h4></div></div></div> +<a name="idm45555218302000"></a>Environment variables parser</h4></div></div></div> <p><em class="firstterm">Environment variables</em> are string variables which are available to all programs via the <code class="computeroutput">getenv</code> function of C runtime library. The operating system allows to set initial values @@ -523,7 +523,7 @@ gui.accessibility.visual_bell=yes they are particularly suitable for options which apply to all programs. </p> <p>The environment variables can be parsed with the - <code class="computeroutput"><a class="link" href="../boost/program_options/parse_environ_idp224270416.html" title="Function parse_environment">parse_environment</a></code> function. The function have several overloaded + <code class="computeroutput"><a class="link" href="../boost/program_options/parse_en_idm45506972428912.html" title="Function parse_environment">parse_environment</a></code> function. The function have several overloaded versions. The first parameter is always an <code class="computeroutput"><a class="link" href="../boost/program_options/options_description.html" title="Class options_description">options_description</a></code> instance, and the second specifies what variables must be processed, and what option names must correspond to it. To describe the second @@ -537,14 +537,14 @@ gui.accessibility.visual_bell=yes name <code class="literal">proxy</code> the environment variable might be called <code class="envar">BOOST_PROXY</code>. During parsing, we need to perform reverse conversion of the names. This is accomplished by passing the choosen - prefix as the second parameter of the <code class="computeroutput"><a class="link" href="../boost/program_options/parse_environ_idp224270416.html" title="Function parse_environment">parse_environment</a></code> function. + prefix as the second parameter of the <code class="computeroutput"><a class="link" href="../boost/program_options/parse_en_idm45506972428912.html" title="Function parse_environment">parse_environment</a></code> function. Say, if you pass <code class="literal">BOOST_</code> as the prefix, and there are two variables, <code class="envar">CVSROOT</code> and <code class="envar">BOOST_PROXY</code>, the first variable will be ignored, and the second one will be converted to option <code class="literal">proxy</code>. </p> <p>The above logic is sufficient in many cases, but it is also - possible to pass, as the second parameter of the <code class="computeroutput"><a class="link" href="../boost/program_options/parse_environ_idp224270416.html" title="Function parse_environment">parse_environment</a></code> + possible to pass, as the second parameter of the <code class="computeroutput"><a class="link" href="../boost/program_options/parse_en_idm45506972428912.html" title="Function parse_environment">parse_environment</a></code> function, any function taking a <code class="computeroutput">std::string</code> and returning <code class="computeroutput">std::string</code>. That function will be called for each environment variable and should return either the name of the option, or @@ -554,7 +554,7 @@ gui.accessibility.visual_bell=yes </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp343275424"></a>Annotated List of Symbols</h3></div></div></div> +<a name="idm45555218282592"></a>Annotated List of Symbols</h3></div></div></div> <p>The following table describes all the important symbols in the library, for quick access.</p> <div class="informaltable"><table class="table" width="100%"> @@ -573,7 +573,7 @@ gui.accessibility.visual_bell=yes <td>describes a number of options</td> </tr> <tr> -<td><code class="computeroutput"><a class="link" href="../boost/program_options/value_idp109113408.html" title="Function value">value</a></code></td> +<td><code class="computeroutput"><a class="link" href="../boost/program_options/value_idm45507036651984.html" title="Function value">value</a></code></td> <td>defines the option's value</td> </tr> <tr><td colspan="2">Parsers component</td></tr> @@ -586,11 +586,11 @@ gui.accessibility.visual_bell=yes <td>parses command line (extended interface)</td> </tr> <tr> -<td><code class="computeroutput"><a class="link" href="../boost/program_options/parse_config__idp206025792.html" title="Function template parse_config_file">parse_config_file</a></code></td> +<td><code class="computeroutput"><a class="link" href="../boost/program_options/parse_co_idm45507106389456.html" title="Function template parse_config_file">parse_config_file</a></code></td> <td>parses config file</td> </tr> <tr> -<td><code class="computeroutput"><a class="link" href="../boost/program_options/parse_environ_idp224270416.html" title="Function parse_environment">parse_environment</a></code></td> +<td><code class="computeroutput"><a class="link" href="../boost/program_options/parse_en_idm45506972428912.html" title="Function parse_environment">parse_environment</a></code></td> <td>parses environment</td> </tr> <tr><td colspan="2">Storage component</td></tr> |