[LLVMdev] doxygen redux

[Chris Lattner]

On Apr 30, 2010, at 7:54 AM, mike-m wrote:

> Hi, I'm working on a patch to overhaul docs+doxygen builds for both llvm and clang source trees.
> 
> Here's a sample of what it looks like for class clang::driver::Action (sorry, llvm API docs are a bigger set so only clang has been posted at this free webhost). Basically the output is a bump to latest doxygen plus custom css; the wins (IMHO) are the new style doesn't waste so much vertical page space, and uses slightly smaller fonts for both diagrams and html.
> 
> NEW: http://kona.zzl.org/clang/api/classclang_1_1driver_1_1Action.html
> OLD: http://clang.llvm.org/doxygen/classclang_1_1driver_1_1Action.html
> 
> class with more inheritance: http://kona.zzl.org/clang/api/classclang_1_1Decl.html
> class with a rather large collaboration diagram: http://kona.zzl.org/clang/api/classclang_1_1ASTContext.html
> 
> I'm not sure how the project/community feels about collab-diagrams. I find them exceedingly large and rarely useful. There are a couple of options if changes in that area are desired: (1) disable collab-diagrams. (2) make both class-inheritance and collab-diagrams hidden under a javascript-knob which users can click to expand each diagram.

I think this looks *much* nicer, and I also agree that the collab diagram is useless.  I'd be in favor of #1, but I do find the inheritance diagram to be useful.  We'll need to upgrade doxygen on the server to install this, but I think it would be a great improvement!

-Chris