Documentation changes for the addition of plot_trisurf()

Author: WeatherGod

doc/mpl_toolkits/mplot3d/tutorial.rst

@@ -64,6 +64,15 @@ Surface plots
 .. plot:: mpl_examples/mplot3d/surface3d_demo2.py
 .. plot:: mpl_examples/mplot3d/surface3d_demo3.py
 
+.. _trisurface:
+
+Tri-Surface plots
+=================
+.. automethod:: Axes3D.plot_trisurface
+
+.. plot:: mpl_examples/mplot3d/trisurf3d_demo.py
+
+
 .. _contour3d:
 
 Contour plots

doc/users/whats_new.rst

@@ -12,6 +12,20 @@ This page just covers the highlights -- for the full story, see the
    versions 2.4 to 2.7.  matplotlib 1.2 and later require
    versions 2.6, 2.7, and 3.1 and higher.
 
+.. _whats-new-1-2:
+
+new in matplotlib-1.2
+=====================
+
+Tri-Surface Plots
+-----------------
+
+Damon McDougall added a new plotting method for the
+:mod:`~mpl_toolkits.mplot3d` toolkit called
+:meth:`~mpl_toolkits.mplot3d.axes3d.Axes3D.plot_trisurf`.
+
+.. plot:: mpl_examples/mplot3d/trisurf3d_demo.py
+
 .. _whats-new-1-1:
 
 new in matplotlib-1.1

lib/mpl_toolkits/mplot3d/axes3d.py

@@ -1572,7 +1572,7 @@ def plot_wireframe(self, X, Y, Z, *args, **kwargs):
         return linec
 
     def plot_trisurf(self, X, Y, Z, *args, **kwargs):
-        '''
+        """
         ============= ================================================
         Argument      Description
         ============= ================================================
@@ -1587,7 +1587,10 @@ def plot_trisurf(self, X, Y, Z, *args, **kwargs):
 
         Other arguments are passed on to
         :class:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection`
-        '''
+
+        .. versionadded:: 1.2.0
+            This plotting function was added for the v1.2.0 release.
+        """
 
         had_data = self.has_data()