[PATCH v3] docs: Makefile: wrap SPHINXDIRS help text

From: mustafaelrasheid
Date: Sat Dec 27 2025 - 07:55:58 EST


From: Mustafa Elrasheid <mustafaelrasheid@xxxxxxxxx>

When using `make help`, SPHINXDIR doesn't wrap around 80 characters,
causing text to overflow or wrap in incorrect ways,
which then makes the text difficult to read

Signed-off-by: Mustafa Elrasheid <mustafaelrasheid@xxxxxxxxx>
---
v3:
- Moved SPHINXDIRS to a new line for better readability
- Added `-g 75` to increase the goal of fmt instead of 93% of `-w 75`
v2:
- Added '-s' in fmt to prevent word segmenting at the end of lines.
- Reduced width in `fmt -w` to account for the added indentation of
`sed`

Documentation/Makefile | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Documentation/Makefile b/Documentation/Makefile
index e96ac6dcac4f..377a449656c8 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -98,7 +98,8 @@ dochelp:
@echo ' cleandocs - clean all generated files'
@echo
@echo ' make SPHINXDIRS="s1 s2" [target] Generate only docs of folder s1, s2'
- @echo ' top level values for SPHINXDIRS are: $(_SPHINXDIRS)'
+ @echo ' top level values for SPHINXDIRS are:'
+ @echo '$(_SPHINXDIRS)' | fmt -s -w 75 -g 75 | sed 's/^/ /'
@echo ' you may also use a subdirectory like SPHINXDIRS=userspace-api/media,'
@echo ' provided that there is an index.rst file at the subdirectory.'
@echo
--
2.39.5