On Sun, Aug 23, 2026 at 05:14:20PM +0200, Manuel Ebner wrote: > I think in the documentation is some incorrect auto high-lighting. > > https://docs.kernel.org/process/deprecated.html > > Line 272: > > when such a struct was in unions, structs of structs, etc). > with 'struct was' bold. > > Line 358: > > alone in a struct or is part of a union. These are disallowed by the C99 > with 'struct or' bold as well. > > Other files have the same issue: > E.g.: https://docs.kernel.org/process/adding-syscalls.html > > Unfortunately I don't know how to fix this.
Hi Manuel, I think we can just add "or" and "was" to Skipidentifiers, so that it won't be treated as C identifiers. --- a/Documentation/sphinx/automarkup.py +++ b/Documentation/sphinx/automarkup.py @@ -51,7 +51,7 @@ 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 = [ 'or', 'that', 'was', 'which', 'where', 'whose' ] # # Many places in the docs refer to common system calls. It is But I find more words needs to be added when looking at process/adding-syscalls.rst. Adding the falsely highlighted words one by one may not be a perfect solution, since it could potentially affect other places where those words should actually be highlighted. So I'm not quite sure what the best approach is either now. Thanks.
