wip concept: move away from gtkdocize
Submitted by Allison (desrt)
Link to original bug (#744864)
Description
Here are some changes that should allow modules to move away from using gtkdocize.
Instead, you just need to add this in your docs/ Makefile.am:
if HAVE_GTK_DOC
include $(GTK_DOC_MAKEFILE)
dist-hook: # do not remove!
endif
in place of the normal hard-coded include.
Most of the disruption here is caused by the fact that the make fragment is no longer copied into the tree and is therefore no longer available at autoreconf time. That means that we have to port the Makefile from being an automake fragment to working in pure make.
The 'dist-hook:' hack is required because automake will fail to emit the hook at all if it doesn't see someone using it (and it won't see it in the included makefile, as mentioned above). It would be better to move away from using the dist hook entirely, but there are two complications:
-
it's not entirely clear what the role of gtkdoc-rebase is here or if it's even required anymore (it seems not to be)
-
it will be awkward to know which html files to install if those files did not exist when make was invoked (ie: if the user skips 'make' and just goes straight to 'make install')