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
-~----------~----~----~----~------~----~------~--~---

Reply via email to