docs: Makefile: Sort Documentation targets case-insensitively in make help
PATCH v2 1/1 docs: Makefile: Sort Documentation targets case-insensitively in make help
Avoid case-sensitive sorting when listing Documentation targets in make help. Previously, targets like PCI and RCU appeared ahead of others due to uppercase names.
Normalize casing during _SPHINXDIRS generation to ensure consistent and intuitive ordering.
---
V1-V2 changes
- Rebased on to commit 27600b51fbc8 ("MAINTAINERS: extend DOCUMENTATION SCRIPTS to the full directories") in docs-next.
- Link to V1: https://lore.kernel.org/lkml/[email protected]/
Documentation/Makefile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
Documentation/Makefile +1 -1
@@ -84,7 +84,7 @@ cleandocs: $(Q)rm -rf $(BUILDDIR) # Used only on help -_SPHINXDIRS = $(sort $(patsubst $(srctree)/Documentation/%/index.rst,%,$(wildcard $(srctree)/Documentation/*/index.rst))) +_SPHINXDIRS = $(shell printf "%s\n" $(patsubst $(srctree)/Documentation/%/index.rst,%,$(wildcard $(srctree)/Documentation/*/index.rst)) | sort -f) dochelp: @echo ' Linux kernel internal documentation in different formats from ReST:'
Signature · 1 line
2.34.1
Quoted 11 lines · Bhanu Seshu Kumar Valluri
Avoid case-sensitive sorting when listing Documentation targets in make help. Previously, targets like PCI and RCU appeared ahead of others due to uppercase names.
Normalize casing during
_SPHINXDIRSgeneration to ensure consistent and intuitive ordering.Fixes 965fc39f7393 ("Documentation: sort _SPHINXDIRS for 'make help'")Tested-by Randy Dunlap <[email protected]>Acked-by Randy Dunlap <[email protected]>Signed-off-by Bhanu Seshu Kumar Valluri <[email protected]>
Quoted 5 lines
---
V1-V2 changes
- Rebased on to commit27600b51fbc8("MAINTAINERS: extend DOCUMENTATION SCRIPTS to the full directories") in docs-next.
- Link to V1: https://lore.kernel.org/lkml/[email protected]/
Applied, thanks.
jon