Re: What tools are used to write and generate Python Librarydocumentation.

2005-09-27 Thread Robert Kern
Brett Hoerner wrote: > You get to spend all day in ipython? > > Can I have your job? Well, I use the terms "work" and "day" rather loosely. I'm a graduate student in geophysics. Somehow it rarely happens during daylight hours and quite possibly wouldn't be called working by an outside observer.

Re: What tools are used to write and generate Python Librarydocumentation.

2005-09-27 Thread Brett Hoerner
You get to spend all day in ipython? Can I have your job? -- http://mail.python.org/mailman/listinfo/python-list

Re: What tools are used to write and generate Python Librarydocumentation.

2005-09-27 Thread Robert Kern
Fredrik Lundh wrote: > Kenneth McDonald wrote: > >>More seriously, there is a major problem with docstrings in that they >>can only document something that has a docstring; classes, functions, >>methods, and modules. But what if I have constants that are >>important? The only place to document the

Re: What tools are used to write and generate Python Librarydocumentation.

2005-09-27 Thread Fredrik Lundh
Kenneth McDonald wrote: > More seriously, there is a major problem with docstrings in that they > can only document something that has a docstring; classes, functions, > methods, and modules. But what if I have constants that are > important? The only place to document them is in the module > docs