addressing comments

choldgraf · choldgraf · commit b7d733ebb2bf · 2017-05-09T09:53:13.000-07:00
diff --git a/doc/api/toolkits/axes_grid.rst b/doc/api/toolkits/axes_grid.rst
@@ -11,11 +11,17 @@ The Matplotlib axes_grid Toolkit API
 
 Axes Grid
 ---------
+.. note::
+   
+   There is an older version of the AxesGrid toolkit, simply called ``axes_grid`` instead of
+   ``axes_grid1``.  the toolkit had a single namespace of axes_grid. This toolkit was broken
+   into the two modules below. For the documentation on the original ``axes_grid``
+   module, see the `previous version of the docs 
+   <http://matplotlib.org/2.0.1/mpl_toolkits/axes_grid/index.html#toolkit-axesgrid-index>`_.
 
 .. autosummary::
    :toctree: ../_as_gen
    :template: automodule.rst
 
-   axes_grid
    axes_grid1
    axisartist
diff --git a/doc/api/toolkits/mplot3d.rst b/doc/api/toolkits/mplot3d.rst
@@ -24,12 +24,7 @@ mplot3d API
    :toctree: ../_as_gen
    :template: autosummary.rst
 
-   axes3d.Axes
    axes3d.Axes3D
-   axes3d.Bbox
-   axes3d.LightSource
-   axes3d.Normalize
-   axes3d.Triangulation
 
 
 .. _toolkit_mplot3d-axisapi:
@@ -51,12 +46,6 @@ mplot3d API
    :template: autosummary.rst
 
    axis3d.Axis
-   axis3d.XAxis
-   axis3d.YAxis
-   axis3d.ZAxis
-   axis3d.get_flip_min_max
-   axis3d.move_from_center
-   axis3d.tick_update_position
 
 
 .. _toolkit_mplot3d-artapi:
@@ -76,6 +65,15 @@ mplot3d API
    art3d.PathPatch3D
    art3d.Poly3DCollection
    art3d.Text3D
+
+
+Art3D Utility Functions
+=======================
+
+.. autosummary::
+   :toctree: ../_as_gen
+   :template: autosummary.rst
+
    art3d.get_colors
    art3d.get_dir_vector
    art3d.get_patch_verts
diff --git a/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py b/lib/mpl_toolkits/axisartist/grid_helper_curvelinear.py
@@ -339,9 +339,9 @@ def __init__(self, aux_trans,
         (inverse transform should be defined) or a tuple of two callable
         objects which defines the transform and its inverse. The callables
         need take two arguments of array of source coordinates and
-        should return two target coordinates.::
+        should return two target coordinates.
 
-            e.g., x2, y2 = trans(x1, y1)
+        e.g., ``x2, y2 = trans(x1, y1)``
         """
         super(GridHelperCurveLinear, self).__init__()
 
diff --git a/tutorials/toolkits/mplot3d.py b/tutorials/toolkits/mplot3d.py
@@ -3,7 +3,7 @@
 The mplot3d Toolkit
 ===================
 
-Generating 3D plots the mplot3d toolkit.
+Generating 3D plots using the mplot3d toolkit.
 
 .. currentmodule:: mpl_toolkits.mplot3d
 
@@ -19,10 +19,10 @@
 Create a new :class:`matplotlib.figure.Figure` and
 add a new axes to it of type :class:`~mpl_toolkits.mplot3d.Axes3D`::
 
-  import matplotlib.pyplot as plt
-  from mpl_toolkits.mplot3d import Axes3D
-  fig = plt.figure()
-  ax = fig.add_subplot(111, projection='3d')
+   import matplotlib.pyplot as plt
+   from mpl_toolkits.mplot3d import Axes3D
+   fig = plt.figure()
+   ax = fig.add_subplot(111, projection='3d')
 
 .. versionadded:: 1.0.0
    This approach is the preferred method of creating a 3D axes.
