<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi there,<div class=""><br class=""></div><div class=""><div class="">I’m working on a feature for querying and returning documentation data in a libclang-based code comprehension engine (ycmd - <a href="https://github.com/Valloric/ycmd" class="">https://github.com/Valloric/ycmd</a> ). The idea is, for a given cursor, return meaningful documentation for display to a user in their IDE (i.e. “What is the doxygen documentation for the method under my cursor?” ).</div><div class=""><br class=""></div><div class="">I have found that there is quite rich support for doxygen comment parsing within clang, and most (all?) of it is exposed in libclang. This is awesome! Thanks!</div><div class=""><br class=""></div><div class="">However, I do have a few questions about the current level of support:</div><div class=""><br class=""></div><div class="">1. The “comment introspection” API is not listed (here: <a href="http://clang.llvm.org/doxygen/modules.html" class="">http://clang.llvm.org/doxygen/modules.html</a>) as part of “libclang”. Does that mean that the API is not public or not stable in some way? The docs say “<span style="font-size: 13px; line-height: 16px;" class="">These facilities are distinct from the core and may be subject to their own schedule of stability and deprecation</span><font size="2" class=""><span style="line-height: 16px;" class="">”… I’m just curious as to how much this is likely to be an issue?</span></font></div><div class=""><font size="2" class=""><span style="line-height: 16px;" class=""><br class=""></span></font></div><div class=""><font size="2" class=""><span style="line-height: 16px;" class="">2. Is there any way via libclang to get the raw text, or any other pretty-printed text, of a particular declaration? The idea here is that I could present the declaration text, followed by its brief and any other documentation. The declaration text itself is probably the most useful documentation for a developer :).Currently I am actually getting this by calling clang_FullComment_getAsXML() and parsing the output to get the “<Declaration>” element, but that seems painfully wasteful.</span></font></div><div class=""><span style="font-size: 13px; line-height: 16px;" class=""><br class=""></span></div><div class=""><span style="font-size: 13px; line-height: 16px;" class="">3. I guess finally, do you have any other thoughts or has anyone approached this before or know of an implementation doing this sort of thing, etc. Any feedback would be greatly appreciated. :) </span><span style="font-size: 13px; line-height: 16px;" class="">If anyone is interested, a quick demo is here: </span><font size="2" class=""><span style="line-height: 16px;" class=""><a href="http://www.gfycat.com/AlertNarrowAntelopegroundsquirrel" class="">http://www.gfycat.com/AlertNarrowAntelopegroundsquirrel</a></span></font></div><div class=""><font size="2" class=""><span style="line-height: 16px;" class=""><br class=""></span></font></div><div class=""><font size="2" class=""><span style="line-height: 16px;" class="">Many thanks,</span></font></div><div class=""><font size="2" class=""><span style="line-height: 16px;" class="">Ben</span></font></div></div><div class=""><font size="2" class=""><span style="line-height: 16px;" class=""><br class=""></span></font></div><div class=""><font size="2" class=""><span style="line-height: 16px;" class="">P.S. </span></font>Apologies if this list is not for this sort of query :/</div></body></html>