Re: [Numpy-discussion] Finalising documentation guidelines for NumPy

2007-07-17 Thread Stefan van der Walt
On Tue, Jul 17, 2007 at 01:58:24PM -0400, Alan G Isaac wrote: > On Tue, 17 Jul 2007, Stefan van der Walt apparently wrote: > >var1 : > >Description. > >breaks. This can be fixed either by omitting the colon after > >'var1' in the second case, or by slightly modifying epydoc's o

Re: [Numpy-discussion] Finalising documentation guidelines for NumPy

2007-07-17 Thread Alan G Isaac
On Tue, 17 Jul 2007, Stefan van der Walt apparently wrote: >var1 : >Description. >breaks. This can be fixed either by omitting the colon after >'var1' in the second case, or by slightly modifying epydoc's output. It breaks semantically too, no? (The colon is a separator, separ

[Numpy-discussion] Finalising documentation guidelines for NumPy

2007-07-17 Thread Stefan van der Walt
Hi all, In May this year, Charles Harris posted to this mailing list http://thread.gmane.org/gmane.comp.python.numeric.general/15381/focus=15407 discussing some shortcomings of the current NumPy (and hence SciPy) documentation standard http://projects.scipy.org/scipy/numpy/browser/trunk/numpy/d