News for hackers. Stuff that matters.
Re:Clang based documentation generator for C and C++ by nathanpc on Wednesday February 13, 2013 @09:42AM (#5213246)
Awesome idea! I'll experiment with it in my projects. Doxygen is horrible, and looking at your example I can see it's far superior than Doxygen.
Re:Clang based documentation generator for C and C++ by apaprocki on Wednesday February 13, 2013 @10:06AM (#5213380)
That depends.. it would be more helpful to evaluate comparing to Doxygen if a more meaty C++ example was used. This is our std::vector implementation (below). The STL provides enough meat for any doc generator to chew on...

http://bloomberg.github.com/bsl/group__bslstl__vector.html

I'm no fan of Doxygen output, but it is used because it has proven to be the most robust for documenting complicated code.

edit: links

Re:Clang based documentation generator for C and C++ by jevinskie on Wednesday February 13, 2013 @11:18AM (#5213840)
Wow, I am green with envy after looking at those docs! I wish the LLVM/Clang doxygen was that nice. You are lucky if you get any comments at all.
Re:Clang based documentation generator for C and C++ by wladimir on Wednesday February 13, 2013 @10:13AM (#5213416)
Can you explain why you think that doxygen is horrible?
Re:Clang based documentation generator for C and C++ by nathanpc on Wednesday February 13, 2013 @10:18AM (#5213436)
The HTML output.
Re:Clang based documentation generator for C and C++ by wladimir on Wednesday February 13, 2013 @10:20AM (#5213450)
What is wrong with that?
Re:Clang based documentation generator for C and C++ by nathanpc on Wednesday February 13, 2013 @10:23AM (#5213460)
It looks like shit.
Re:Clang based documentation generator for C and C++ by wladimir on Wednesday February 13, 2013 @10:31AM (#5213509)
Did you know that the output can be customized in many ways, for example using CSS and templates? Many organizations use doxygen for their documentation, even though you wouldn't recognize it at first.

Also, whether the tool uses clang or a custom parser doesn't affect the HTML output in any way. I agree that using clang is interesting, but you seem to be depreciating Doxygen for all the wrong reasons.