[Doc-SIG] htmldoc.py and inspect.py

Ka-Ping Yee ping@lfw.org
Tue, 30 May 2000 09:59:33 -0700 (PDT)


On Tue, 30 May 2000, will wrote:
> If you change the arg-reading code in htmldoc.py to something along
> these lines, then you can do ool documentation on modules that import
> modules in other (non-standard) directories.

Right -- the "__main__" part of htmldoc.py was really just for
quick testing -- there needs to be a little more smarts there
about knowing the location of the modules and where to put the
generated files, etc.

> I'm looking into building a function to generate a toc as well.  So if
> you call:
> 
>    htmldoc.py -m /mud/server/ /mud/server/*.py

The "multicolumn" function is very handy for making the lists
in the TOC.  I've got stuff for making indexes that i'm working on.

> I'm impressed though.  So far it's been very easy to use.  Took me
> about 10 minutes to get it working with our project which right now
> spans a few directories and consists of almost a hundred different
> modules.

This is very good news.  Thanks for testing.

> So, in my opinion, apart from a few minor changes:

Your suggestions are well taken.  Thanks.


-- ?!ng

"To be human is to continually change.  Your desire to remain as you are
is what ultimately limits you."
    -- The Puppet Master, Ghost in the Shell