Re: [PATCH] docs: automarkup.py: add skipidentifiers

Randy Dunlap <[email protected]>
Newsgroups org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel
Message-ID <[email protected]>
Hi,

On 8/24/26 12:03 AM, Manuel Ebner wrote:
> Add skipidentifiers to reduce wrongfully high-lighted (bold) words.
> 
> Signed-off-by: Manuel Ebner <[email protected]>

whac-a-mole alert:
"struct request" here is no longer highlighted:
Documentation/block/blk-mq.rst:will then build a new structure from it, the struct request that will


For most of the other words here, I'm OK with this patch.

> ---
> Pre-patch discussion:
>  https://lore.kernel.org/all/[email protected]/
> ---
>  Documentation/sphinx/automarkup.py | 5 ++++-
>  1 file changed, 4 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/sphinx/automarkup.py b/Documentation/sphinx/automarkup.py
> index c2227ab0a..8a6174950 100644
> --- a/Documentation/sphinx/automarkup.py
> +++ b/Documentation/sphinx/automarkup.py
> @@ -51,7 +51,10 @@ Skipnames = [ 'for', 'if', 'register', 'sizeof', 'struct', 'unsigned' ]
>  # when following struct/union/enum/typedef keywords.
>  # Example: "a simple struct that" in workqueue.rst should not be marked as code.
>  #
> -Skipidentifiers = [ 'that', 'which', 'where', 'whose' ]
> +Skipidentifiers = [ 'and', 'are', 'as', 'containing', 'in', 'including',
> +                    'is', 'name', 'needs', 'of', 'or',  'pages',
> +                    'passed', 'randomization', 'request', 'that',
> +                    'to', 'where', 'which', 'whose', 'will' ]
>  
>  #
>  # Many places in the docs refer to common system calls.  It is

-- 
~Randy
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.