[SciPy-dev] module docstrings
Sat Oct 31 15:02:35 CDT 2009
Ralf Gommers <ralf.gommers <at> googlemail.com> writes:
> On Sat, Oct 31, 2009 at 2:21 AM, Charles R Harris
<charlesr.harris <at> gmail.com> wrote:
> On Sun, Oct 25, 2009 at 5:58 AM, Ralf Gommers
<ralf.gommers <at> googlemail.com> wrote:
> I like routine listings....
MATLAB has a default behavior for documenting a directory on the path when
you don't have a Contents.m in that directory: it pulls the "H1" line (first
line of the M-file's help) from each M-file and lists those for you.
But the Contents.m usually was nicely formatted and grouped according
to function, with a list of each M-file with a 1-line summary.
I kind of like a listing too, but not all functions in all modules warrant
listing at the module level - there is an asymmetry problem.
More information about the Scipy-dev