[Zope3-checkins] Re: [Checkins] SVN: zope.interface/trunk/src/zope/interface/human. Fixed RsT markup

Dmitry Vasiliev dima at hlabs.spb.ru
Tue Jun 26 10:44:20 EDT 2007


Stephan Richter wrote:
> On Tuesday 26 June 2007 10:05, Dmitry Vasiliev wrote:
>> Stephan Richter wrote:
>>> On Tuesday 26 June 2007 09:24, Dmitry Vasiliev wrote:
>>>> +First we have to import the interface package::
>>>>  
>>>>    >>> import zope.interface
>>> This is not needed. ReST will detect doctest code automatically.
>> Yes, but in this case ReST inserts <blockquote> and <pre> tags instead
>> of just <pre> and plus it isn't consistent with the other docs from
>> 'zope.interface' so I think that explicitly marked blocks are better.
> 
> I would fix the other docs. We are definitely not using "::" for doctests 
> anywhere else.

Ah, without '::' ReST add 'doctest-block' class for <pre> instead of 
'literal-block' - it's can be a big plus. I'll fix the 'zope.interface' 
docs then.

-- 
Dmitry Vasiliev <dima at hlabs.spb.ru>
http://hlabs.spb.ru


More information about the Zope3-Checkins mailing list