Bagas Sanjaya <[email protected]> writes: > On Fri, Oct 17, 2025 at 02:27:01PM -0600, Jonathan Corbet wrote: >> Bagas Sanjaya <[email protected]> writes: >> >> > From: Gopi Krishna Menon <[email protected]> >> > >> > Sphinx reports htmldocs errors: >> > >> > Documentation/tools/rtla/common_options.rst:58: ERROR: Undefined >> > substitution referenced: "threshold". >> > Documentation/tools/rtla/common_options.rst:88: ERROR: Undefined >> > substitution referenced: "tool". >> > Documentation/tools/rtla/common_options.rst:88: ERROR: Undefined >> > substitution referenced: "thresharg". >> > Documentation/tools/rtla/common_options.rst:88: ERROR: Undefined >> > substitution referenced: "tracer". >> > Documentation/tools/rtla/common_options.rst:92: ERROR: Undefined >> > substitution referenced: "tracer". >> > Documentation/tools/rtla/common_options.rst:98: ERROR: Undefined >> > substitution referenced: "actionsperf". >> > Documentation/tools/rtla/common_options.rst:113: ERROR: Undefined >> > substitution referenced: "tool". >> > >> > common_*.rst files are snippets that are intended to be included by rtla >> > docs (rtla*.rst). common_options.rst in particular contains >> > substitutions which depend on other common_* includes, so building it >> > independently as reST source results in above errors. >> > >> > Rename all common_*.rst files to common_*.txt to prevent Sphinx from >> > building these snippets as standalone reST source and update all include >> > references accordingly. >> >> Applied, thanks. > > Shouldn't this more appropriate as a fix for current cycle (6.18)? I see > the warnings on Linus's tree, though.
As a general rule, I don't see warning fixes as being important enough to send outside of the merge window; the next cycle isn't that far away. jon
