On Sun, Oct 4, 2009 at 10:04 AM, Mike Hansen <[email protected]> wrote:
> Sage (http://www.sagemath.org/doc/) does use Sphinx's default markup
> (although not idiomatically in many cases due to autoconversion from a
> previous markup.)  However, a patch was just accepted to allow $...$
> to delimit math mode.

But sage doesn't use the :param: style for parameters, does it?  It
uses all-caps for informal section delimiting and regular bullet lists
(with dashes) for parameters (this is from the 'factor' docstring):

        INPUT:

        -  ``n`` - an nonzero integer

        -  ``proof`` - bool or None (default: None)

I make the precision because I interpreted the OP's question as asking
about a project that would be using all the :param: & friends
machinery, not just avoiding post-processing (like numpydoc).

Speaking of the $x$ patch, with Ondrej we're maintaining a few useful
such things on a public github repo:

http://github.com/fperez/lacquer

we hope that as these things stabilize and get cleaned up, we can
upstream them (I'm using that extension a lot, as :math:`x` inline is
simply intolerable for extensive markup).

Cheers,

f

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to