[with patch] bug in "latex?" in the notebook

[was]

     --  The response to `latex?' seems to be out of date.

            %latex
            The equation y^2 = x^3 + x defines an elliptic curve.
            We have 2006 = SAGE{factor(2006)}.

    I thought it was a great credit to SAGE that when I edited the sample input
    in what seemed the obvious way, enclosing the math in $$ and changing SAGE
    to \sage, that it worked as expected.

Ah, you've found a bug. What happens is that all SAGE documentation is de-texed before displaying in the notebook (in plain text format). Unfortunately this detexing makes the documentation for latex appear completely wrong!

The solution is probably to come up with a notation to tell SAGE not to do the detexing.

[ncalexan]

683,989: add 'nodetex' directive to docstrings: doesn't strip (la)tex code from docstrings.

The first line of a docstring is parsed as a comma-separated list of directives (no whitespace in directives!). For example:

r"""nodetex,notyetimplemented
...
"""

If 'nodetex' is one of the directives, then no (la)tex code is stripped from the docstring. The model was the 'nodoctest' directive already found at the top of a file.

[mabshoff]

applied to 2.8.12.rc0