I still don't understand what's going on here.
I made a small example that displays this issue's behaviour in a Github
repo, it should be reproducible, and the README gives (AFAIK) all the info
needed to understand the situation.
https://github.com/trosh/doxygen-struct-anchor-issue
Here's a copy of the README:
This is a pair of fake C projects, *low* and *high*, with *high* depending
on *low*. They each have a header file, which has a typedef to a struct and
a typedef to a pointer to that (all of this documented).
/** ... */
typedef struct {...} OBJECT_s;
/** ... */
typedef OBJECT_s * OBJECT_p;
That is not necessarily a practice I particularly condone, but valid C
nontheless.
Doxyfiles and Makefiles have been provided to generate the documentation
and tagfile for *low*, and the documentation for *high* using *low*'s
tagfile.
A simple call to make in this repo's root will make both docs, and should
hopefully reproduce the warning I am trying to understand / avoid / fix
when building the *high* doc.
low/doxygen.tag:26: warning: Unexpected tag `anchor' found
The mentioned line is the following:
23 <compound kind="struct">
24 <name>object</name>
25 <filename>low_8h.html</filename>
26 <anchor>structobject</anchor> <!-- CULPRIT LINE -->
27 <member kind="variable">
28 <type>int</type>
29 <name>val</name>
30 <anchorfile>low_8h.html</anchorfile>
To see how the Doxyfiles were made, I included references (made with doxygen
-g) and the differences can be displayed with a simple call to make
Doxyfile-diff which will call diff in both projects.
For info, these are the relevant changes at the time of writing this :
make -C low Doxyfile-diff
> INLINE_SIMPLE_STRUCTS = YES
> INPUT = .
> GENERATE_LATEX = NO
> GENERATE_TAGFILE = doxygen.tag
make -C high Doxyfile-diff
> INPUT = .
> GENERATE_LATEX = NO
> TAGFILES = ../low/doxygen.tag=../../low/html
Thanks for reading, and I really hope someone can shed some light into
what's going on :-)
> --
John Gliksberg
M2 MIHPS @ UVSQ
mobile : +33.6.40.60.76.95
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
