Re: [LTP] [PATCH v3 1/2] doc: Document process_state

Andrea Cervesato via ltp
2026-01-07T12:23:33Z

Hi!

> @Andrea: I wish sphinx doc would warn about "undescribed" and I thought it did
> in the past, but I don't see it.

That's not sphinx, but the 'linuxdoc.rstKernelDoc' plugin we are using.
It's developed for the kernel documentation (perhaps, we might upgrade
it to the newest version) and it doesn't provide this.

>
> Also we have too many (~ 220x) warnings:
> "WARNING: duplicate label description, other instance in ..." it's not usable.
> Any hint you could have look on it? If we solve this warning would get useful.
>

The warnings you see are generated by:

pip install linuxdoc
linuxdoc.lintdoc include/

--
Andrea Cervesato
SUSE QE Automation Engineer Linux
andrea.cervesato@suse.com