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

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 them is in

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
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. --