On Sep 3, 2009, at 12:28 PM, Ondrej Certik wrote:
> > On Thu, Sep 3, 2009 at 12:09 PM, William Stein<wst...@gmail.com> > wrote: >> >> Hi, >> >> I've been spending the last few days going between writing a lot of >> code with very math heavy Sphinx docstrings containing many >> backticks, >> and writing LaTeX documents (papers/notes/etc.) using $ signs for >> math >> mode. It is driving me totally crazy! I constantly accidentally put >> $'s in my Spinx docstrings and now I'm starting to put back ticks ` >> in >> my LaTeX documents. >> >> Is anybody else annoyed by this? I am very tempted to change Sage >> so >> that $ signs can be used as a synonym for backquotes in >> docstrings. I >> would leave backticks, but make it so $'s just get converted to >> backticks, plus maybe some marker to leave $'s as $'s (e.g., whatever >> one would currently do to enter a backtick in Sphinx). > > I am also writing lots of formulas using rest, e.g.: > > http://certik.github.com/mhd-hermes/sphinx-doc/physics.html > > and it bugs me that I have to type > > :math:`\eta` > > instead of just $\eta$. So how about submitting a patch to sphinx > fixing it? > > Ondrej That's a good idea. It would certainly be better than having to change Sage -- it would keep things "pure", but allow $'s, and even benefit you. Great idea. It's hard to argue with that. -- William --~--~---------~--~----~------------~-------~--~----~ To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---