Bring three more plot3d files to 100% coverage

[kcrisman]

plot3d/plot3d.py: 83% (15 of 18)
plot3d/list_plot3d.py: 25% (1 of 4)
plot3d/parametric_plot3d.py: 20% (1 of 5)

$ ../../sage -coverage sage/plot/plot3d/list_plot3d.py 
----------------------------------------------------------------------
sage/plot/plot3d/list_plot3d.py
SCORE sage/plot/plot3d/list_plot3d.py: 25% (1 of 4)

Missing documentation:
 * list_plot3d_matrix(m, texture, **kwds):
 * list_plot3d_array_of_arrays(v, interpolation_type,texture, **kwds):
 * list_plot3d_tuples(v,interpolation_type, texture, **kwds):


$ ./sage -coverage devel/sage/sage/plot/plot3d/plot3d.py 
----------------------------------------------------------------------
devel/sage/sage/plot/plot3d/plot3d.py
ERROR: Please add a `TestSuite(s).run()` doctest.
SCORE devel/sage/sage/plot/plot3d/plot3d.py: 83% (15 of 18)

Missing documentation:
 * triangle(self, a, b, c, color = None):
 * smooth_triangle(self, a, b, c, da, db, dc, color = None):
 * axes(scale=1, radius=None, **kwds):


$ ../../sage -coverage sage/plot/plot3d/parametric_plot3d.py 
----------------------------------------------------------------------
sage/plot/plot3d/parametric_plot3d.py
SCORE sage/plot/plot3d/parametric_plot3d.py: 20% (1 of 5)

Missing doctests:
 * _parametric_plot3d_curve(f, urange, plot_points, **kwds):
 * _parametric_plot3d_surface(f, urange, vrange, plot_points, boundary_style, **kwds):
 * adapt_if_symbolic(f):
 * adapt_to_callable(f, nargs=None):

Base ticket: #12024 bringing docs to 90%.

Component: graphics

Author: Karl-Dieter Crisman

Reviewer: David Loeffler, John Palmieri

Merged: sage-5.0.beta9

Issue created by migration from https://trac.sagemath.org/ticket/12491

[kcrisman]

Description changed:

--- 
+++ 
@@ -1,8 +1,18 @@
 
 ```
-
+plot3d/plot3d.py: 83% (15 of 18)
 plot3d/list_plot3d.py: 25% (1 of 4)
 plot3d/parametric_plot3d.py: 20% (1 of 5)
+
+$ ../../sage -coverage sage/plot/plot3d/list_plot3d.py 
+----------------------------------------------------------------------
+sage/plot/plot3d/list_plot3d.py
+SCORE sage/plot/plot3d/list_plot3d.py: 25% (1 of 4)
+
+Missing documentation:
+	 * list_plot3d_matrix(m, texture, **kwds):
+	 * list_plot3d_array_of_arrays(v, interpolation_type,texture, **kwds):
+	 * list_plot3d_tuples(v,interpolation_type, texture, **kwds):
 
 
 $ ./sage -coverage devel/sage/sage/plot/plot3d/plot3d.py 

[kcrisman]

comment:2

Just some notes...

• axes appears to be used nowhere else, but since it is in a doctest, I won't remove it on this ticket. See also some of the other constructions in the various 3d plot directories which perform similar functions.
• adapt_to_callable is deprecated, as is a piece in it where we use function-call syntax. Given that this was deprecated in consolidate in plotting all extraction of variables, ranges, and fast_float setup #7008 (and let me tell you, figuring that out was nontrivial!) and Sage-4.1.2, from October 2009, I am going to remove this.

[kcrisman]

comment:3

In addition, adapt_if_symbolic, while not deprecated, has been stated to be for internal use since changeset 8271 and has not been used anywhere in Sage since changeset 8272 - January, 2008, Sage 2.10.1.

So I'm going to remove it.

[kcrisman]

Based on 5.0.beta3

[kcrisman]

comment:4

Attachment: trac_12491.patch.gz

It seems to pass all tests, and I looked at all the examples I added. Coverage is good. Needs review!

[kcrisman]

Author: Karl-Dieter Crisman

[loefflerd]

comment:5

Apply trac_12491.patch, trac_12491-review.patch

(for the patchbot). This looks fine; I found no problems except a couple of minor typos and formatting fixes. Also I flagged some doctests with #indirect doctest where necessary. Karl: if you're happy with my changes you can give this a positive review.