Download Firefox: WindowsMac OS X
logo       
Google Custom Search
    AddThis Social Bookmark Button

Re: Could Ruby-doc be better? -- Proposal for a better system.: msg#00007

Subject: Re: Could Ruby-doc be better? -- Proposal for a better system.
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




<Prev in Thread] Current Thread [Next in Thread>