[LLVMdev] doxygen redux

[Tanya Lattner]

On Apr 30, 2010, at 8:55 AM, Chris Lattner wrote:

> 
> 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!
> 

Yes, I think the inheritance diagram should stay. But it looks great!

-Tanya