[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