Consistently surround `cl::' code structures with <b> and <tt> to make them

stand out as code

llvm-svn: 21846
This commit is contained in:
Misha Brukman 2005-05-10 22:05:27 +00:00
parent 4fda633c59
commit ba8e260dce

View File

@ -1284,27 +1284,29 @@ that this option prefixes its value. With 'Prefix' options, the equal sign does
not separate the value from the option name specified. Instead, the value is not separate the value from the option name specified. Instead, the value is
everything after the prefix, including any equal sign if present. This is useful everything after the prefix, including any equal sign if present. This is useful
for processing odd arguments like <tt>-lmalloc</tt> and <tt>-L/usr/lib</tt> in a for processing odd arguments like <tt>-lmalloc</tt> and <tt>-L/usr/lib</tt> in a
linker tool or <tt>-DNAME=value</tt> in a compiler tool. Here, the linker tool or <tt>-DNAME=value</tt> in a compiler tool. Here, the
'<tt>l</tt>', '<tt>D</tt>' and '<tt>L</tt>' options are normal string (or list) '<tt>l</tt>', '<tt>D</tt>' and '<tt>L</tt>' options are normal string (or list)
options, that have the <a href="#cl::Prefix">cl::Prefix</a> modifier added to options, that have the <b><tt><a href="#cl::Prefix">cl::Prefix</a></tt></b>
allow the CommandLine library to recognize them. Note that modifier added to allow the CommandLine library to recognize them. Note that
<a href="#cl::Prefix">cl::Prefix</a> options must not have the <a <b><tt><a href="#cl::Prefix">cl::Prefix</a></tt></b> options must not have the
href="#cl::ValueDisallowed">cl::ValueDisallowed</a> modifier specified.</li> <b><tt><a href="#cl::ValueDisallowed">cl::ValueDisallowed</a></tt></b> modifier
specified.</li>
<li><a name="cl::Grouping">The <b><tt>cl::Grouping</tt></b></a> modifier is used <li><a name="cl::Grouping">The <b><tt>cl::Grouping</tt></b></a> modifier is used
to implement unix style tools (like <tt>ls</tt>) that have lots of single letter to implement unix style tools (like <tt>ls</tt>) that have lots of single letter
arguments, but only require a single dash. For example, the '<tt>ls -labF</tt>' arguments, but only require a single dash. For example, the '<tt>ls -labF</tt>'
command actually enables four different options, all of which are single command actually enables four different options, all of which are single
letters. Note that <a href="#cl::Grouping">cl::Grouping</a> options cannot have letters. Note that <b><tt><a href="#cl::Grouping">cl::Grouping</a></tt></b>
values.</li> options cannot have values.</li>
</ul> </ul>
<p>The CommandLine library does not restrict how you use the <a <p>The CommandLine library does not restrict how you use the <b><tt><a
href="#cl::Prefix">cl::Prefix</a> or <a href="#cl::Grouping">cl::Grouping</a> href="#cl::Prefix">cl::Prefix</a></tt></b> or <b><tt><a
modifiers, but it is possible to specify ambiguous argument settings. Thus, it href="#cl::Grouping">cl::Grouping</a></tt></b> modifiers, but it is possible to
is possible to have multiple letter options that are prefix or grouping options, specify ambiguous argument settings. Thus, it is possible to have multiple
and they will still work as designed.</p> letter options that are prefix or grouping options, and they will still work as
designed.</p>
<p>To do this, the CommandLine library uses a greedy algorithm to parse the <p>To do this, the CommandLine library uses a greedy algorithm to parse the
input option into (potentially multiple) prefix and grouping options. The input option into (potentially multiple) prefix and grouping options. The