diff options
author | Guillem Jover <guillem@debian.org> | 2015-10-30 02:35:00 +0100 |
---|---|---|
committer | Guillem Jover <guillem@debian.org> | 2015-12-12 21:57:29 +0100 |
commit | f3af91bcb364140590ed3736f562dfe849bb6b72 (patch) | |
tree | e57263b91612e517c59f1f07a7c99ddb66bf73a3 | |
parent | c5e8c926397056044711ee9649d74c5dda2f21dc (diff) | |
download | dpkg-f3af91bcb364140590ed3736f562dfe849bb6b72.tar.gz |
build: Add an configure option to choose the kind of documentation
The option --disable-devel-docs can be used to override the current
default, which is to build development documentation.
-rw-r--r-- | configure.ac | 2 | ||||
-rw-r--r-- | debian/changelog | 2 | ||||
-rw-r--r-- | doc/Doxyfile.in | 6 | ||||
-rw-r--r-- | m4/dpkg-build.m4 | 17 |
4 files changed, 24 insertions, 3 deletions
diff --git a/configure.ac b/configure.ac index bb062c122..adb760a1b 100644 --- a/configure.ac +++ b/configure.ac @@ -32,6 +32,8 @@ DPKG_BUILD_PROG([dselect]) DPKG_BUILD_PROG([start-stop-daemon]) DPKG_BUILD_PROG([update-alternatives]) +DPKG_BUILD_DEVEL_DOCS + # Allow alternate directories DPKG_WITH_DIR([devlibdir], [${libdir}], [dpkg development library directory [LIBDIR]]) diff --git a/debian/changelog b/debian/changelog index 449790db5..ea28b6418 100644 --- a/debian/changelog +++ b/debian/changelog @@ -19,6 +19,8 @@ dpkg (1.18.4) UNRELEASED; urgency=low Reported by Jérémy Bobbio <lunar@debian.org>. Closes: #801329 - Use absolute buildir pathnames in PATH variable for the test suite. - Descend into scripts directory when cleaning up code coverage files. + - Add new configure option --disable-devel-docs to select the kind of docs + to generate, default for now is development documentation. * Documentation: - Move description for “target architecture” from the dpkg-architecture(1) ‘-A’ option to the TERMS section. Closes: #799046 diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in index 19b38f143..8253b4dc8 100644 --- a/doc/Doxyfile.in +++ b/doc/Doxyfile.in @@ -409,7 +409,7 @@ LOOKUP_CACHE_SIZE = 0 # normally produced when WARNINGS is set to YES. # The default value is: NO. -EXTRACT_ALL = YES +EXTRACT_ALL = @BUILD_DEVEL_DOCS@ # If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will # be included in the documentation. @@ -931,13 +931,13 @@ STRIP_CODE_COMMENTS = YES # function all documented functions referencing it will be listed. # The default value is: NO. -REFERENCED_BY_RELATION = YES +REFERENCED_BY_RELATION = @BUILD_DEVEL_DOCS@ # If the REFERENCES_RELATION tag is set to YES then for each documented function # all documented entities called/used by that function will be listed. # The default value is: NO. -REFERENCES_RELATION = YES +REFERENCES_RELATION = @BUILD_DEVEL_DOCS@ # If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set # to YES then the hyperlinks from functions in REFERENCES_RELATION and diff --git a/m4/dpkg-build.m4 b/m4/dpkg-build.m4 index 56dbef0cf..294d3b957 100644 --- a/m4/dpkg-build.m4 +++ b/m4/dpkg-build.m4 @@ -29,6 +29,23 @@ AC_DEFUN([DPKG_BUILD_PROG], [ AC_MSG_RESULT([$build_]AS_TR_SH([$1])) ])# DPKG_BUILD_PROG +# DPKG_BUILD_DEVEL_DOCS() +# --------------------- +# Select what type of documentation to build. Either for development including +# all symbol references, and extracting everything, or production documentation. +AC_DEFUN([DPKG_BUILD_DEVEL_DOCS], [ + AC_ARG_ENABLE([devel-docs], + AS_HELP_STRING([--disable-devel-docs], [build release docs]), + [build_devel_docs=$enable_devel_docs], + [build_devel_docs=yes] + ) + AS_IF([test "x$build_devel_docs" = "xyes"], [ + AC_DEFINE([BUILD_DEVEL_DOCS], [YES], [Define to YES if building devel docs.]) + ], [ + AC_DEFINE([BUILD_DEVEL_DOCS], [NO]) + ]) +])# DPKG_BUILD_DOCS_MODE + # DPKG_WITH_DIR(DIR, DEFAULT, DESCRIPTION) # ------------- # Allow specifying alternate directories. |