@@ -51,7 +51,7 @@ statement, such as::
5151
5252 .. include:: ../../TODO
5353
54-
54+
5555Formatting
5656==========
5757
@@ -76,14 +76,14 @@ working with Sphinx in general. Here are a few additional things to keep in mind
7676 nor the ``literal `` role::
7777
7878 Please do not describe ``argument`` like this.
79-
79+
8080* Sphinx does not support tables with column- or row-spanning cells for
8181 latex output. Such tables can not be used when documenting matplotlib.
8282
8383* Mathematical expressions can be rendered as png images in html, and in the
8484 usual way by latex. For example:
8585
86- ``math:`sin(x_n^2)` `` yields: :math: `sin(x_n^2 )`, and::
86+ ``math:`\ sin(x_n^2)` `` yields: :math: `\ sin (x_n^2 )`, and::
8787
8888 .. math::
8989
@@ -152,7 +152,7 @@ working with Sphinx in general. Here are a few additional things to keep in mind
152152
153153 .. versionadded :: 0.98
154154 The transforms have been completely revamped.
155-
155+
156156* Use the *seealso * directive, for example::
157157
158158 .. seealso::
@@ -164,7 +164,7 @@ working with Sphinx in general. Here are a few additional things to keep in mind
164164 One more
165165
166166 yields:
167-
167+
168168 .. seealso::
169169
170170 Using ResT :ref:`emacs-helpers`:
@@ -178,7 +178,7 @@ working with Sphinx in general. Here are a few additional things to keep in mind
178178
179179* The autodoc extension will handle index entries for the API, but additional
180180 entries in the index _ need to be explicitly added.
181-
181+
182182.. _documentation : http://sphinx.pocoo.org/contents.html
183183.. _`inline markup` : http://sphinx.pocoo.org/markup/inline.html
184184.. _index : http://sphinx.pocoo.org/markup/para.html#index-generating-markup
@@ -189,14 +189,14 @@ Docstrings
189189In addition to the aforementioned formatting suggestions:
190190
191191* Please limit the text width of docstrings to 70 characters.
192-
192+
193193* Keyword arguments should be described using a definition list.
194194
195195 .. note ::
196196 matplotlib makes extensive use of keyword arguments as pass-through
197197 arguments, there are a many cases where a table is used in place of a
198198 definition list for autogenerated sections of docstrings.
199-
199+
200200
201201Figures
202202=======
0 commit comments