Some small documentation fixes.

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@62251 91177308-0d34-0410-b5e6-96231b3b80d8
This commit is contained in:
Mikhail Glushenkov 2009-01-15 02:42:40 +00:00
parent 564b75a4c6
commit f9b1d79a54
2 changed files with 24 additions and 22 deletions

View File

@ -290,9 +290,10 @@ example: <tt class="docutils literal"><span class="pre">(alias_option</span> <sp
<li><tt class="docutils literal"><span class="pre">help</span></tt> - help string associated with this option. Used for <li><tt class="docutils literal"><span class="pre">help</span></tt> - help string associated with this option. Used for
<tt class="docutils literal"><span class="pre">--help</span></tt> output.</li> <tt class="docutils literal"><span class="pre">--help</span></tt> output.</li>
<li><tt class="docutils literal"><span class="pre">required</span></tt> - this option is obligatory.</li> <li><tt class="docutils literal"><span class="pre">required</span></tt> - this option is obligatory.</li>
<li><tt class="docutils literal"><span class="pre">hidden</span></tt> - this option should not appear in the <tt class="docutils literal"><span class="pre">--help</span></tt> <li><tt class="docutils literal"><span class="pre">hidden</span></tt> - the description of this option will not appear in
output (but should appear in the <tt class="docutils literal"><span class="pre">--help-hidden</span></tt> output).</li> the <tt class="docutils literal"><span class="pre">--help</span></tt> output (but will appear in the <tt class="docutils literal"><span class="pre">--help-hidden</span></tt>
<li><tt class="docutils literal"><span class="pre">really_hidden</span></tt> - the option should not appear in any help output).</li>
<li><tt class="docutils literal"><span class="pre">really_hidden</span></tt> - the option will not be mentioned in any help
output.</li> output.</li>
<li><tt class="docutils literal"><span class="pre">extern</span></tt> - this option is defined in some other plugin, see below.</li> <li><tt class="docutils literal"><span class="pre">extern</span></tt> - this option is defined in some other plugin, see below.</li>
</ul> </ul>
@ -303,7 +304,7 @@ output.</li>
<h2><a class="toc-backref" href="#id10" id="external-options" name="external-options">External options</a></h2> <h2><a class="toc-backref" href="#id10" id="external-options" name="external-options">External options</a></h2>
<p>Sometimes, when linking several plugins together, one plugin needs to <p>Sometimes, when linking several plugins together, one plugin needs to
access options defined in some other plugin. Because of the way access options defined in some other plugin. Because of the way
options are implemented, such options should be marked as options are implemented, such options must be marked as
<tt class="docutils literal"><span class="pre">extern</span></tt>. This is what the <tt class="docutils literal"><span class="pre">extern</span></tt> option property is <tt class="docutils literal"><span class="pre">extern</span></tt>. This is what the <tt class="docutils literal"><span class="pre">extern</span></tt> option property is
for. Example:</p> for. Example:</p>
<pre class="literal-block"> <pre class="literal-block">
@ -574,13 +575,13 @@ line option <tt class="docutils literal"><span class="pre">--view-graph</span></
<a class="reference" href="http://pages.cs.wisc.edu/~ghost/">Ghostview</a> are installed. There is also a <tt class="docutils literal"><span class="pre">--dump-graph</span></tt> option that <a class="reference" href="http://pages.cs.wisc.edu/~ghost/">Ghostview</a> are installed. There is also a <tt class="docutils literal"><span class="pre">--dump-graph</span></tt> option that
creates a Graphviz source file (<tt class="docutils literal"><span class="pre">compilation-graph.dot</span></tt>) in the creates a Graphviz source file (<tt class="docutils literal"><span class="pre">compilation-graph.dot</span></tt>) in the
current directory.</p> current directory.</p>
<p>Another useful option is <tt class="docutils literal"><span class="pre">--check-graph</span></tt>. It checks the compilation <p>Another useful <tt class="docutils literal"><span class="pre">llvmc</span></tt> option is <tt class="docutils literal"><span class="pre">--check-graph</span></tt>. It checks the
graph for common errors like mismatched output/input language names, compilation graph for common errors like mismatched output/input
multiple default edges and cycles. These checks can't be performed at language names, multiple default edges and cycles. These checks can't
compile-time because the plugins can load code dynamically. When be performed at compile-time because the plugins can load code
invoked with <tt class="docutils literal"><span class="pre">--check-graph</span></tt>, <tt class="docutils literal"><span class="pre">llvmc</span></tt> doesn't perform any dynamically. When invoked with <tt class="docutils literal"><span class="pre">--check-graph</span></tt>, <tt class="docutils literal"><span class="pre">llvmc</span></tt> doesn't
compilation tasks and returns the number of encountered errors as its perform any compilation tasks and returns the number of encountered
status code.</p> errors as its status code.</p>
<hr /> <hr />
<address> <address>
<a href="http://jigsaw.w3.org/css-validator/check/referer"> <a href="http://jigsaw.w3.org/css-validator/check/referer">

View File

@ -294,10 +294,11 @@ separate option groups syntactically.
- ``required`` - this option is obligatory. - ``required`` - this option is obligatory.
- ``hidden`` - this option should not appear in the ``--help`` - ``hidden`` - the description of this option will not appear in
output (but should appear in the ``--help-hidden`` output). the ``--help`` output (but will appear in the ``--help-hidden``
output).
- ``really_hidden`` - the option should not appear in any help - ``really_hidden`` - the option will not be mentioned in any help
output. output.
- ``extern`` - this option is defined in some other plugin, see below. - ``extern`` - this option is defined in some other plugin, see below.
@ -307,7 +308,7 @@ External options
Sometimes, when linking several plugins together, one plugin needs to Sometimes, when linking several plugins together, one plugin needs to
access options defined in some other plugin. Because of the way access options defined in some other plugin. Because of the way
options are implemented, such options should be marked as options are implemented, such options must be marked as
``extern``. This is what the ``extern`` option property is ``extern``. This is what the ``extern`` option property is
for. Example:: for. Example::
@ -614,13 +615,13 @@ Ghostview_ are installed. There is also a ``--dump-graph`` option that
creates a Graphviz source file (``compilation-graph.dot``) in the creates a Graphviz source file (``compilation-graph.dot``) in the
current directory. current directory.
Another useful option is ``--check-graph``. It checks the compilation Another useful ``llvmc`` option is ``--check-graph``. It checks the
graph for common errors like mismatched output/input language names, compilation graph for common errors like mismatched output/input
multiple default edges and cycles. These checks can't be performed at language names, multiple default edges and cycles. These checks can't
compile-time because the plugins can load code dynamically. When be performed at compile-time because the plugins can load code
invoked with ``--check-graph``, ``llvmc`` doesn't perform any dynamically. When invoked with ``--check-graph``, ``llvmc`` doesn't
compilation tasks and returns the number of encountered errors as its perform any compilation tasks and returns the number of encountered
status code. errors as its status code.
.. _Graphviz: http://www.graphviz.org/ .. _Graphviz: http://www.graphviz.org/
.. _Ghostview: http://pages.cs.wisc.edu/~ghost/ .. _Ghostview: http://pages.cs.wisc.edu/~ghost/