[Numpy-discussion] Docstring page, out of date?

Robert Kern robert.kern@gmail....
Tue Jan 22 00:08:14 CST 2008


David Cournapeau wrote:
> Nobody likes to write doc, specially if you have to follow many rules.
> Not being able to see the result does not help. I don't know much
> about the current documation tools situation with python, but I have
> seen good, automatically generated doc for python modules: for
> example, the current developement doc of python
> (http://docs.python.org/dev/) looks pretty good to me, and using the
> same tools as python makes more sense than forking our own, no ? Or am
> I missing something fundamental ?

Yes. Sphinx does not do automatically generated documentation.

-- 
Robert Kern

"I have come to believe that the whole world is an enigma, a harmless enigma
  that is made terrible by our own mad attempt to interpret it as though it had
  an underlying truth."
   -- Umberto Eco


More information about the Numpy-discussion mailing list