Re: [PATCH] docs: memfd_preservation: fix rendering of ABI documentation

From: Randy Dunlap

Date: Sat Jun 06 2026 - 15:39:11 EST




On 6/5/26 9:06 AM, Pratyush Yadav wrote:
> From: "Pratyush Yadav (Google)" <pratyush@xxxxxxxxxx>
>
> The "memfd Live Update ABI" section in include/linux/kho/abi/memfd.h
> currently does not render in the exported documentation. This is because
> it should not include the "DOC:" in its reference. Drop it to ensure
> correct rendering. Tested by running make htmldocs.
>
> Fixes: 15fc11bb2cb6 ("docs: add documentation for memfd preservation via LUO")
> Signed-off-by: Pratyush Yadav (Google) <pratyush@xxxxxxxxxx>

Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Acked-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
Thanks.

> ---
>
> Notes:
> Mike/Pasha, I reckon this can still go in liveupdate/next. But if you
> think it is too late, we can probably take it via -rc1 fixes as well.
>
> Documentation/mm/memfd_preservation.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/mm/memfd_preservation.rst b/Documentation/mm/memfd_preservation.rst
> index a8a5b476afd3..c908a12dffa7 100644
> --- a/Documentation/mm/memfd_preservation.rst
> +++ b/Documentation/mm/memfd_preservation.rst
> @@ -11,7 +11,7 @@ Memfd Preservation ABI
> ======================
>
> .. kernel-doc:: include/linux/kho/abi/memfd.h
> - :doc: DOC: memfd Live Update ABI
> + :doc: memfd Live Update ABI
>
> .. kernel-doc:: include/linux/kho/abi/memfd.h
> :internal:
>
> base-commit: 2935777b418d2bfcbfe96705bb2c0fa6c0d94e18

--
~Randy