Thread (42 messages) 42 messages, 5 authors, 2025-06-18

Re: [PATCH v5 01/15] docs: conf.py: properly handle include and exclude patterns

From: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Date: 2025-06-18 06:59:52
Also in: linux-doc, linux-kernel-mentees, lkml

Em Tue, 17 Jun 2025 11:38:06 +0100
Donald Hunter [off-list ref] escreveu:
Mauro Carvalho Chehab [off-list ref] writes:
quoted
When one does:
	make SPHINXDIRS="foo" htmldocs

All patterns would be relative to Documentation/foo, which
causes the include/exclude patterns like:

	include_patterns = [
		...
		f'foo/*.{ext}',
	]

to break. This is not what it is expected. Address it by
adding a logic to dynamically adjust the pattern when
SPHINXDIRS is used.

That allows adding parsers for other file types.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>  
Reviewed-by: Donald Hunter <donald.hunter@gmail.com>
Thanks for reviewing. At the next version, I'm placing some backward
compatible code for Sphinx 5.1, based on Akira's feedback.

As the basic logic is the same, I'm keeping your review there.


Thanks,
Mauro
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help