From 1e167a4aadcf254cc8b755b3b45843604de58cb2 Mon Sep 17 00:00:00 2001 From: Nathan Skrzypczak Date: Fri, 25 Mar 2022 12:06:51 +0100 Subject: docs: make docs build incremental This patch makes the `make docs` directive incremental avoiding re-running the siphon when the source hasn't changed, and leveraging sphinx internal cache. It adds a `make rebuild-docs` directive for cases where this caching logic might break, e.g. in CI. The virtualenv doesn't also get recreated on each build, which might be enough when writing docs, provided automated process leverage its rebuild counterpart. Type: improvement Change-Id: Ie90de3adebeed017b249cad81c6c160719f71e8d Signed-off-by: Nathan Skrzypczak Signed-off-by: Dave Wallace --- Makefile | 1 + 1 file changed, 1 insertion(+) (limited to 'Makefile') diff --git a/Makefile b/Makefile index 609a17418fc..6f5bc9be856 100644 --- a/Makefile +++ b/Makefile @@ -247,6 +247,7 @@ help: @echo " docs - Build the Sphinx documentation" @echo " docs-venv - Build the virtual environment for the Sphinx docs" @echo " docs-clean - Remove the generated files from the Sphinx docs" + @echo " docs-rebuild - Rebuild all of the Sphinx documentation" @echo "" @echo "Make Arguments:" @echo " V=[0|1] - set build verbosity level" -- cgit 1.2.3-korg