Open Clang Project : Document Generation tool with Clang

Clang Frontend
1

Hello,

I have read about this open project on clang open project page.

What would be the advantage of using clang libs to implement doxygen like tool ? I mean is there any use-case that are not implemented in doxygen but with clang it can be implemented. Could some one explain this in a bit detail ?

I am currently experimenting with libClang to generate documents from Objective-C (via comments like doxygen ) but my hunch is that generating docs for C++ would be more difficult.

Sincerely,

2

Hi Vivek,

As for me, I Doxygen’s parser seems to fall out of line too often. For example, you may find many invalid SLoc references while browsing the online Clang and LLVM documentation generated by Doxygen. Using a proper parser for the documentation generation seems like a great idea, so Clang’s parsing seems to be a reasonable choice.

By the way, I am a GSoC 2015 student myself, don’t hesitate to ping me if you have any questions regarding GSoC.

3

Hi,

maybe it would be interesting for you to have
a look at DoxyPress which can be set to use
Clang for parsing.

http://www.copperspice.com/documentation-clang.html

-Alex

4

vivek pandya via cfe-dev <cfe-dev@...> writes:

Hello,
I have read about this open project on clang open project page.
What would be the advantage of using clang libs to implement doxygen like
tool ? I mean is there any use-case that are not implemented in doxygen but
with clang it can be implemented. Could some one explain this in a bit

detail ?

I am currently experimenting with libClang to generate documents from
Objective-C (via comments like doxygen ) but my hunch is that generating
docs for C++ would be more difficult.
Sincerely,

Vivek Pandya
P.S : I would like to apply for this project in GSoC 2016. How important
is it for clang community.

We are currently in the process of integrating libclang with DoxyPress for
C++ parsing in lieu of the current lex based parser. We are very interested
in having other developers participate in this process.

If you or anyone else would like to work with us directly or through GSoC
2016 we would be very interested.

Barbara
DoxyPress Co-founder