On Fri, Nov 28, 2025 at 01:43:41PM -0800, Randy Dunlap wrote: > Hi, > > On 11/28/25 7:18 AM, Sameeksha Sankpal wrote: > > The RTLA common options documentation uses several Sphinx substitution > > placeholders (|threshold|, |tool|, |thresharg|, |tracer|, |actionsperf|) > > that are not defined anywhere in the tree. This causes the htmldocs > > build to fail with multiple "Undefined substitution" errors. > > > > Replace these undefined substitutions with plain text or generic > > placeholders (<tool>, <threshold-option>, <tracer>) to ensure the > > documentation builds cleanly while preserving the intended meaning of > > the examples. > > > > Signed-off-by: Sameeksha Sankpal <[email protected]> > > --- > > Documentation/tools/rtla/common_options.rst | 12 ++++++------ > > 1 file changed, 6 insertions(+), 6 deletions(-) > > > > diff --git a/Documentation/tools/rtla/common_options.rst > > b/Documentation/tools/rtla/common_options.rst > > index 77ef35d3f831..bd5a6f32f5bf 100644 > > --- a/Documentation/tools/rtla/common_options.rst > > +++ b/Documentation/tools/rtla/common_options.rst > > Does this patch apply to the mainline (Linus) kernel? > This is already fixed in linux-next or docs-next. > You should usually check -next trees for fixes like this. > > See: > > commit 96b546c241b1 > Author: Gopi Krishna Menon <[email protected]> > Date: Mon Oct 13 16:27:20 2025 +0700 > Documentation/rtla: rename common_xxx.rst files to common_xxx.txt
The warnings are found on master, though, yet 96b546c241b1 is in docs-next instead. I guess I can stable-backport it to 6.18 once it is released (in next week). Thanks. -- An old man doll... just what I always wanted! - Clara
signature.asc
Description: PGP signature
