Blame m4/gtk-doc.m4

Packit fabffb
# -*- mode: autoconf -*-
Packit fabffb
#
Packit fabffb
# gtk-doc.m4 - configure macro to check for gtk-doc
Packit fabffb
# Copyright (C) 2003 James Henstridge
Packit fabffb
#               2007-2017  Stefan Sauer
Packit fabffb
#
Packit fabffb
# This program is free software: you can redistribute it and/or modify
Packit fabffb
# it under the terms of the GNU General Public License as published by
Packit fabffb
# the Free Software Foundation, either version 3 of the License, or
Packit fabffb
# (at your option) any later version.
Packit fabffb
#
Packit fabffb
# This program is distributed in the hope that it will be useful,
Packit fabffb
# but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit fabffb
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit fabffb
# GNU General Public License for more details.
Packit fabffb
#
Packit fabffb
# You should have received a copy of the GNU General Public License
Packit fabffb
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
Packit fabffb
#
Packit fabffb
# As a special exception, the above copyright owner gives unlimited
Packit fabffb
# permission to copy, distribute and modify the configure scripts that
Packit fabffb
# are the output of Autoconf when processing the Macro. You need not
Packit fabffb
# follow the terms of the GNU General Public License when using or
Packit fabffb
# distributing such scripts, even though portions of the text of the
Packit fabffb
# Macro appear in them. The GNU General Public License (GPL) does govern
Packit fabffb
# all other use of the material that constitutes the Autoconf Macro.
Packit fabffb
Packit fabffb
# serial 2
Packit fabffb
Packit fabffb
dnl Usage:
Packit fabffb
dnl   GTK_DOC_CHECK([minimum-gtk-doc-version])
Packit fabffb
AC_DEFUN([GTK_DOC_CHECK],
Packit fabffb
[
Packit fabffb
  AC_REQUIRE([PKG_PROG_PKG_CONFIG])
Packit fabffb
  AC_BEFORE([AC_PROG_LIBTOOL],[$0])dnl setup libtool first
Packit fabffb
  AC_BEFORE([AM_PROG_LIBTOOL],[$0])dnl setup libtool first
Packit fabffb
Packit fabffb
  ifelse([$1],[],[gtk_doc_requires="gtk-doc"],[gtk_doc_requires="gtk-doc >= $1"])
Packit fabffb
  AC_MSG_CHECKING([for gtk-doc])
Packit fabffb
  PKG_CHECK_EXISTS([$gtk_doc_requires],[have_gtk_doc=yes],[have_gtk_doc=no])
Packit fabffb
  AC_MSG_RESULT($have_gtk_doc)
Packit fabffb
Packit fabffb
  if test "$have_gtk_doc" = "no"; then
Packit fabffb
      AC_MSG_WARN([
Packit fabffb
  You will not be able to create source packages with 'make dist'
Packit fabffb
  because $gtk_doc_requires is not found.])
Packit fabffb
  fi
Packit fabffb
Packit fabffb
  dnl check for tools we added during development
Packit fabffb
  dnl Use AC_CHECK_PROG to avoid the check target using an absolute path that
Packit fabffb
  dnl may not be writable by the user. Currently, automake requires that the
Packit fabffb
  dnl test name must end in '.test'.
Packit fabffb
  dnl https://bugzilla.gnome.org/show_bug.cgi?id=701638
Packit fabffb
  AC_CHECK_PROG([GTKDOC_CHECK],[gtkdoc-check],[gtkdoc-check.test])
Packit fabffb
  AC_PATH_PROG([GTKDOC_CHECK_PATH],[gtkdoc-check])
Packit fabffb
  AC_PATH_PROGS([GTKDOC_REBASE],[gtkdoc-rebase],[true])
Packit fabffb
  AC_PATH_PROG([GTKDOC_MKPDF],[gtkdoc-mkpdf])
Packit fabffb
Packit fabffb
  dnl for overriding the documentation installation directory
Packit fabffb
  AC_ARG_WITH([html-dir],
Packit fabffb
    AS_HELP_STRING([--with-html-dir=PATH], [path to installed docs]),,
Packit fabffb
    [with_html_dir='${datadir}/gtk-doc/html'])
Packit fabffb
  HTML_DIR="$with_html_dir"
Packit fabffb
  AC_SUBST([HTML_DIR])
Packit fabffb
Packit fabffb
  dnl enable/disable documentation building
Packit fabffb
  AC_ARG_ENABLE([gtk-doc],
Packit fabffb
    AS_HELP_STRING([--enable-gtk-doc],
Packit fabffb
                   [use gtk-doc to build documentation [[default=no]]]),,
Packit fabffb
    [enable_gtk_doc=no])
Packit fabffb
Packit fabffb
  AC_MSG_CHECKING([whether to build gtk-doc documentation])
Packit fabffb
  AC_MSG_RESULT($enable_gtk_doc)
Packit fabffb
Packit fabffb
  if test "x$enable_gtk_doc" = "xyes" && test "$have_gtk_doc" = "no"; then
Packit fabffb
    AC_MSG_ERROR([
Packit fabffb
  You must have $gtk_doc_requires installed to build documentation for
Packit fabffb
  $PACKAGE_NAME. Please install gtk-doc or disable building the
Packit fabffb
  documentation by adding '--disable-gtk-doc' to '[$]0'.])
Packit fabffb
  fi
Packit fabffb
Packit fabffb
  dnl don't check for glib if we build glib
Packit fabffb
  if test "x$PACKAGE_NAME" != "xglib"; then
Packit fabffb
    dnl don't fail if someone does not have glib
Packit fabffb
    PKG_CHECK_MODULES(GTKDOC_DEPS, glib-2.0 >= 2.10.0 gobject-2.0  >= 2.10.0,,[:])
Packit fabffb
  fi
Packit fabffb
Packit fabffb
  dnl enable/disable output formats
Packit fabffb
  AC_ARG_ENABLE([gtk-doc-html],
Packit fabffb
    AS_HELP_STRING([--enable-gtk-doc-html],
Packit fabffb
                   [build documentation in html format [[default=yes]]]),,
Packit fabffb
    [enable_gtk_doc_html=yes])
Packit fabffb
    AC_ARG_ENABLE([gtk-doc-pdf],
Packit fabffb
      AS_HELP_STRING([--enable-gtk-doc-pdf],
Packit fabffb
                     [build documentation in pdf format [[default=no]]]),,
Packit fabffb
      [enable_gtk_doc_pdf=no])
Packit fabffb
Packit fabffb
  if test -z "$GTKDOC_MKPDF"; then
Packit fabffb
    enable_gtk_doc_pdf=no
Packit fabffb
  fi
Packit fabffb
Packit fabffb
  if test -z "$AM_DEFAULT_VERBOSITY"; then
Packit fabffb
    AM_DEFAULT_VERBOSITY=1
Packit fabffb
  fi
Packit fabffb
  AC_SUBST([AM_DEFAULT_VERBOSITY])
Packit fabffb
Packit fabffb
  AM_CONDITIONAL([HAVE_GTK_DOC], [test x$have_gtk_doc = xyes])
Packit fabffb
  AM_CONDITIONAL([ENABLE_GTK_DOC], [test x$enable_gtk_doc = xyes])
Packit fabffb
  AM_CONDITIONAL([GTK_DOC_BUILD_HTML], [test x$enable_gtk_doc_html = xyes])
Packit fabffb
  AM_CONDITIONAL([GTK_DOC_BUILD_PDF], [test x$enable_gtk_doc_pdf = xyes])
Packit fabffb
  AM_CONDITIONAL([GTK_DOC_USE_LIBTOOL], [test -n "$LIBTOOL"])
Packit fabffb
  AM_CONDITIONAL([GTK_DOC_USE_REBASE], [test -n "$GTKDOC_REBASE"])
Packit fabffb
])