From f771a3446356d92c6c27df5c4f3bb07a2561b36b Mon Sep 17 00:00:00 2001 From: Yann Gautier Date: Fri, 17 Mar 2023 13:49:05 +0100 Subject: [PATCH] feat(docs): allow verbose build If V=1 is set (or directly Q="") in the 'make doc' command line, the sphinx command that builds the documentation is displayed. Signed-off-by: Yann Gautier Change-Id: I4961c124cc52d0183371f1d4bbc0e440f5ae6e63 --- docs/Makefile | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/Makefile b/docs/Makefile index 3dd7ebc4d..5bc24db79 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -1,5 +1,5 @@ # -# Copyright (c) 2019-2020, ARM Limited. All rights reserved. +# Copyright (c) 2019-2023, ARM Limited. All rights reserved. # # SPDX-License-Identifier: BSD-3-Clause # @@ -13,13 +13,20 @@ SPHINXPROJ = TrustedFirmware-A SOURCEDIR = . BUILDDIR = build +V ?= 0 +ifeq ($(V),0) + Q := @ +else + Q := +endif + # Put it first so that "make" without argument is like "make help". help: - @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + ${Q}$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) .PHONY: help Makefile # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). %: Makefile - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + ${Q}$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)