[LLVMdev] doxygen tag files

Philip Ashmore
Sat, 29 Sep 2012 03:28:07 -0000

Hi there.

I did a quick Google search for this topic in the mailing lists -
apologies if this has popped up before.

I intend to use LLVM with one of my projects and I noticed that
currently the LLVM build process doesn't generate doxygen tag files.

My projects all generate tag files and refer to the tag files of
projects they use.

I've modified a recent revision (164864) to
1. group html files into directories
2. generate a tag file
3. copy the files en-masse into $(DESTDIR)$(PROJ_docsdir)/doxygen,
including llvm.tag
4. change the file attributes in-place

See the attached patch that does this.

The only problem I'm stuck with is how to get the sub-projects to use
the tag file.
This would need a change that builds the LLVM docs + tag file (llvm.tag)
before generating the doxygen documentation of projects that use it.

This is complicated by the opportunity for tools like clang to also
generate tag files.
Then there's the issue of defining dependency relationships between the
various projects, so they could refer to the other projects tag files.

This dependency information must be there already since they get built
in the correct order.

Any pointers?

Regards,
Philip Ashmore
-------------- next part --------------
A non-text attachment was scrubbed...
Name: llvm-tag.patch
Type: text/x-patch
Size: 1861 bytes
Desc: not available
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20120929/d31f197d/attachment.bin>