[IPython-user] IPython 0.7.1 is out.
Fernando Perez
Fernando.Perez at colorado.edu
Tue Jan 24 20:04:07 CST 2006
Alan G Isaac wrote:
> On Tue, 24 Jan 2006, Fernando Perez apparently wrote:
>
>>thoughts?
>
>
> I like EpyDoc pretty well, but I think it is risky
> to commit to its special syntax. It is not clear that
> development is continuing at a useful pace (or at any pace
> at all, really).
>
> reST is much nicer and more powerful in any case.
> And other doc systems will likely support reST.
> E.g., Pudge http://pudge.lesscode.org/ supports reST
> in docstrings, and some have already recommended it over
> Epydoc. (I am not offering an opion.)
>
> fwiw,
Thanks for this info, Alan. We'll look into this, though for now I guess reST
seems like a safe choice: supported by most tools in the python universe,
including epydoc, doctools and pudge.
Cheers,
f
More information about the IPython-user
mailing list