doc Makefile: convert to a real Makefile to get rid of duplication

Zero user interface or functional change.

Also change undocumented cmake -H option to documented -S
https://stackoverflow.com/questions/31090821/what-does-the-h-option-means-for-cmake

Signed-off-by: Marc Herbert <[email protected]>

Author: marc-hb

Makefile

@@ -5,20 +5,25 @@
 BUILDDIR ?= doc/_build
 DOC_TAG ?= development
 SPHINXOPTS ?= -q
+KCONFIG_TURBO_MODE ?= 0
 
 # Documentation targets
 # ---------------------------------------------------------------------------
 clean:
 	rm -rf ${BUILDDIR}
 
-htmldocs:
-	mkdir -p ${BUILDDIR} && cmake -GNinja -DDOC_TAG=${DOC_TAG} -DSPHINXOPTS=${SPHINXOPTS} -B${BUILDDIR} -Hdoc/ && ninja -C ${BUILDDIR} htmldocs
-
 htmldocs-fast:
-	mkdir -p ${BUILDDIR} && cmake -GNinja -DKCONFIG_TURBO_MODE=1 -DDOC_TAG=${DOC_TAG} -DSPHINXOPTS=${SPHINXOPTS} -B${BUILDDIR} -Hdoc/ && ninja -C ${BUILDDIR} htmldocs
+	${MAKE} htmldocs KCONFIG_TURBO_MODE=1
+
+htmldocs pdfdocs doxygen: configure
+	cmake --build ${BUILDDIR} -- $@  # -v # VERBOSE=1
 
-pdfdocs:
-	mkdir -p ${BUILDDIR} && cmake -GNinja -DDOC_TAG=${DOC_TAG} -DSPHINXOPTS=${SPHINXOPTS} -B${BUILDDIR} -Hdoc/ && ninja -C ${BUILDDIR} pdfdocs
+# Run CMake every time cause it's quick and re-configures TURBO_MODE if
+# needed
+.PHONY: configure
+configure:
+	cmake -GNinja  -B${BUILDDIR} -Sdoc/ -DDOC_TAG=${DOC_TAG} \
+		-DSPHINXOPTS=${SPHINXOPTS} \
+		-DKCONFIG_TURBO_MODE=${KCONFIG_TURBO_MODE}
 
-doxygen:
-	mkdir -p ${BUILDDIR} && cmake -GNinja -DDOC_TAG=${DOC_TAG} -DSPHINXOPTS=${SPHINXOPTS} -B${BUILDDIR} -Hdoc/ && ninja -C ${BUILDDIR} doxygen
+.PHONY: clean htmldocs htmldocs-fast pdfdocs doxygen