added m4 macro to control documentation generation
authorladanyi
Mon, 18 Apr 2005 17:26:51 +0000
changeset 137076a3f46d361c
parent 1369 f1cf6b807414
child 1371 e1c99f5bdb3f
added m4 macro to control documentation generation
Makefile.am
config/misc.m4
configure.ac
doc/Doxyfile.in
     1.1 --- a/Makefile.am	Mon Apr 18 17:23:42 2005 +0000
     1.2 +++ b/Makefile.am	Mon Apr 18 17:26:51 2005 +0000
     1.3 @@ -1,10 +1,14 @@
     1.4  EXTRA_DIST = autopackage/default.apspec.in
     1.5  
     1.6 -SUBDIRS = src doc
     1.7 +if WANT_DOCS
     1.8 +  MAYBE_DOC = doc
     1.9 +endif
    1.10 +SUBDIRS = src $(MAYBE_DOC)
    1.11  
    1.12  MRPROPERFILES = \
    1.13  	aclocal.m4 \
    1.14  	config.h.in \
    1.15 +	config.h.in~ \
    1.16  	configure \
    1.17  	Makefile.in \
    1.18  	config/depcomp \
     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/config/misc.m4	Mon Apr 18 17:26:51 2005 +0000
     2.3 @@ -0,0 +1,28 @@
     2.4 +AC_DEFUN([LX_ENABLE_DOCS],
     2.5 +[
     2.6 +  AC_ARG_ENABLE([docs],
     2.7 +AS_HELP_STRING([--enable-docs@<:@=yes|no|full@:>@], [build the documentation (full enables internal documentation too) @<:@default=yes@:>@])
     2.8 +AS_HELP_STRING([--disable-docs], [do not build the documentation]),
     2.9 +         [], [enable_docs=yes])
    2.10 +
    2.11 +  AC_MSG_CHECKING([whether to build the documention])
    2.12 +  case "$enable_docs" in
    2.13 +    yes)
    2.14 +      DOXYGEN_INTERNAL_DOCS=NO
    2.15 +      AC_MSG_RESULT([yes])
    2.16 +      ;;
    2.17 +    full)
    2.18 +      DOXYGEN_INTERNAL_DOCS=YES
    2.19 +      AC_MSG_RESULT([full])
    2.20 +      ;;
    2.21 +    no)
    2.22 +      DOXYGEN_INTERNAL_DOCS=NO
    2.23 +      AC_MSG_RESULT([no])
    2.24 +      ;;
    2.25 +    *)
    2.26 +      AC_MSG_ERROR([bad value $enable_docs for option --enable-docs])
    2.27 +      ;;
    2.28 +  esac
    2.29 +  AC_SUBST(DOXYGEN_INTERNAL_DOCS)
    2.30 +  AM_CONDITIONAL([WANT_DOCS], [test x"$enable_docs" != x"no"])
    2.31 +])
     3.1 --- a/configure.ac	Mon Apr 18 17:23:42 2005 +0000
     3.2 +++ b/configure.ac	Mon Apr 18 17:26:51 2005 +0000
     3.3 @@ -26,6 +26,8 @@
     3.4  dnl Checks for libraries.
     3.5  LX_CHECK_GLPK
     3.6  
     3.7 +LX_ENABLE_DOCS
     3.8 +
     3.9  dnl Checks for header files.
    3.10  AC_CHECK_HEADERS(limits.h sys/time.h sys/times.h unistd.h)
    3.11  
     4.1 --- a/doc/Doxyfile.in	Mon Apr 18 17:23:42 2005 +0000
     4.2 +++ b/doc/Doxyfile.in	Mon Apr 18 17:26:51 2005 +0000
     4.3 @@ -278,7 +278,7 @@
     4.4  # to NO (the default) then the documentation will be excluded. 
     4.5  # Set it to YES to include the internal documentation.
     4.6  
     4.7 -INTERNAL_DOCS          = NO
     4.8 +INTERNAL_DOCS          = @DOXYGEN_INTERNAL_DOCS@
     4.9  
    4.10  # If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate 
    4.11  # file names in lower-case letters. If set to YES upper-case letters are also