<div dir="ltr">On Sat, Dec 22, 2012 at 4:16 AM, Karl Rupp <span dir="ltr"><<a href="mailto:rupp@mcs.anl.gov" target="_blank">rupp@mcs.anl.gov</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
Hey,<div class="im"><br>
<br>
> This feature is cool<br>
><br>
> <a href="http://llvm.org/releases/3.2/docs/ClangReleaseNotes.html" target="_blank">http://llvm.org/releases/3.2/<u></u>docs/ClangReleaseNotes.html</a><br>
<br></div>
somewhat ;-) I don't see how/why it is better than<br>
$> doxygen | grep warning<br>
(or any other tool with similar purpose).<br></blockquote><div><br></div><div style>Doxygen has full semantic understanding of the body of functions, including ability to trace through function calls within a compilation unit to determine whether the argument usage matches its declaration? I never thought it was that sophisticated.</div>
<div style><br></div><div style>Is there a way to make Doxygen provide "used from" (especially examples) and two-way cross-references (.seealso is one-way)? What about organizing functions by "level" or some other tag? I'm not a fan of sowing, but I have a yet to see doxygen-generated man pages that were really more useful.</div>
<div style><br></div><div style>Also, do you know a way to render an HTML version of a user's manual (written in LaTeX, reStructuredText, or some other markup) that can be robustly cross-referenced with the man pages? PETSc's LaTeX preprocessing gets us one direction (click on function name in PDF to get man page), but lack of the other direction is a serious problem in my opinion. A I'd really like to have the man page -> user's manual links created automatically (anywhere the function is mentioned in the user's manual, just like the index), but also support explicit links from the body of the man page.</div>
<div style><br></div><div style>The closest thing I've seen is breathe (<a href="http://michaeljones.github.com/breathe/">http://michaeljones.github.com/breathe/</a>) which tries to combine doxygen and sphinx, but development has slowed and it's still kinda rough.</div>
</div></div></div>