[MERGE] improvements to the docstrings of bzrlib.smart and contents.

Michael Hudson michael.hudson at canonical.com
Wed Nov 14 22:27:37 GMT 2007


Robert Collins wrote:
> On Wed, 2007-11-14 at 17:43 +0000, Michael Hudson wrote:
>> Robert Collins wrote:
> 
>>> I completely agree with Aaron.
>> I may have been unclear here.  The judgement call I referred to is
>> whether backticks make the docstrings "significantly harder to read
>> inline", not whether making the docstrings significantly harder to
>> read inline is a bad thing.
> 
> One thing that is confusing:
> Moin: `plain text`
> pydoctor: `link text`

Yeah, that's pretty crazy.  I guess you could write an epydoc plugin 
that let you write docstrings in moin syntax...

Cheers,
mwh




More information about the bazaar mailing list