More cosmetic tweaks for llvmc docs.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@60969 91177308-0d34-0410-b5e6-96231b3b80d8
diff --git a/tools/llvmc/doc/LLVMC-Reference.rst b/tools/llvmc/doc/LLVMC-Reference.rst
index c01f0bb..3033cfc 100644
--- a/tools/llvmc/doc/LLVMC-Reference.rst
+++ b/tools/llvmc/doc/LLVMC-Reference.rst
@@ -1,7 +1,17 @@
===================================
Customizing LLVMC: Reference Manual
===================================
-:Author: Mikhail Glushenkov <foldr@codedegers.com>
+
+.. contents::
+
+.. raw:: html
+
+ <div class="doc_author">
+ <p>Written by <a href="mailto:foldr@codedgers.com">Mikhail Glushenkov</a></p>
+ </div>
+
+Introduction
+============
LLVMC is a generic compiler driver, designed to be customizable and
extensible. It plays the same role for LLVM as the ``gcc`` program
@@ -16,11 +26,10 @@
makes it possible to easily adapt LLVMC for other purposes - for
example, as a build tool for game resources.
-Because LLVMC employs TableGen [1]_ as its configuration language, you
+Because LLVMC employs TableGen_ as its configuration language, you
need to be familiar with it to customize LLVMC.
-
-.. contents::
+.. _TableGen: http://llvm.cs.uiuc.edu/docs/TableGenFundamentals.html
Compiling with LLVMC
@@ -580,23 +589,27 @@
When writing LLVMC plugins, it can be useful to get a visual view of
the resulting compilation graph. This can be achieved via the command
-line option ``--view-graph``. This command assumes that Graphviz [2]_ and
-Ghostview [3]_ are installed. There is also a ``--dump-graph`` option that
-creates a Graphviz source file(``compilation-graph.dot``) in the
+line option ``--view-graph``. This command assumes that Graphviz_ and
+Ghostview_ are installed. There is also a ``--dump-graph`` option that
+creates a Graphviz source file (``compilation-graph.dot``) in the
current directory.
-
-References
-==========
-
-.. [1] TableGen Fundamentals
- http://llvm.cs.uiuc.edu/docs/TableGenFundamentals.html
-
-.. [2] Graphviz
- http://www.graphviz.org/
-
-.. [3] Ghostview
- http://pages.cs.wisc.edu/~ghost/
+.. _Graphviz: http://www.graphviz.org/
+.. _Ghostview: http://pages.cs.wisc.edu/~ghost/
.. raw:: html
- :file: footer.html
+
+ <hr />
+ <address>
+ <a href="http://jigsaw.w3.org/css-validator/check/referer">
+ <img src="http://jigsaw.w3.org/css-validator/images/vcss-blue"
+ alt="Valid CSS" /></a>
+ <a href="http://validator.w3.org/check?uri=referer">
+ <img src="http://www.w3.org/Icons/valid-xhtml10-blue"
+ alt="Valid XHTML 1.0 Transitional"/></a>
+
+ <a href="mailto:foldr@codedgers.com">Mikhail Glushenkov</a><br />
+ <a href="http://llvm.org">LLVM Compiler Infrastructure</a><br />
+
+ Last modified: $Date: 2008-12-11 11:34:48 -0600 (Thu, 11 Dec 2008) $
+ </address>
diff --git a/tools/llvmc/doc/LLVMC-Tutorial.rst b/tools/llvmc/doc/LLVMC-Tutorial.rst
index 40292ee..a27bb20 100644
--- a/tools/llvmc/doc/LLVMC-Tutorial.rst
+++ b/tools/llvmc/doc/LLVMC-Tutorial.rst
@@ -1,7 +1,17 @@
======================
Tutorial - Using LLVMC
======================
-:Author: Mikhail Glushenkov <foldr@codedegers.com>
+
+.. contents::
+
+.. raw:: html
+
+ <div class="doc_author">
+ <p>Written by <a href="mailto:foldr@codedgers.com">Mikhail Glushenkov</a></p>
+ </div>
+
+Introduction
+============
LLVMC is a generic compiler driver, which plays the same role for LLVM
as the ``gcc`` program does for GCC - the difference being that LLVMC
@@ -11,9 +21,6 @@
and configuration of LLVMC.
-.. contents::
-
-
Compiling with LLVMC
====================
@@ -32,9 +39,11 @@
Using LLVMC to generate toolchain drivers
=========================================
-LLVMC plugins are written mostly using TableGen [1]_, so you need to
+LLVMC plugins are written mostly using TableGen_, so you need to
be familiar with it to get anything done.
+.. _TableGen: http://llvm.cs.uiuc.edu/docs/TableGenFundamentals.html
+
Start by compiling ``plugins/Simple/Simple.td``, which is a primitive
wrapper for ``gcc``::
@@ -93,11 +102,19 @@
To learn more about LLVMC customization, refer to the reference
manual and plugin source code in the ``plugins`` directory.
-References
-==========
-
-.. [1] TableGen Fundamentals
- http://llvm.cs.uiuc.edu/docs/TableGenFundamentals.html
-
.. raw:: html
- :file: footer.html
+
+ <hr />
+ <address>
+ <a href="http://jigsaw.w3.org/css-validator/check/referer">
+ <img src="http://jigsaw.w3.org/css-validator/images/vcss-blue"
+ alt="Valid CSS" /></a>
+ <a href="http://validator.w3.org/check?uri=referer">
+ <img src="http://www.w3.org/Icons/valid-xhtml10-blue"
+ alt="Valid XHTML 1.0 Transitional"/></a>
+
+ <a href="mailto:foldr@codedgers.com">Mikhail Glushenkov</a><br />
+ <a href="http://llvm.org">LLVM Compiler Infrastructure</a><br />
+
+ Last modified: $Date: 2008-12-11 11:34:48 -0600 (Thu, 11 Dec 2008) $
+ </address>
diff --git a/tools/llvmc/doc/footer.html b/tools/llvmc/doc/footer.html
deleted file mode 100644
index 2292471..0000000
--- a/tools/llvmc/doc/footer.html
+++ /dev/null
@@ -1,12 +0,0 @@
-<hr />
-<address>
- <a href="http://jigsaw.w3.org/css-validator/check/referer"><img src="http://jigsaw.w3.org/css-validator/images/vcss-blue"
- alt="Valid CSS" /></a>
- <a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10-blue"
- alt="Valid XHTML 1.0 Transitional"/></a>
-
- <a href="mailto:foldr@codedgers.com">Mikhail Glushenkov</a><br />
- <a href="http://llvm.org">LLVM Compiler Infrastructure</a><br />
-
- Last modified: $Date: 2008-12-11 11:34:48 -0600 (Thu, 11 Dec 2008) $
-</address>
diff --git a/tools/llvmc/doc/llvm-rst.css b/tools/llvmc/doc/llvm-rst.css
index 6937e4b..2ff9cca 100644
--- a/tools/llvmc/doc/llvm-rst.css
+++ b/tools/llvmc/doc/llvm-rst.css
@@ -41,7 +41,10 @@
margin: 20pt 0pt 5pt 0pt;
}
-.title { padding-top: 0; margin-top: 0; text-align: left; font-size: 25pt }
+.title { padding-top: 0; margin-top: 0; text-align: left;
+ font-size: 25pt }
+
+#contents { font-weight: bold; }
h2 { width: 75%;
text-align: left; font-size: 12pt; padding: 4pt 4pt 4pt 4pt;
margin: 1.5em 0.5em 0.5em 0.5em }
@@ -67,7 +70,7 @@
.literal-block { border: solid 1px gray; background: #eeeeee;
margin: 0 1em 0 1em;
- padding: 0 1em 0 1em;
+ padding: 1em 2em 1em 1em;
display:table;
}
.doc_notes { background: #fafafa; border: 1px solid #cecece; padding: 0.1em }