[PATCH v4 10/14] docs: conf.py: don't handle yaml files outside Netlink specs

From: Mauro Carvalho Chehab
Date: Sat Jun 14 2025 - 05:00:09 EST


The parser_yaml extension already has a logic to prevent
handing all yaml documents. However, if we don't also exclude
the patterns at conf.py, the build time would increase a lot,
and warnings like those would be generated:

Documentation/netlink/genetlink.yaml: WARNING: o documento não está incluído em nenhum toctree
Documentation/netlink/genetlink-c.yaml: WARNING: o documento não está incluído em nenhum toctree
Documentation/netlink/genetlink-legacy.yaml: WARNING: o documento não está incluído em nenhum toctree
Documentation/netlink/index.rst: WARNING: o documento não está incluído em nenhum toctree
Documentation/netlink/netlink-raw.yaml: WARNING: o documento não está incluído em nenhum toctree

Add some exclusion rules to prevent that.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
---
Documentation/conf.py | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/Documentation/conf.py b/Documentation/conf.py
index add6ce78dd80..62a51ac64b95 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -221,8 +221,16 @@ language = 'en'
#today_fmt = '%B %d, %Y'

# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-exclude_patterns = ['output']
+# directories.
+include_patterns = [
+ '**.rst',
+ 'netlink/specs/*.yaml',
+]
+
+# patterns to ignore when looking for source files.
+exclude_patterns = [
+ 'output',
+]

# The reST default role (used for this markup: `text`) to use for all
# documents.
--
2.49.0