This snippet comes from gtk-doc 1.18 examples/Makefile.am; we might want
to update all of the file but that's not strictly necessary.
https://bugs.freedesktop.org/show_bug.cgi?id=63479
# Extra options to supply to gtkdoc-scan
SCAN_OPTIONS=--ignore-headers=config.h
-# The directory containing the source code. Relative to $(srcdir)
-DOC_SOURCE_DIR=../../src
+# Directories containing the source code.
+# gtk-doc will search all .c and .h files beneath these paths
+# for inline comments documenting functions and macros.
+# e.g. DOC_SOURCE_DIR=$(top_srcdir)/gtk $(top_srcdir)/gdk
+DOC_SOURCE_DIR=$(top_srcdir)/src
# Used for dependencies
HFILE_GLOB=$(top_srcdir)/src/polkit*/*.h