Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

slub: Fix a documentation build error for krealloc()

The kerneldoc comment for krealloc() contains an unmarked literal block,
leading to these warnings in the docs build:

./mm/slub.c:4936: WARNING: Block quote ends without a blank line; unexpected unindent. [docutils]
./mm/slub.c:4936: ERROR: Undefined substitution referenced: "--------". [docutils]

Mark up and indent the block properly to bring a bit of peace to our build
logs.

Fixes: 489a744e5fb1 (mm: krealloc: clarify valid usage of __GFP_ZERO)
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Link: https://patch.msgid.link/20250611155916.2579160-6-willy@infradead.org
Signed-off-by: Vlastimil Babka <vbabka@suse.cz>

authored by

Jonathan Corbet and committed by
Vlastimil Babka
e8a45f19 3df29914

+5 -5
+5 -5
mm/slub.c
··· 4966 4966 * When slub_debug_orig_size() is off, krealloc() only knows about the bucket 4967 4967 * size of an allocation (but not the exact size it was allocated with) and 4968 4968 * hence implements the following semantics for shrinking and growing buffers 4969 - * with __GFP_ZERO. 4969 + * with __GFP_ZERO:: 4970 4970 * 4971 - * new bucket 4972 - * 0 size size 4973 - * |--------|----------------| 4974 - * | keep | zero | 4971 + * new bucket 4972 + * 0 size size 4973 + * |--------|----------------| 4974 + * | keep | zero | 4975 4975 * 4976 4976 * Otherwise, the original allocation size 'orig_size' could be used to 4977 4977 * precisely clear the requested size, and the new size will also be stored