Excellent work, this greatly improves the clarity of the generated docs.<div><br></div><div>I would love it if the inheritance diagrams were kept as they are and</div><div>the collaboration diagrams were hidden under a knob.</div>
<div><br></div><div>Thanks,</div><div>John<br><br><div class="gmail_quote">On Fri, Apr 30, 2010 at 8:54 AM, mike-m <span dir="ltr"><<a href="mailto:mikem.llvm@gmail.com">mikem.llvm@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Hi, I'm working on a patch to overhaul docs+doxygen builds for both llvm and clang source trees.<br>
<br>
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.<br>

<br>
NEW: <a href="http://kona.zzl.org/clang/api/classclang_1_1driver_1_1Action.html" target="_blank">http://kona.zzl.org/clang/api/classclang_1_1driver_1_1Action.html</a><br>
OLD: <a href="http://clang.llvm.org/doxygen/classclang_1_1driver_1_1Action.html" target="_blank">http://clang.llvm.org/doxygen/classclang_1_1driver_1_1Action.html</a><br>
<br>
class with more inheritance: <a href="http://kona.zzl.org/clang/api/classclang_1_1Decl.html" target="_blank">http://kona.zzl.org/clang/api/classclang_1_1Decl.html</a><br>
class with a rather large collaboration diagram: <a href="http://kona.zzl.org/clang/api/classclang_1_1ASTContext.html" target="_blank">http://kona.zzl.org/clang/api/classclang_1_1ASTContext.html</a><br>
<br>
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.<br>

<br>
Comments and suggestions are solicited!<br>
<br>
(patches for this are being tracked with pr6613).<br>
<br>
--mike-m<br>
<br>
<br>
_______________________________________________<br>
LLVM Developers mailing list<br>
<a href="mailto:LLVMdev@cs.uiuc.edu">LLVMdev@cs.uiuc.edu</a>         <a href="http://llvm.cs.uiuc.edu" target="_blank">http://llvm.cs.uiuc.edu</a><br>
<a href="http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev" target="_blank">http://lists.cs.uiuc.edu/mailman/listinfo/llvmdev</a><br>
</blockquote></div><br></div>