[SciPy-user] Docstring standards for NumPy and SciPy

Perry Greenfield perry at stsci.edu
Thu Jan 11 10:27:15 CST 2007


On Jan 11, 2007, at 10:58 AM, Brian Granger wrote:

>
> Because of this, and the reasons that Fernando listed (too much
> cognitive load in tracking all the different markup languages already)
> we are using epydoc+ReST in IPython from now forward.
>
> I realize that the line noise of ReST is less readable in Terminal
> based things, but I feel it is a nice compromise for the
> capabilities/features that you get.

Any reason ipython can't use epydoc or some other tool to format the  
markup in ascii (I forget if epydoc does ascii output) so that the  
user doesn't see the 'line noise' when using the ipython  
introspection features?

Perry




More information about the SciPy-user mailing list