build: only generate documentation when BUILD_SETTING_DOCS

Generating the docs, requires man/nm-settings.xml. That is only present
when
  - ./configure --enable-gtk-doc --with-introspecton
  - in a dist-tarball, contrary to a git-tree

Only create docs, when we also regenerate the manuals (BUILD_SETTING_DOCS).
That is, you can no longer generate docs, by relying on the pre-generated
manual pages.
If you want to generate docs, you have to regenerate the manual pages
as well.

Previously, doing the following in a git-tree failed:

    $ git clean -fdx
    $ ./autogen.sh --enable-gtk-doc --enable-introspection=no && make
    ...
    make[2]: Entering directory './NetworkManager/docs/api'
      DOC   Preparing build
      DOC   Scanning header files
      DOC   Introspecting gobjects
      DOC   Building XML
      DOC   Building XML
    make[2]: *** No rule to make target '../../man/nm-settings.xml', needed by 'html-build.stamp'.  Stop.
    make[2]: Leaving directory './NetworkManager/docs/api'
This commit is contained in:
Thomas Haller 2016-11-16 12:00:11 +01:00
parent 3cd56809ed
commit 07a8f22aef

View File

@ -81,7 +81,11 @@ GLIB_MKENUMS_C_FLAGS = --identifier-prefix NM
SUBDIRS = \
. \
po \
po
if BUILD_SETTING_DOCS
SUBDIRS += \
docs/libnm \
docs/api
@ -91,6 +95,8 @@ SUBDIRS += \
docs/libnm-glib
endif
endif
###############################################################################
set_sanitizer_env = \