On May 26, 7:39 am, "Edward K. Ream" <[email protected]> wrote:

> epydoc...looks good to me.

Some other smallish problems:

1.  Apparently, to get a proper toc one must process all the files
together.
    This could take a *long* time.  I'll see if there is a way to
avoid doing that...

2.  epydoc recommended that source files start with::

    __docformat__ = "restructuredtext en"

Alternatively, one can use the --docformat=restructuredtext command-
line format.  Theoretically, the __docformat__ spec is more flexible,
but in practice Leo's help-for-command command demands that all
docstrings be rST, so the command-line arg should suffice.

3. epydoc is picky about docstring formatting, even with docstring
checking, so a bit of copy-editing will be necessary.  I'll be doing
that today.

Edward

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/leo-editor?hl=en.

Reply via email to