<div dir="auto">I second David's statements. <div dir="auto"><br><div dir="auto">IMHO, sophisticated tools like Doxygen provides just a platform to document but as developers we have to *document*. We should follow a strict practice of documentation for each part of the code we write. Until this happens, no tool will ever help (unless its AI based which can automagically generate comments!)</div><div dir="auto">If we follow such practice even code comments would be useful.</div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Aug 24, 2020, 10:28 PM David Greene via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org">llvm-dev@lists.llvm.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Nicolai Hähnle via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org" target="_blank" rel="noreferrer">llvm-dev@lists.llvm.org</a>> writes:<br>
<br>
> Though perhaps a first question to ask is to what extent people use<br>
> Doxygen on the C++ part of LLVM today :)<br>
<br>
I personally only use it on very rare occasion, mostly because it's kind<br>
of unwieldy (difficult to navigate, search, etc.).  I have hopes that<br>
maybe clang-doc will get to a better place but of course that wouldn't<br>
work on .td files.<br>
<br>
I'm much more likely to just look through comments in code because I'm<br>
already in my editor and it's easy to pull up a file I need.  Before<br>
working on a new documentation tool for .td files I'd prefer we just<br>
comment them better.<br>
<br>
                    -David<br>
_______________________________________________<br>
LLVM Developers mailing list<br>
<a href="mailto:llvm-dev@lists.llvm.org" target="_blank" rel="noreferrer">llvm-dev@lists.llvm.org</a><br>
<a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
</blockquote></div>