devargs: restore empty devargs

[dpdk.git] / mk / rte.sdkdoc.mk

diff --git a/mk/rte.sdkdoc.mk b/mk/rte.sdkdoc.mk
index c6cc673..dabc0d6 100644 (file)
--- a/mk/rte.sdkdoc.mk
+++ b/mk/rte.sdkdoc.mk
@@ -36,22 +36,30 @@ $(error "Cannot use T= with doc target")
 endif
 endif
 
+RTE_SPHINX_BUILD = sphinx-build
+ifndef V
+RTE_SPHINX_VERBOSE := -q
+endif
+ifeq '$V' '0'
+RTE_SPHINX_VERBOSE := -q
+endif
+
 .PHONY: help
 help:
        @cat $(RTE_SDK)/doc/build-sdk-quick.txt
        @$(MAKE) -rR showconfigs | sed 's,^,\t\t\t\t,'
 
 .PHONY: all
-all: htmlapi
+all: api-html guides-html
 
 .PHONY: clean
-clean: htmlapi-clean
+clean: api-html-clean guides-html-clean
 
-.PHONY: htmlapi
-htmlapi: htmlapi-clean
+.PHONY: api-html
+api-html: api-html-clean
        @echo 'doxygen for API...'
        $(Q)mkdir -p $(RTE_OUTPUT)/doc/html
-       $(Q)(cat $(RTE_SDK)/doc/doxy-api.conf         && \
+       $(Q)(cat $(RTE_SDK)/doc/api/doxy-api.conf     && \
            printf 'PROJECT_NUMBER = '                && \
                              $(MAKE) -rR showversion && \
            echo OUTPUT_DIRECTORY = $(RTE_OUTPUT)/doc && \
@@ -60,9 +68,18 @@ htmlapi: htmlapi-clean
            echo GENERATE_LATEX   = NO                && \
            echo GENERATE_MAN     = NO                )| \
            doxygen -
-       $(Q)$(RTE_SDK)/doc/doxy-html-custom.sh $(RTE_OUTPUT)/doc/html/api/doxygen.css
+       $(Q)$(RTE_SDK)/doc/api/doxy-html-custom.sh $(RTE_OUTPUT)/doc/html/api/doxygen.css
 
-.PHONY: htmlapi-clean
-htmlapi-clean:
+.PHONY: api-html-clean
+api-html-clean:
        $(Q)rm -f $(RTE_OUTPUT)/doc/html/api/*
        $(Q)rmdir -p --ignore-fail-on-non-empty $(RTE_OUTPUT)/doc/html/api 2>&- || true
+
+guides-%-clean:
+       $(Q)rm -rf $(RTE_OUTPUT)/doc/$*/guides
+       $(Q)rmdir -p --ignore-fail-on-non-empty $(RTE_OUTPUT)/doc/$* 2>&- || true
+
+guides-%:
+       @echo 'sphinx for guides...'
+       $(Q)$(RTE_SPHINX_BUILD) -b $* $(RTE_SPHINX_VERBOSE) \
+               -c $(RTE_SDK)/doc/guides $(RTE_SDK)/doc/guides $(RTE_OUTPUT)/doc/$*/guides