update mathtext on review and added notes to the outline

jdh2358 · jdh2358 · commit 4b791b06138f · 2008-06-09T16:48:50.000Z
svn path=/trunk/matplotlib/; revision=5432
diff --git a/doc/devel/outline.rst b/doc/devel/outline.rst
@@ -28,7 +28,7 @@ patches                          ?                    no author    ?
 legends                          ?                    no author    ?
 animation                        John                 has author   ?
 collections                      ?                    no author    ?
-mathtext                         Michael ?            submitted    John
+mathtext                         Michael              in review    John
 fonts et al                      Michael ?            no author    Darren
 pyplot tut                       John                 submitted    Eric
 usetex                           Darren               submitted    ?
@@ -95,3 +95,28 @@ produce and checking their work, so don't be shy.  You *do not* need
 to be an expert in the subject you are editing -- you should know
 something about it and be willing to read, test, give feedback and
 pester!
+
+Reviewer notes
+==============
+
+If you want to make notes for the authorwhen you have reviewed a
+submission, you can put them here.  As the author cleans them up or
+addresses them, they should be removed.
+
+mathtext user's guide (reviewd by JDH)
+--------------------------------------
+
+This looks good -- there are a few minor things to close the book on
+this chapter.
+
+#. The main thing to wrap this up is getting the mathtext module
+ported over to rest and included in the API so the links from the
+user's guide tutorial work.
+
+#. This section might also benefit from a little more detail on the
+customizations that are possible (eg an example fleshing out the rc
+options a little bit).  Admittedly, this is pretty clear from readin
+ghte rc file, but it might be helpful to a newbie.
+
+#. There is still a TODO in the file to include a complete list of symbols
+
diff --git a/doc/users/mathtext.rst b/doc/users/mathtext.rst
@@ -11,7 +11,7 @@ own TeX expression parser, layout engine and fonts.  The layout engine
 is a fairly direct adaptation of the layout algorithms in Donald
 Knuth's TeX, so the quality is quite good (matplotlib also provides a
 ``usetex`` option for those who do want to call out to TeX to generate
-their text).
+their text (see :ref:`usetex-tutorial`).
 
 Any text element can use math text.  You need to use raw strings
 (preceed the quotes with an ``'r'``), and surround the string text
@@ -20,7 +20,8 @@ interleaved within the same string.  Mathtext can use the Computer
 Modern fonts (from (La)TeX), `STIX <http://www.aip.org/stixfonts/>`_
 fonts (with are designed to blend well with Times) or a Unicode font
 that you provide.  The mathtext font can be selected with the
-customization variable ``mathtext.fontset``.
+customization variable ``mathtext.fontset`` (see
+:ref:`customizing-matplotlib`)
 
 Here is a simple example::
 
@@ -165,7 +166,8 @@ When using the STIX fonts, you also have the choice of:
 .. image:: ../_static/stix_fonts.png
 
 There are also three global "font sets" to choose from, which are
-selected using the ``mathtext.fontset`` parameter in ``matplotibrc``.
+selected using the ``mathtext.fontset`` parameter in
+::ref:`matplotlibrc <matplotlibrc-sample>`.
 
 ``cm``: **Computer Modern (TeX)**
 
diff --git a/doc/users/usetex.rst b/doc/users/usetex.rst
@@ -7,16 +7,17 @@ Text Rendering With LaTeX
 Matplotlib has the option to use LaTeX to manage all text layout.  This
 option is available with the following backends:
 
-* \*Agg
+* Agg
 * PS
 * PDF
 
-The LaTeX option is activated by setting text.usetex : true in your rc
-settings.  Text handling with matplotlib's LaTeX support is slower than
-matplotlib's very capable :ref:`mathtext <mathtext-tutorial>`, but is more
-flexible, since different LaTeX packages (font packages, math packages, etc.)
-can be used. The results can be striking, especially when you take care to use
-the same fonts in your figures as in the main document.
+The LaTeX option is activated by setting ``text.usetex : True`` in
+your rc settings.  Text handling with matplotlib's LaTeX support is
+slower than matplotlib's very capable :ref:`mathtext
+<mathtext-tutorial>`, but is more flexible, since different LaTeX
+packages (font packages, math packages, etc.)  can be used. The
+results can be striking, especially when you take care to use the same
+fonts in your figures as in the main document.
 
 Matplotlib's LaTeX support requires a working LaTeX_ installation, dvipng_
 (which may be included with your LaTeX installation), and Ghostscript_
@@ -126,4 +127,4 @@ Illustrator, and searched text in pdf documents.
 .. _Ghostscript: http://www.cs.wisc.edu/~ghost/
 .. _PSNFSS: http://www.ctan.org/tex-archive/macros/latex/required/psnfss/psnfss2e.pdf
 .. _Poppler: http://poppler.freedesktop.org/
-.. _Xpdf: http://www.foolabs.com/xpdf
+.. _Xpdf: http://www.foolabs.com/xpdf
