Integration with autoconf
Very easy! Just add one line to your configure.ac script.
# check for gtk-doc GTK_DOC_CHECK([1.14],[--flavour no-tmpl])
This will require all developers to have gtk-doc installed. If it is okay for your project to have optional api-doc build setup, you can solve this as below. Keep it as is, as gtkdocize is looking for GTK_DOC_CHECK at the start of a line.
# check for gtk-doc m4_ifdef([GTK_DOC_CHECK], [ GTK_DOC_CHECK([1.14],[--flavour no-tmpl]) ],[ AM_CONDITIONAL([ENABLE_GTK_DOC], false) ])
The first argument is used to check for the gtkdocversion at configure time. The 2nd, optional argument is used by gtkdocize. The GTK_DOC_CHECK macro also adds several configure switches:
- --with-html-dir=PATH : path to installed docs
- --enable-gtk-doc : use gtk-doc to build documentation [default=no]
- --enable-gtk-doc-html : build documentation in html format [default=yes]
- --enable-gtk-doc-pdf : build documentation in pdf format [default=no]
GTK-Doc is disabled by default! Remember to pass the option '--enable-gtk-doc' to the next configure run. Otherwise pregenerated documentation is installed (which makes sense for users but not for developers).
Furthermore it is recommended that you have the following line inside your configure.ac script. This allows gtkdocize to automatically copy the macro definition for GTK_DOC_CHECK to your project.
After all changes to configure.ac are made, update the configure file. This can be done by re-running autoreconf -i or autogen.sh.