From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 5D7CC2E285E; Tue, 12 Aug 2025 18:34:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755023676; cv=none; b=roA8ZlwMmab49KkHN+clZm0Es2DuPlHIxrC82VkqIiSYsn+vhULYnBCTQnPksiH0u4OzA+GgY0QZkMG8mIwAkf2VE6/o5TzF2MQHniXfQV9rsMKP414z38k1unIKUs/4U7+hmg2160HCr7lk1c8TOr/CmG2noQUJL5YkUxm9XhI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755023676; c=relaxed/simple; bh=XTI6XvRkEhVcfAaKf3gk62tRSUs0tkxcHccU3AdW1YI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=KtBLxW8ANiczKkcV1PLXG9k6ISD97Z+7xUxECe3py/kMxndwB7LRWdFSyG24MeN5H6Y/UnypxJhtNdYv1jFLIbrEFepMO25mIuOTP1OKyLYYXpgsOupbWZhEzsV/CMQGOUtAGHmY+KGLE+fMAu6oj9UZme9KNyDW66cZwF30UC8= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linuxfoundation.org header.i=@linuxfoundation.org header.b=UDVDFBDD; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linuxfoundation.org header.i=@linuxfoundation.org header.b="UDVDFBDD" Received: by smtp.kernel.org (Postfix) with ESMTPSA id BF3BBC4CEF0; Tue, 12 Aug 2025 18:34:35 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linuxfoundation.org; s=korg; t=1755023676; bh=XTI6XvRkEhVcfAaKf3gk62tRSUs0tkxcHccU3AdW1YI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=UDVDFBDDLOMy+IM4iXG4Zfm7ZKD2E2MHfzpuCQDoS2hsQ5BYOmZDoAmtGKSrqxdqu KhU7ZNgk0gZ9eckPsv9W4T8y7TzhKpMKMlyvyXDjuM80sYp+mqkDXhyRvnM1ftQdQY 8XiHCGxJQGOnqDdXRENDdHXZ0fJEa4G1ee1YRQHI= From: Greg Kroah-Hartman To: stable@vger.kernel.org Cc: Greg Kroah-Hartman , patches@lists.linux.dev, Jonathan Corbet , "Matthew Wilcox (Oracle)" , Vlastimil Babka , Sasha Levin Subject: [PATCH 6.16 150/627] slub: Fix a documentation build error for krealloc() Date: Tue, 12 Aug 2025 19:27:25 +0200 Message-ID: <20250812173425.000605813@linuxfoundation.org> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20250812173419.303046420@linuxfoundation.org> References: <20250812173419.303046420@linuxfoundation.org> User-Agent: quilt/0.68 X-stable: review X-Patchwork-Hint: ignore Precedence: bulk X-Mailing-List: patches@lists.linux.dev List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 6.16-stable review patch. If anyone has any objections, please let me know. ------------------ From: Jonathan Corbet [ Upstream commit e8a45f198e3ae2434108f815bc28f37f6fe6742b ] 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 Signed-off-by: Matthew Wilcox (Oracle) Link: https://patch.msgid.link/20250611155916.2579160-6-willy@infradead.org Signed-off-by: Vlastimil Babka Signed-off-by: Sasha Levin --- mm/slub.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/mm/slub.c b/mm/slub.c index 31e11ef256f9..45a963e363d3 100644 --- a/mm/slub.c +++ b/mm/slub.c @@ -4930,12 +4930,12 @@ __do_krealloc(const void *p, size_t new_size, gfp_t flags) * When slub_debug_orig_size() is off, krealloc() only knows about the bucket * size of an allocation (but not the exact size it was allocated with) and * hence implements the following semantics for shrinking and growing buffers - * with __GFP_ZERO. + * with __GFP_ZERO:: * - * new bucket - * 0 size size - * |--------|----------------| - * | keep | zero | + * new bucket + * 0 size size + * |--------|----------------| + * | keep | zero | * * Otherwise, the original allocation size 'orig_size' could be used to * precisely clear the requested size, and the new size will also be stored -- 2.39.5