Christian Weisgerber
2025-Feb-14 20:04 UTC
[flac-dev] 1.5.0: API documentation is not installed
When FLAC 1.5.0 is built with GNU autotools, the API documentation that is included in the release tarball is not installed. This is due to this check in configure.ac: if test ! -n "$DOXYGEN" && test -f "$srcdir/doc/FLAC.tag" && test -f "$srcdir/doc/api/modules.html" ; then HAS_PREBUILT_DOXYGEN=yes fi AM_CONDITIONAL(FLaC__HAS_PREBUILT_DOXYGEN, test "x$HAS_PREBUILT_DOXYGEN" = xyes) There is no file doc/api/modules.html. Has something changed with doxygen? -- Christian "naddy" Weisgerber naddy at mips.inka.de
Good catch. Yes, it seems that newer doxygen versions call this file topics.html instead. On February 14, 2025 12:04:44?p.m. PST, Christian Weisgerber <naddy at mips.inka.de> wrote:>When FLAC 1.5.0 is built with GNU autotools, the API documentation >that is included in the release tarball is not installed. > >This is due to this check in configure.ac: > > if test ! -n "$DOXYGEN" && test -f "$srcdir/doc/FLAC.tag" && test -f "$srcdir/doc/api/modules.html" ; then > HAS_PREBUILT_DOXYGEN=yes > fi > AM_CONDITIONAL(FLaC__HAS_PREBUILT_DOXYGEN, test "x$HAS_PREBUILT_DOXYGEN" = xyes) > >There is no file doc/api/modules.html. Has something changed with >doxygen? > >-- >Christian "naddy" Weisgerber naddy at mips.inka.de >_______________________________________________ >flac-dev mailing list >flac-dev at xiph.org >http://lists.xiph.org/mailman/listinfo/flac-dev-r -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.xiph.org/pipermail/flac-dev/attachments/20250214/eb0faf59/attachment.htm>
Christian Weisgerber
2025-Feb-14 20:46 UTC
[flac-dev] 1.5.0: API documentation is not installed
Christian Weisgerber:> There is no file doc/api/modules.html. Has something changed with > doxygen?So a quick web search finds this: Due to the implementation of C++ modules the name "modules" is now used for the C++ modules. The old "modules" has been renamed to "topics". https://github.com/doxygen/doxygen/issues/10562 Note that api/modules.html is explicitly referenced from api/index.html, which is generated from include/FLAC/all.h. There are various references to "modules" throughout include/FLAC{,++}/*.h. Some of this might need updating. For the configure check, I suggest probing for index.html: -if test ! -n "$DOXYGEN" && test -f "$srcdir/doc/FLAC.tag" && test -f "$srcdir/doc/api/modules.html" ; then +if test ! -n "$DOXYGEN" && test -f "$srcdir/doc/FLAC.tag" && test -f "$srcdir/doc/api/index.html" ; then -- Christian "naddy" Weisgerber naddy at mips.inka.de