[PATCH] Documentation: sort _SPHINXDIRS for 'make help'

[PATCH] Documentation: sort _SPHINXDIRS for 'make help'

[Randy Dunlap]

From: Randy Dunlap <rdunlap@infradead.org>

Sort the _SPHINXDIRS so that the 'make help' output is easier to read &
search and in a predictable order instead of some unknown pseudo-random
order.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
---
 Documentation/Makefile |    2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

--- lnx-56-rc1.orig/Documentation/Makefile
+++ lnx-56-rc1/Documentation/Makefile
@@ -13,7 +13,7 @@ endif
 SPHINXBUILD   = sphinx-build
 SPHINXOPTS    =
 SPHINXDIRS    = .
-_SPHINXDIRS   = $(patsubst $(srctree)/Documentation/%/index.rst,%,$(wildcard $(srctree)/Documentation/*/index.rst))
+_SPHINXDIRS   = $(sort $(patsubst $(srctree)/Documentation/%/index.rst,%,$(wildcard $(srctree)/Documentation/*/index.rst)))
 SPHINX_CONF   = conf.py
 PAPER         =
 BUILDDIR      = $(obj)/output

Re: [PATCH] Documentation: sort _SPHINXDIRS for 'make help'

[Jonathan Corbet]

On Sat, 15 Feb 2020 23:26:06 -0800
Randy Dunlap <rdunlap@infradead.org> wrote:

> Sort the _SPHINXDIRS so that the 'make help' output is easier to read &
> search and in a predictable order instead of some unknown pseudo-random
> order.
> 
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

But...that takes the challenge out of it!

Applied, thanks.

jon