build-sys: Configure doxygen.conf.in a bit differently
authorTanu Kaskinen <tanuk@iki.fi>
Mon, 10 Aug 2020 16:38:07 +0000 (19:38 +0300)
committerTanu Kaskinen <tanuk@iki.fi>
Mon, 10 Aug 2020 16:38:07 +0000 (19:38 +0300)
This change prepares for adding a doxygen target to the Meson build
system. The DOXYGEN_OUTPUT_DIRECTORY substitution variable is needed so
that the output will go to the build directory. I also replaced @srcdir@
with @top_srcdir@. I think it looks cleaner, since the ".." parent
directory traversal is avoided. It also happened to make writing the
Meson rules easier.

configure.ac
doxygen/doxygen.conf.in

index b96bf28..8b2d631 100644 (file)
@@ -1552,6 +1552,13 @@ fi
 
 AM_CONDITIONAL([FORCE_PREOPEN], [test "x$FORCE_PREOPEN" = "xyes"])
 
+# Substitute the variable with an empty string. This makes the output go to the
+# directory where doxygen is run (which is the doxygen directory under the
+# build directory). Substituting a variable with a constant value wouldn't
+# otherwise make sense, but the substitution variable needs to exist, because
+# we substitute a different value when using Meson.
+AC_SUBST([DOXYGEN_OUTPUT_DIRECTORY], [])
+
 AC_CONFIG_FILES([
 Makefile
 src/Makefile
index c195e7b..a97c165 100644 (file)
@@ -52,7 +52,7 @@ PROJECT_LOGO           =
 # If a relative path is entered, it will be relative to the location
 # where doxygen was started. If left blank the current directory will be used.
 
-OUTPUT_DIRECTORY       =
+OUTPUT_DIRECTORY       = @DOXYGEN_OUTPUT_DIRECTORY@
 
 # If the CREATE_SUBDIRS tag is set to YES, then doxygen will create
 # 4096 sub-directories (in 2 levels) under the output directory of each output
@@ -668,37 +668,37 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories
 # with spaces.
 
-INPUT                  = @srcdir@/../src/pulse/channelmap.h \
-                         @srcdir@/../src/pulse/context.h \
-                         @srcdir@/../src/pulse/def.h \
-                         @srcdir@/../src/pulse/direction.h \
-                         @srcdir@/../src/pulse/error.h \
-                         @srcdir@/../src/pulse/ext-stream-restore.h \
-                         @srcdir@/../src/pulse/ext-device-manager.h \
-                         @srcdir@/../src/pulse/ext-device-restore.h \
-                         @srcdir@/../src/pulse/format.h \
-                         @srcdir@/../src/pulse/gccmacro.h \
-                         @srcdir@/../src/pulse/glib-mainloop.h \
-                         @srcdir@/../src/pulse/introspect.h \
-                         @srcdir@/../src/pulse/mainloop-api.h \
-                         @srcdir@/../src/pulse/mainloop-signal.h \
-                         @srcdir@/../src/pulse/mainloop.h \
-                         @srcdir@/../src/pulse/operation.h \
-                         @srcdir@/../src/pulse/proplist.h \
-                         @srcdir@/../src/pulse/pulseaudio.h \
-                         @srcdir@/../src/pulse/rtclock.h \
-                         @srcdir@/../src/pulse/sample.h \
-                         @srcdir@/../src/pulse/scache.h \
-                         @srcdir@/../src/pulse/simple.h \
-                         @srcdir@/../src/pulse/stream.h \
-                         @srcdir@/../src/pulse/subscribe.h \
-                         @srcdir@/../src/pulse/thread-mainloop.h \
-                         @srcdir@/../src/pulse/timeval.h \
-                         @srcdir@/../src/pulse/utf8.h \
-                         @srcdir@/../src/pulse/util.h \
-                         @srcdir@/../src/pulse/version.h \
-                         @srcdir@/../src/pulse/volume.h \
-                         @srcdir@/../src/pulse/xmalloc.h
+INPUT                  = @top_srcdir@/src/pulse/channelmap.h \
+                         @top_srcdir@/src/pulse/context.h \
+                         @top_srcdir@/src/pulse/def.h \
+                         @top_srcdir@/src/pulse/direction.h \
+                         @top_srcdir@/src/pulse/error.h \
+                         @top_srcdir@/src/pulse/ext-stream-restore.h \
+                         @top_srcdir@/src/pulse/ext-device-manager.h \
+                         @top_srcdir@/src/pulse/ext-device-restore.h \
+                         @top_srcdir@/src/pulse/format.h \
+                         @top_srcdir@/src/pulse/gccmacro.h \
+                         @top_srcdir@/src/pulse/glib-mainloop.h \
+                         @top_srcdir@/src/pulse/introspect.h \
+                         @top_srcdir@/src/pulse/mainloop-api.h \
+                         @top_srcdir@/src/pulse/mainloop-signal.h \
+                         @top_srcdir@/src/pulse/mainloop.h \
+                         @top_srcdir@/src/pulse/operation.h \
+                         @top_srcdir@/src/pulse/proplist.h \
+                         @top_srcdir@/src/pulse/pulseaudio.h \
+                         @top_srcdir@/src/pulse/rtclock.h \
+                         @top_srcdir@/src/pulse/sample.h \
+                         @top_srcdir@/src/pulse/scache.h \
+                         @top_srcdir@/src/pulse/simple.h \
+                         @top_srcdir@/src/pulse/stream.h \
+                         @top_srcdir@/src/pulse/subscribe.h \
+                         @top_srcdir@/src/pulse/thread-mainloop.h \
+                         @top_srcdir@/src/pulse/timeval.h \
+                         @top_srcdir@/src/pulse/utf8.h \
+                         @top_srcdir@/src/pulse/util.h \
+                         @top_srcdir@/src/pulse/version.h \
+                         @top_srcdir@/src/pulse/volume.h \
+                         @top_srcdir@/src/pulse/xmalloc.h
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is