Imported Upstream version 1.57.0upstream/1.57.0

1 files changed, 41 insertions, 41 deletions

diff --git a/doc/html/program_options/overview.html b/doc/html/program_options/overview.html
index ca29801783..95a0d89a1d 100644
--- a/doc/html/program_options/overview.html
+++ b/doc/html/program_options/overview.html
@@ -3,9 +3,9 @@
 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 <title>Library Overview</title>
 <link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css">
-<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
+<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&#160;18.&#160;Boost.Program_options">
+<link rel="up" href="../program_options.html" title="Chapter&#160;21.&#160;Boost.Program_options">
 <link rel="prev" href="tutorial.html" title="Tutorial">
 <link rel="next" href="howto.html" title="How To">
 </head>
@@ -25,12 +25,12 @@
 <div class="section">
 <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>
-<dt><span class="section"><a href="overview.html#id2548411">Options Description Component</a></span></dt>
-<dt><span class="section"><a href="overview.html#id2548995">Parsers Component</a></span></dt>
-<dt><span class="section"><a href="overview.html#id2549104">Storage Component</a></span></dt>
-<dt><span class="section"><a href="overview.html#id2549206">Specific parsers</a></span></dt>
-<dt><span class="section"><a href="overview.html#id2549501">Annotated List of Symbols</a></span></dt>
+<div class="toc"><dl class="toc">
+<dt><span class="section"><a href="overview.html#idp343206656">Options Description Component</a></span></dt>
+<dt><span class="section"><a href="overview.html#idp343269664">Parsers Component</a></span></dt>
+<dt><span class="section"><a href="overview.html#idp343280080">Storage Component</a></span></dt>
+<dt><span class="section"><a href="overview.html#idp343291568">Specific parsers</a></span></dt>
+<dt><span class="section"><a href="overview.html#idp343323824">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
@@ -38,7 +38,7 @@
   </p>
 <p>The library has three main components:
     </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>The options description component, which describes the allowed options
           and what to do with the values of the options.
         </p></li>
@@ -74,11 +74,11 @@
   </p>
 <div class="section">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="id2548411"></a>Options Description Component</h3></div></div></div>
-<div class="toc"><dl>
-<dt><span class="section"><a href="overview.html#id2548665">Syntactic Information</a></span></dt>
-<dt><span class="section"><a href="overview.html#id2548828">Semantic Information</a></span></dt>
-<dt><span class="section"><a href="overview.html#id2548876">Positional Options</a></span></dt>
+<a name="idp343206656"></a>Options Description Component</h3></div></div></div>
+<div class="toc"><dl class="toc">
+<dt><span class="section"><a href="overview.html#idp343233904">Syntactic Information</a></span></dt>
+<dt><span class="section"><a href="overview.html#idp343252656">Semantic Information</a></span></dt>
+<dt><span class="section"><a href="overview.html#idp343257312">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
@@ -146,15 +146,15 @@ desc.add_options()
     </p>
 <div class="section">
 <div class="titlepage"><div><div><h4 class="title">
-<a name="id2548665"></a>Syntactic Information</h4></div></div></div>
-<div class="toc"><dl><dt><span class="section"><a href="overview.html#id2548756">Description formatting</a></span></dt></dl></div>
+<a name="idp343233904"></a>Syntactic Information</h4></div></div></div>
+<div class="toc"><dl class="toc"><dt><span class="section"><a href="overview.html#idp343243728">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
         <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
         and includes:        
         </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>
               name of the option, used to identify the option inside the
               program,
@@ -195,7 +195,7 @@ desc.add_options()
       </p>
 <div class="section">
 <div class="titlepage"><div><div><h5 class="title">
-<a name="id2548756"></a>Description formatting</h5></div></div></div>
+<a name="idp343243728"></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
@@ -291,7 +291,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="id2548828"></a>Semantic Information</h4></div></div></div>
+<a name="idp343252656"></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:
@@ -314,7 +314,7 @@ desc.add_options()
 </div>
 <div class="section">
 <div class="titlepage"><div><div><h4 class="title">
-<a name="id2548876"></a>Positional Options</h4></div></div></div>
+<a name="idp343257312"></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>,
@@ -337,7 +337,7 @@ desc.add_options()
         </pre>
 <p>
       </p>
