Blame m4/gtk-doc.m4

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