Doxygen documentation isn't updated for clang-tools-extra

Clang Frontend
1

Hi Anton, Tanya,

Not sure who is the right person to help me with this, but I was pointed to you.

The http://clang.llvm.org/extra/doxygen/ page says “Generated on Thu Aug 29 2013 19:05:49 for clang-tools-extra by Doxygen 1.7.5.1”. Can it be rebuilt automatically similar to http://clang.llvm.org/doxygen/?

Thanks!

– Alex

2

Ping.

Also, after the removal of Makefiles the Sphinx documentation stopped being updated on clang.llvm.org/extra as well. Who’s the right person to fix this?

3

It’s me. I will try to get it done today.

-Tanya

4

Just an update. I needed to fix up the script for all doxygen generation to move to cmake. I’m doing some tests to confirm I have everything right and will turn on the nightly build again tonight but will update you again once I feel its running smoothly for a few nights.

-Tanya

5

Just an update. I needed to fix up the script for all doxygen generation
to move to cmake.

A reminder: it's not only doxygen, the Sphinx documentation doesn't get
built since the Makefile removal (e.g. the latest version of the source
.rst file for this page
<http://clang.llvm.org/extra/clang-tidy/checks/cppcoreguidelines-pro-bounds-array-to-pointer-decay.html&gt;
doesn't
mention `array_view`).

I’m doing some tests to confirm I have everything right and will turn on
the nightly build again tonight but will update you again once I feel its
running smoothly for a few nights.

Thank you!

-- Alex

6

Yes, I will update that as well. I will let you know when it is completed.

Thanks,
Tanya

7

Also it would be nice to have an ability to download generated docs as it was some time ago! Especially I’m interested in libclang API…

Thanks.

8

The doxygen for 3.7 are available for download at
http://llvm.org/releases/download.html#3.7.0, and for 3.8.0 the
clang-tools-extra doxygen will be included too.

For libclang specifically, I think
clang_doxygen-3.7.0/group__CINDEX.html is the right file.

Thanks,
Hans

9

Just an update. I needed to fix up the script for all doxygen generation
to move to cmake.

A reminder: it's not only doxygen, the Sphinx documentation doesn't get
built since the Makefile removal (e.g. the latest version of the source
.rst file for this page
<http://clang.llvm.org/extra/clang-tidy/checks/cppcoreguidelines-pro-bounds-array-to-pointer-decay.html&gt; doesn't
mention

`array_view`).

Yes, I will update that as well. I will let you know when it is completed.

Any news here? :wink:

10

sphinx documentation update is working for all modules with sphinx support with the following exceptions:
libcxx; error during generation of html docs
lnt: error during generation as well
cfe-analyzer: no makefile option for cfe-analyzer docs that I see but could be missing configure flag (still investigating).

-Tanya

11

I’ve checked that clang-tools-extra sphinx docs are recompiled automatically now. Thank you!