[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