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])
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 you configure.ac script. This allows gtkdocize to automatically copy the macro definition for GTK_DOC_CHECK to your project.
AC_CONFIG_MACRO_DIR(m4)