[Numpy-discussion] [SciPy-dev] Doc-day

[Stefan van der Walt]

On Fri, Dec 28, 2007 at 11:32:03AM -0600, Travis E. Oliphant wrote:
> I don't see the point in every file having a __docformat__ line, when 
> our documentaion formatting tool should already know the standard we are 
> using is.   It's just more cruft.   Besides the PEP was rejected, so I 
> don't know why we should be following it. 

Sorry, I didn't see the PEP was rejected.  Moot point, then.

> We obviously need a pre-processor to map our files to epydoc, so let's 
> do that instead of contorting docstrings into a format demanded by the 
> tool.

That's a good idea, thanks.  I'll take a look.

> It seems better to have docstrings than to have them fit into an 
> epydoc_-defined pattern.  

Certainly.

Thanks for the feedback.

Regards
Stéfan