On Wed, Jul 28, 2010 at 1:54 PM, Eric Firing <efir...@hawaii.edu> wrote:

> On 07/28/2010 05:48 AM, Benjamin Root wrote:
>
>> On Tue, Jul 27, 2010 at 1:31 PM, Friedrich Romstedt
>> <friedrichromst...@gmail.com <mailto:friedrichromst...@gmail.com>> wrote:
>>
>>    2010/7/26 Benjamin Root <ben.r...@ou.edu <mailto:ben.r...@ou.edu>>:
>>
>>     > After some reading of sphinx documentation, it appears to be a
>>    bug with
>>     > sphinx (or actually, "smartypants") because it should not be
>>    doing this sort
>>     > of interpretation within a docstring.  Anyway, supposedly the
>>    workaround is
>>     > to put double backticks around the part that needs to be treated
>>    literally:
>>     > ``'--'``.  I tried this out and built the docs locally and it
>>    works... sort
>>     > of.  The text that is surrounded by double backticks are getting
>>    a different
>>     > background color.  This doesn't look great to me.  Maybe someone
>>    else has a
>>     > thought?
>>
>>    How looks a backticked empty string like?  If it is just nothing, it
>>    could be used in between of the two hyphens, to separate them by
>>    "nothing".  Still very hackish ... But it's just like LaTeX -{}-.
>>
>>    Friedrich
>>
>>
>> Actually, I just took another look at the documentation and realized
>> that the docstring for set_linestyle() was inconsistent with the docs
>> for plot().  plot() have been using the backticks for a while now, so if
>> we just use the double-backticks for all the values in set_linestyle()
>> it would be consistent and look much better than it is now.
>>
>> I can make these changes and commit them to the trunk and the release
>> branch, if that is ok.
>>
>
> Ben,
>
> Sounds reasonable--go ahead.
>
> Thanks.
>
> Eric
>

Done in r8593 and r8594

Ben Root
------------------------------------------------------------------------------
The Palm PDK Hot Apps Program offers developers who use the
Plug-In Development Kit to bring their C/C++ apps to Palm for a share
of $1 Million in cash or HP Products. Visit us here for more details:
http://p.sf.net/sfu/dev2dev-palm
_______________________________________________
Matplotlib-users mailing list
Matplotlib-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-users

Reply via email to