From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7C8E0C71136 for ; Wed, 11 Jun 2025 16:24:52 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id E721F6B009D; Wed, 11 Jun 2025 12:24:51 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E4AD26B009F; Wed, 11 Jun 2025 12:24:51 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D87906B00A1; Wed, 11 Jun 2025 12:24:51 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id B9E246B009D for ; Wed, 11 Jun 2025 12:24:51 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 652191D75F0 for ; Wed, 11 Jun 2025 16:24:51 +0000 (UTC) X-FDA: 83543643582.28.7CCA330 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf10.hostedemail.com (Postfix) with ESMTP id C51D4C0007 for ; Wed, 11 Jun 2025 16:24:49 +0000 (UTC) Authentication-Results: imf10.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=eaHYjnAQ; spf=none (imf10.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1749659090; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=W/mEdy0USjTWaTNz/wepVU6wHDilzpMXyNq3L9+ubZs=; b=LsKvtV+slK0A215pYVg0TZKIA8JTzyagOyWPFWOnBoH+KD9LhhH8huG+pEIkR8VTMjv2Ug gSFOkB8lrKhD5iLri91cAcLfS3EZQHnJpnF90Dj0KEI0qHM3REfw2zILU35KA/iF2niKRN 7Fp1j50dkxgB4twEkCslJdi/lhSXCQM= ARC-Authentication-Results: i=1; imf10.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=eaHYjnAQ; spf=none (imf10.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1749659090; a=rsa-sha256; cv=none; b=aO4/CypCyfQN9Doy0YBpvC6CI9L0GaVdl71/otXQDj/h8JgS6G3bzz0TfWoA0Yya2rUyJN WIp53Fzj8XPeA26uSvIWY9ZVviRRw7i6qcbv9PboQ3RAlLz22EQWk235ffp4YyBg/IWmyV y0Y9xmhHhXR6KtgFQsKyAYS4MoQLz6w= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=W/mEdy0USjTWaTNz/wepVU6wHDilzpMXyNq3L9+ubZs=; b=eaHYjnAQjk+l4k8bvUXOcZNYU2 9xTjbEQKduSXuDnVD9RGFZ+Kk0L8hTgwFf6iwQeewtv2iM3foO2amM1kc8cLDzgnL5Nom7Y+KY0RG XuVpWZJG10PKVGj1AooaO4kRvwEuIqu+NX/MgqJ/e1claMLZ4ecV8gB2fkcAdcf6ErohuGfzUBAEz wP3y3Mf/aq8BytVCHp/1SbRjMEBHslJcTj7W+oeFUnOhvXPBjLT5e3e12oxxqeff/l5BAZ+RGZOW3 nEoRMg4WDwamnAljr1IBo+7WSjrBQy2B2zjJQVhkBkxAKe9cS6Jv76BnAxpmwtW53arUsICaiitJF fjrsh1IA==; Received: from willy by casper.infradead.org with local (Exim 4.98.2 #2 (Red Hat Linux)) id 1uPNrC-0000000Aoxh-28DH; Wed, 11 Jun 2025 15:59:18 +0000 From: "Matthew Wilcox (Oracle)" To: Vlastimil Babka Cc: Jonathan Corbet , Christoph Lameter , David Rientjes , Roman Gushchin , Harry Yoo , linux-mm@kvack.org, "Matthew Wilcox (Oracle)" Subject: [PATCH v2 05/11] slub: Fix a documentation build error for krealloc() Date: Wed, 11 Jun 2025 16:59:08 +0100 Message-ID: <20250611155916.2579160-6-willy@infradead.org> X-Mailer: git-send-email 2.49.0 In-Reply-To: <20250611155916.2579160-1-willy@infradead.org> References: <20250611155916.2579160-1-willy@infradead.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: C51D4C0007 X-Stat-Signature: cq64xehep8thcaqmbcga3oso1hru65p3 X-Rspam-User: X-HE-Tag: 1749659089-116919 X-HE-Meta: U2FsdGVkX18XzUjBtGQabk4w8xewQpW5Z3mfTZw0oshDMvrYwZSd6xVrfxwop64rzIHiih6A56CB/xitxF6HIbBT8QQhv1jUoJ1DJMuOB7a4SyZrweOT9ph4uyymbQCyzCDdkA9JhFCI8HgwjBEuj20aXv9CjEWLOWOktPX0viVAdQ73Rjr8D1Y/b9Q2VPiiarA/96ik14TIIgk1woZQ9ii0+iwEHW28sgl3e6CcTcEWpJpYv1I0JfSC3BggOGf57ms3TitcdE/runTOQQGL3gwx9izYwHkAelj46Y2Dea9H/4KOp3cce8LD2DxB9DelbmTrFUxQL743S4HOYA+wtrZ7sVooiomdmE5zil+k0fRG0D2chItq9u+lvUUeA/1FA8gQb/KSpmgVHlU7fVdgKXQgPW1yP6bq/1lyvnbdVM1PV8GdQffr60r2sZUTQ1w6db9AwqfDZdHeAB9Qle1F60G5BOYaJVYHmHjKUl2v46qf3Pfv2nk0zzqpwq+hY+ewWfuZ2m964s5BK9ZVCsiGYnNcX/88z5eQNf5RH1y6jiOVahai0dqX+Xui7PLiigzr1vgjz6UOEXFTMiRqLVBBPAgJGbq43lcgv24v+Q3HNczHTSstciZRpVmOyoGiWY4MrOyHIKy7SBYK6U3MzI5GQK8KM8N7RPUqCv5Guf8a5hGOksBSPHOuEa+WQG5y31/QdPYuZAC969/Us3pniqRnNYqnFNoTNbfUYHwLwnSMWD69tLycnLT30Hd1Pki+v1GYsih23bx1sI9GuD0daRJkrhVX0bXpX48xzYA7WWpoS92YCWaeSyT1F1imTqvPtc2oJJDp52Wp/XApmjy3vJLGPapA2/5L0EOxQxlCb+drfLTvvC1FyOovcAujdoKf+tJv5GvryuDBU1hdEq/dit0NNw== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: From: Jonathan Corbet 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) --- mm/slub.c | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/mm/slub.c b/mm/slub.c index 8a1df2ad26ed..c49d820a12f9 100644 --- a/mm/slub.c +++ b/mm/slub.c @@ -4961,12 +4961,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.47.2