On Tue, 7 Jun 2005, Lothar Scholz wrote:
Hello Andrew,
AT> As far as functionality goes Hugh mentioned call graphing, I guess that
AT> means showing that function X calls function Y which calls function Z?
Don't forget Class Hierarchy Graphs.
It does that if you have graphviz. -d option.
Avoiding that dependency doesn't have the cost/benefit of other
work, IMHO.
I think we should also go away from the idea to generate HTML files.
Instead we should run a rdoc server and generate documentation on
demand as this allows much better interaction and things like search
functionality. Choosing HTML was just a lazy on in my opinion an old
fashioned idea.
I beg to differ: HTML is pretty well universally useable; having it
static means it can just be placed on a server easily, and the
response times are better. People not in a position to run rdoc can
just download the (tgz|ZIP) of the docs. Dynamic facilities as well
would be good: like searching, ...um... not sure what else you'd do
with dynamic facilities!
Hugh
|