I was talking to a friend of mine who said he took a look at the source
and he thought it lacked an overview, especially some sort of class
browser. I was going to write up an overview document, but it would
probably become outdated quickly.
So I took a look at the PERCEPS system. It still has some bugs (it didn't
make an index), but it did spit up some useful pages:
http://ethel.williams.edu/doc/HtHTTP.html
http://ethel.williams.edu/doc/Retriever.html
http://ethel.williams.edu/doc/List.html
In particular, any sort of code browser will require rewriting some
comments and making sure most key methods are commented.
Are there any better packages for this sort of thing? If we get something
that works for us, I could set the snapshot script to generate the
documenation for the current source.
Until that point, is it worthwhile to write up an overview by hand? The
comments could be reused later.
-Geoff
------------------------------------
To unsubscribe from the htdig3-dev mailing list, send a message to
[EMAIL PROTECTED] containing the single word "unsubscribe" in
the SUBJECT of the message.