-<p>The <code class="computeroutput"><a class="link" href="../boost/program_options/positional_option_id789522.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/positional_op_idp206103968.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>
@@ -363,7 +363,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_option_id789522.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/positional_op_idp206103968.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>
@@ -371,7 +371,7 @@ pd.add("output-file", 2).add("input-file", -1);
 </div>
 <div class="section">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="id2548995"></a>Parsers Component</h3></div></div></div>
+<a name="idp343269664"></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
@@ -399,7 +399,7 @@ pd.add("output-file", 2).add("input-file", -1);
       from the options description component, the additional complexity is
       tolerable.
       </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>The name specified on the command line may be
             different from the option name -- it's common to provide a "short option
             name" alias to a longer name. It's also common to allow an abbreviated name
@@ -422,10 +422,10 @@ pd.add("output-file", 2).add("input-file", -1);
 </div>
 <div class="section">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="id2549104"></a>Storage Component</h3></div></div></div>
+<a name="idp343280080"></a>Storage Component</h3></div></div></div>
 <p>The storage component is responsible for:
       </p>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>Storing the final values of an option into a special class and in
             regular variables</p></li>
 <li class="listitem"><p>Handling priorities among different sources.</p></li>
@@ -465,19 +465,19 @@ notify(vm);
 </div>
 <div class="section">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="id2549206"></a>Specific parsers</h3></div></div></div>
-<div class="toc"><dl>
-<dt><span class="section"><a href="overview.html#id2549212">Configuration file parser</a></span></dt>
-<dt><span class="section"><a href="overview.html#id2549317">Environment variables parser</a></span></dt>
+<a name="idp343291568"></a>Specific parsers</h3></div></div></div>
+<div class="toc"><dl class="toc">
+<dt><span class="section"><a href="overview.html#idp343292240">Configuration file parser</a></span></dt>
+<dt><span class="section"><a href="overview.html#idp343304064">Environment variables parser</a></span></dt>
 </dl></div>
 <div class="section">
 <div class="titlepage"><div><div><h4 class="title">
-<a name="id2549212"></a>Configuration file parser</h4></div></div></div>
-<p>The <code class="computeroutput"><a class="link" href="../boost/program_options/parse_config_file_id783863.html" title="Function template parse_config_file">parse_config_file</a></code> function implements parsing
+<a name="idp343292240"></a>Configuration file parser</h4></div></div></div>
+<p>The <code class="computeroutput"><a class="link" href="../boost/program_options/parse_config_f_idp49149232.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>
-<div class="itemizedlist"><ul class="itemizedlist" type="disc">
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem">
 <p>A line in the form:</p>
 <pre class="screen">
@@ -508,7 +508,7 @@ gui.accessibility.visual_bell=yes
 </div>
 <div class="section">
 <div class="titlepage"><div><div><h4 class="title">
-<a name="id2549317"></a>Environment variables parser</h4></div></div></div>
+<a name="idp343304064"></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
@@ -522,7 +522,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_environmen_id1137214.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_environ_idp105107184.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
@@ -536,14 +536,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_environmen_id1137214.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_environ_idp105107184.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_environmen_id1137214.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_environ_idp105107184.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
@@ -553,7 +553,7 @@ gui.accessibility.visual_bell=yes
 </div>
 <div class="section">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="id2549501"></a>Annotated List of Symbols</h3></div></div></div>
+<a name="idp343323824"></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%">
@@ -572,7 +572,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_id1135975.html" title="Function value">value</a></code></td>
+<td><code class="computeroutput"><a class="link" href="../boost/program_options/value_idp224792240.html" title="Function value">value</a></code></td>
 <td>defines the option's value</td>
 </tr>
 <tr><td colspan="2">Parsers component</td></tr>
@@ -585,11 +585,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_file_id783863.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_config_f_idp49149232.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_environmen_id1137214.html" title="Function parse_environment">parse_environment</a></code></td>
+<td><code class="computeroutput"><a class="link" href="../boost/program_options/parse_environ_idp105107184.html" title="Function parse_environment">parse_environment</a></code></td>
 <td>parses environment</td>
 </tr>
 <tr><td colspan="2">Storage component</td></tr>