From 7d3c4812e9b6bc8c6803a80b0923f0ae9b3ad2e1 Mon Sep 17 00:00:00 2001
From: Sunil Mohan Adapa <sunil@medhas.org>
Date: Thu, 19 Mar 2026 12:38:41 -0700
Subject: [PATCH] doc: Reduce verbosity when building documentation

- Also remove docbook.css file properly

Tests:

- 'make clean ; make' in doc/ directory yields terse output. dockbook.css is not
created.

- 'make build' in main directory does not result in creation of docbook.css.

[Joseph Nuthalapati]

- Align the prefixes so that the sentences start at the same position.
- Add a space in the redirection: `2> /dev/null`

Reviewed-by: Joseph Nuthalapati <njoseph@riseup.net>
Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
---
 doc/Makefile | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/doc/Makefile b/doc/Makefile
index 37ccf8465..934c3d9ae 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -109,20 +109,25 @@ manual-pages-xml:=$(patsubst %.raw.wiki, %.xml, $(manual-pages-raw-wiki))
 manual-pages: $(manual-pages-part-html)
 
 $(manual-pdfs): %.pdf: %.xml
-	xmlto $(XMLTO_DEBUG_FLAGS) --with-dblatex pdf -o $(dir $@) $<
+	@echo "[PDF]       $<"
+	@xmlto $(XMLTO_DEBUG_FLAGS) --with-dblatex pdf -o $(dir $@) $< 2> /dev/null
 
 $(manual-pages-part-html): %.part.html: %.xml
-	xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/xhtml5/docbook.xsl $< | \
+	@echo "[XSLT]      $<"
+	@xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/xhtml5/docbook.xsl $< 2> /dev/null | \
 	perl -pe 'BEGIN {undef $$/} s/.*<body[^>]*>(.*)<\/body\s*>.*/$$1/si' > $@
-	@rm -f $(dir $@)docbook.css
+	@rm -f docbook.css
 
 $(manual-xmls) $(manual-pages-xml): %.xml: %.raw.wiki $(SCRIPTS_DIR)/wikiparser.py
-	$(SCRIPTS_DIR)/wikiparser.py $< | xmllint --format - > $@
+	@echo "[WIKIPARSE] $<"
+	@$(SCRIPTS_DIR)/wikiparser.py $< | xmllint --format - > $@
 
 %.1: %.xml
-	xmlto man $<
+	@echo "[MAN]       $<"
+	@xmlto man $< 2> /dev/null
 
 .PHONY: clean
 clean:
-	rm -f $(manual-pages-part-html) $(manual-pages-xml) $(manual-xmls)
-	rm -f $(OUTPUTS)
+	@echo "[RM]        {part-htmls} {xmls} {manuals} {outputs}"
+	@rm -f $(manual-pages-part-html) $(manual-pages-xml) $(manual-xmls)
+	@rm -f $(OUTPUTS)