Documentation/sphinx: make targets independent of Sphinx work for HAVE_SPHINX=0
authorJani Nikula <jani.nikula@intel.com>
Mon, 30 Jan 2017 16:58:15 +0000 (18:58 +0200)
committerJonathan Corbet <corbet@lwn.net>
Wed, 1 Feb 2017 20:10:54 +0000 (13:10 -0700)
Make targets that don't depend on Sphinx work without warnings about
missing Sphinx. 'make cleandocs' will work without Sphinx just fine, and
the targets that are no-ops for Sphinx should just be skipped. Move them
outside of the HAVE_SPHINX checks to take precedence over the .DEFAULT
target for HAVE_SPHINX=0.

Reported-by: Jim Davis <jim.epost@gmail.com>
Reference: http://lkml.kernel.org/r/CA+r1ZhjRVqkjPXGOGB_BOAX2Hkfb+qQCtTzFfBMFeH1Mfeej7w@mail.gmail.com
Signed-off-by: Jani Nikula <jani.nikula@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/Makefile.sphinx

index b88f666f72bb413105a3c6263935419e103b105d..fd32fc727777e97359cfed951f03f674f3e69613 100644 (file)
@@ -91,6 +91,11 @@ epubdocs:
 xmldocs:
        @$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,xml,$(var),xml,$(var)))
 
+endif # HAVE_SPHINX
+
+# The following targets are independent of HAVE_SPHINX, and the rules should
+# work or silently pass without Sphinx.
+
 # no-ops for the Sphinx toolchain
 sgmldocs:
 psdocs:
@@ -101,8 +106,6 @@ cleandocs:
        $(Q)rm -rf $(BUILDDIR)
        $(Q)$(MAKE) BUILDDIR=$(abspath $(BUILDDIR)) $(build)=Documentation/media clean
 
-endif # HAVE_SPHINX
-
 dochelp:
        @echo  ' Linux kernel internal documentation in different formats (Sphinx):'
        @echo  '  htmldocs        - HTML'