Merge pull request matplotlib#3342 from WeatherGod/14xDocFixes

DOC : fixed links, un-nested artist API docs

AGG link changed. Also fix other doc warnings

Author: tacaswell

doc/api/artist_api.rst

@@ -4,7 +4,7 @@
 artists
 *******
 
-.. inheritance-diagram:: matplotlib.patches matplotlib.lines matplotlib.text matplotlib.offsetbox
+.. inheritance-diagram:: matplotlib.patches matplotlib.lines matplotlib.text matplotlib.offsetbox matplotlib.image
    :parts: 2
 
 :mod:`matplotlib.artist`
@@ -15,36 +15,3 @@ artists
    :undoc-members:
    :show-inheritance:
 
-
-:mod:`matplotlib.lines`
-=======================
-
-.. automodule:: matplotlib.lines
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-:mod:`matplotlib.patches`
-=========================
-
-.. automodule:: matplotlib.patches
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-:mod:`matplotlib.text`
-======================
-
-.. automodule:: matplotlib.text
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-
-:mod:`matplotlib.offsetbox`
-===========================
-
-.. automodule:: matplotlib.offsetbox
-   :members:
-   :undoc-members:
-   :show-inheritance:

doc/api/image_api.rst

@@ -0,0 +1,12 @@
+*****
+image
+*****
+
+
+:mod:`matplotlib.image`
+=======================
+
+.. automodule:: matplotlib.image
+   :members:
+   :undoc-members:
+   :show-inheritance:

doc/api/index.rst

@@ -31,15 +31,20 @@
    finance_api.rst
    font_manager_api.rst
    gridspec_api.rst
+   image_api.rst
    legend_api.rst
+   lines_api.rst
    markers_api.rst
    mathtext_api.rst
    mlab_api.rst
+   offsetbox_api.rst
+   patches_api.rst
    path_api.rst
    patheffects_api.rst
    pyplot_api.rst
    sankey_api.rst
    spines_api.rst
+   text_api.rst
    ticker_api.rst
    tight_layout_api.rst
    tri_api.rst

doc/api/lines_api.rst

@@ -0,0 +1,12 @@
+*****
+lines
+*****
+
+
+:mod:`matplotlib.lines`
+=======================
+
+.. automodule:: matplotlib.lines
+   :members:
+   :undoc-members:
+   :show-inheritance:

doc/api/offsetbox_api.rst

@@ -0,0 +1,12 @@
+*********
+offsetbox
+*********
+
+
+:mod:`matplotlib.offsetbox`
+===========================
+
+.. automodule:: matplotlib.offsetbox
+   :members:
+   :undoc-members:
+   :show-inheritance:

doc/api/patches_api.rst

@@ -0,0 +1,12 @@
+*******
+patches
+*******
+
+
+:mod:`matplotlib.patches`
+=========================
+
+.. automodule:: matplotlib.patches
+   :members:
+   :undoc-members:
+   :show-inheritance:

doc/api/text_api.rst

@@ -0,0 +1,12 @@
+****
+text
+****
+
+
+:mod:`matplotlib.text`
+=======================
+
+.. automodule:: matplotlib.text
+   :members:
+   :undoc-members:
+   :show-inheritance:

doc/faq/howto_faq.rst

@@ -41,11 +41,13 @@ You can also filter on class instances::
 
 
 .. _howto-supress_offset:
+
 How to prevent ticklabels from having an offset
 -----------------------------------------------
 The default formatter will use an offset to reduce
 the length of the ticklabels.  To turn this feature
 off on a per-axis basis::
+
    ax.get_xaxis().get_major_formatter().set_useOffset(False)
 
 set the rcParam ``axes.formatter.useoffset``, or use a different
@@ -385,6 +387,7 @@ pyplot::
 
 
 .. seealso::
+
     :ref:`howto-webapp` for information about running matplotlib inside
     of a web application.
 
@@ -581,7 +584,8 @@ enabled, you may get errors if you don't configure matplotlib for use
 in these environments.  Most importantly, you need to decide what
 kinds of images you want to generate (PNG, PDF, SVG) and configure the
 appropriate default backend.  For 99% of users, this will be the Agg
-backend, which uses the C++ `antigrain <http://antigrain.com>`_
+backend, which uses the C++
+`antigrain <http://agg.sourceforge.net/antigrain.com/index.html>`_
 rendering engine to make nice PNGs.  The Agg backend is also
 configured to recognize requests to generate other output formats
 (PDF, PS, EPS, SVG).  The easiest way to configure matplotlib to use
@@ -615,7 +619,7 @@ or by saving to a file handle::
     import sys
     fig.savefig(sys.stdout)
 
-Here is an example using `Pillow <http://python-imaging.github.io/>__.
+Here is an example using `Pillow <http://python-imaging.github.io/>`_.
 First, the figure is saved to a StringIO object which is then fed to
 Pillow for further processing::
 

doc/faq/usage_faq.rst

@@ -382,7 +382,7 @@ macosx         Cocoa rendering in OSX windows
                is in non-interactive mode)
 ============   ================================================================
 
-.. _`Anti-Grain Geometry`: http://www.antigrain.com/
+.. _`Anti-Grain Geometry`: http://agg.sourceforge.net/antigrain.com/index.html
 .. _Postscript: http://en.wikipedia.org/wiki/PostScript
 .. _`Portable Document Format`: http://en.wikipedia.org/wiki/Portable_Document_Format
 .. _`Scalable Vector Graphics`: http://en.wikipedia.org/wiki/Scalable_Vector_Graphics

doc/glossary/index.rst

@@ -8,7 +8,7 @@ Glossary
 .. glossary::
 
   AGG
-      The Anti-Grain Geometry (`Agg <http://antigrain.com>`_) rendering engine, capable of rendering
+      The Anti-Grain Geometry (`Agg <http://agg.sourceforge.net/antigrain.com/index.html>`_) rendering engine, capable of rendering
       high-quality images
 
   Cairo