flac dev - Feb 2025 - 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:
> 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