DocBook: use DOCBOOKS="" to ignore DocBooks instead of IGNORE_DOCBOOKS=1

Instead of a separate ignore flag, use the obvious DOCBOOKS="" to ignore
all DocBook files. This is also in line with the Sphinx build being
ignored if a non-empty DOCBOOKS make variable is specified on the make
command line.

This replaces the IGNORE_DOCBOOKS introduced in

commit 547218864afb2745d9d137f005f3380ef96b26ab
Author: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Date: Sat Jul 9 13:12:45 2016 -0300

doc-rst: add an option to ignore DocBooks when generating docs

and aligns with

commit 6387872c86ea6698ed8faa3ccad1d1bd60f762f7
Author: Jani Nikula <jani.nikula@intel.com>
Date: Fri Jul 1 15:24:44 2016 +0300

Documentation/sphinx: skip build if user requested specific DOCBOOKS

Cc: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Jani Nikula <jani.nikula@intel.com>
Tested-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by Jani Nikula and committed by Jonathan Corbet bdf107d8 09c3bcce

Changed files
+10 -16
Documentation
DocBook
+10 -16
Documentation/DocBook/Makefile
··· 6 6 # To add a new book the only step required is to add the book to the 7 7 # list of DOCBOOKS. 8 8 9 - ifeq ($(IGNORE_DOCBOOKS),) 10 - 11 9 DOCBOOKS := z8530book.xml device-drivers.xml \ 12 10 kernel-hacking.xml kernel-locking.xml deviceiobook.xml \ 13 11 writing_usb_driver.xml networking.xml \ ··· 16 18 alsa-driver-api.xml writing-an-alsa-driver.xml \ 17 19 tracepoint.xml gpu.xml media_api.xml w1.xml \ 18 20 writing_musb_glue_layer.xml crypto-API.xml iio.xml 21 + 22 + ifeq ($(DOCBOOKS),) 23 + 24 + # Skip DocBook build if the user explicitly requested no DOCBOOKS. 25 + .DEFAULT: 26 + @echo " SKIP DocBook $@ target (DOCBOOKS=\"\" specified)." 27 + 28 + else 19 29 20 30 include Documentation/DocBook/media/Makefile 21 31 ··· 223 217 -e "s/>/\\&gt;/g"; \ 224 218 echo "</programlisting>") > $@ 225 219 226 - else 227 - 228 - # Needed, due to cleanmediadocs 229 - include Documentation/DocBook/media/Makefile 230 - 231 - htmldocs: 232 - pdfdocs: 233 - psdocs: 234 - xmldocs: 235 - installmandocs: 236 - 237 - endif # IGNORE_DOCBOOKS 238 - 220 + endif # DOCBOOKS="" 239 221 240 222 ### 241 223 # Help targets as used by the top-level makefile ··· 240 246 @echo ' make DOCBOOKS="s1.xml s2.xml" [target] Generate only docs s1.xml s2.xml' 241 247 @echo ' valid values for DOCBOOKS are: $(DOCBOOKS)' 242 248 @echo 243 - @echo " make IGNORE_DOCBOOKS=1 [target] Don't generate docs from Docbook" 249 + @echo " make DOCBOOKS=\"\" [target] Don't generate docs from Docbook" 244 250 @echo ' This is useful to generate only the ReST docs (Sphinx)' 245 251 246 252