From nobody Mon Oct 6 19:06:33 2025 Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.12]) (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 309FC29B8DD; Thu, 17 Jul 2025 16:30:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=198.175.65.12 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752769852; cv=fail; b=REmFbGEhVmJtnc492G+Oo5px6iUvuexYToGnKOlMVYMZlAghGAcBOpioLqZNIEKlwE8uEg1V6vgA3lY/dzJmw57KXW/Y67Bj7HMLVp+DtpnNO1w1Z68rShPM8JQwtxsn86NBaG+Ap2hxrpKtieS7GSAF+POT2O5IsExj/bQkrFc= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1752769852; c=relaxed/simple; bh=JoNLEK0dhf8sxtNqk8GMp9DxPqaD+PZHUFXYed8ITUc=; h=From:To:CC:Subject:Date:Message-ID:In-Reply-To:References: Content-Type:MIME-Version; b=bg+lPJcbk7cj34d/qMOFuAR7Hf6s+DU4b9zYnfayMog8znOW5cvbhVhdl9a9UTXvAZBB+OvSj0cfD5+WFiL8dKUNJqhWuFhAEjUhHKMVm+m1oGtdCiD+b/IuHu+59Qd+8XUn3sX3DAJy5PfXG2iRwb8xxt760jkNSEQXGbcY91o= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com; spf=pass smtp.mailfrom=intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=KuiLFKF3; arc=fail smtp.client-ip=198.175.65.12 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=intel.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=intel.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="KuiLFKF3" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1752769850; x=1784305850; h=from:to:cc:subject:date:message-id:in-reply-to: references:content-transfer-encoding:mime-version; bh=JoNLEK0dhf8sxtNqk8GMp9DxPqaD+PZHUFXYed8ITUc=; b=KuiLFKF3I8L1Ml61V5ajo7feCDWleEcrEpz1a8mMewXQ4QoljhjqmgQs KROnDLaIE7/tqGrt8NCEOQwIbSDhHkVCdZKq2J5KLCCHqJxvW9XMiLt4g 3eug4SlFlqhLva/43YQEsh1Kah18UO+ym3Q5+1izCbe1/xEO93KhMyUK9 1ZBOXN9hvNz085euv9Bqh5OhgbQsBMiO26oC8vgcEb9fDYE0smV+L2pRI t+wRPfgW4ysJjpk+h6VfWwqd0ROfm+9x5YmcbZ5mVl7ePAJVaMMo81Vd8 /3Pf3/ihwu6YXmSk8Rs729/lyux3l5ObLCrL7s7jqxayL4+yExeu/DHr+ A==; X-CSE-ConnectionGUID: 0iNzKyOTSmC7b7wqMbtJ2A== X-CSE-MsgGUID: Db93JbfjQxmtpzy1oTJq+Q== X-IronPort-AV: E=McAfee;i="6800,10657,11495"; a="66501741" X-IronPort-AV: E=Sophos;i="6.16,319,1744095600"; d="scan'208";a="66501741" Received: from fmviesa008.fm.intel.com ([10.60.135.148]) by orvoesa104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 17 Jul 2025 09:30:47 -0700 X-CSE-ConnectionGUID: Eds+SALQSEeM6ygkuwWIcQ== X-CSE-MsgGUID: UVy8X+2HQr+Pf1Q5QVZfzw== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.16,319,1744095600"; d="scan'208";a="158404914" Received: from orsmsx901.amr.corp.intel.com ([10.22.229.23]) by fmviesa008.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 17 Jul 2025 09:30:47 -0700 Received: from ORSMSX901.amr.corp.intel.com (10.22.229.23) by ORSMSX901.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1748.26; Thu, 17 Jul 2025 09:30:43 -0700 Received: from ORSEDG901.ED.cps.intel.com (10.7.248.11) by ORSMSX901.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1748.26 via Frontend Transport; Thu, 17 Jul 2025 09:30:43 -0700 Received: from NAM12-DM6-obe.outbound.protection.outlook.com (40.107.243.66) by edgegateway.intel.com (134.134.137.111) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1748.26; Thu, 17 Jul 2025 09:30:42 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=bBA2eRAP6f7Ai7nHYdUni2ioGv3BaE9Up9pFXFSfISmhCzdF2qP55flmtypJvdXJAiyiO85zC4TWWBELOtFE0Ff3vgueM/8ULK8GfnyP/SBuBAWgVGumRh77lMqqCzHrQiaibsQqPApZDnXinTWfLoGeeY7DAf+7MP3nvJeBt8jJ1+Bs5CdtwYHGxNR+40XK+yJ/fiKAKTW9oKVLC/YlJjqpKYPDXfQ/6ejSsQFSfUsNz4cFsjln2jNpzMk4QdTObNpiaN6kYzb+rFoJAJI0UuUWgpXZ8mEDO7PtwwNHno8Z+OC50JdVs55JunNqScu930qZlNzBlvKDxqaIvUJ4iA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=akDwnOSsWEbarZYWsVr9cHO90HT3Qn6yywgDQDfAFp8=; b=mY1oIbmvgHRmk111FuSCZ+DvhSMMtw6HfF9SXMJ2ZAQ6mCSQCNnpDqidi+Ufw+q3H6OC7sqcYYMbNHM2yTPHlOV7y5Q9YrjxHJXu75Can5Nv5httUdhwMjp7yH5oq5WOT4rm+FOwgEDGfSaR4xYPh+yUiFslUTn8VJ9cL3YdktKfFQszR1zIgaxjaZfQeb7qMzfefc0IzpQX+7+DbtiCuCyhv1sgts7et2XhDtLSKzVApOK3erNuTXnbP3PvRdyv6Blr1gcv3dPfdYMmCVmqynaMNgI9NewLaMGJZ4+xlkF3PHUA5fqg0DhRCVoF3RxZmHWbwymZDPc3wSac88Qoow== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; Received: from PH8PR11MB8107.namprd11.prod.outlook.com (2603:10b6:510:256::6) by CY8PR11MB7686.namprd11.prod.outlook.com (2603:10b6:930:70::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8922.39; Thu, 17 Jul 2025 16:30:40 +0000 Received: from PH8PR11MB8107.namprd11.prod.outlook.com ([fe80::6b05:74cf:a304:ecd8]) by PH8PR11MB8107.namprd11.prod.outlook.com ([fe80::6b05:74cf:a304:ecd8%6]) with mapi id 15.20.8922.028; Thu, 17 Jul 2025 16:30:39 +0000 From: Dan Williams To: CC: , , , Stephen Rothwell Subject: [PATCH] cleanup: Fix documentation build error for ACQUIRE updates Date: Thu, 17 Jul 2025 09:30:36 -0700 Message-ID: <20250717163036.1275791-1-dan.j.williams@intel.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20250717173354.34375751@canb.auug.org.au> References: <20250717173354.34375751@canb.auug.org.au> Content-Transfer-Encoding: quoted-printable X-ClientProxiedBy: SJ0PR03CA0013.namprd03.prod.outlook.com (2603:10b6:a03:33a::18) To PH8PR11MB8107.namprd11.prod.outlook.com (2603:10b6:510:256::6) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: PH8PR11MB8107:EE_|CY8PR11MB7686:EE_ X-MS-Office365-Filtering-Correlation-Id: 16cddd0b-be62-4527-47d3-08ddc54f4448 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|366016|1800799024|376014; X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?rz/PbYwpEdqbuZxNXqmpohV6v5GVWllmzNeS8OCHnla4O945eAM7NrS6Oq6U?= =?us-ascii?Q?SjPEYy2pZpZvTR+jzegIhfK7XVCkZAPpKoHxPVwinT4dcWTAnVcviTt7xLWU?= =?us-ascii?Q?DkH2aby3/8hJ+fgOOM/Gp0FUiEvPejOFIEcAOpempb0jyc/XslUlZ1+z0Pcb?= =?us-ascii?Q?pVn1TqX1pruBiAtIrME0xoPkZqUBSkxy8t+CEqeZAeCUfbhY7HXPqNO/VbY7?= =?us-ascii?Q?FoTQDuPI6pU0NHbpeqAJdZQryLigVDy/ApHnJP3VThy53+2THE458zd3U4BU?= =?us-ascii?Q?Bcuu2CjkFOup/zkMTlAgR3+f/ejs2Cd3s373Nv6vnT0C0v+GgfoUstu5OweW?= =?us-ascii?Q?kDavUVMLslD3BZ6IqRhyrINT8B9djD7n6o/M8Uh97H7v2oo3iPQaSA/1SaTa?= =?us-ascii?Q?ii33gdbdhNO6c1to/0+nUJRufLxl9NjxOGArBFY7al+4brjDaDX5qj3UbHwj?= =?us-ascii?Q?uqEuszm4jqnpLe78QJajt0BKWhavZTR6jiN9O6NShMQYOzAWR1rVr7NywX/H?= =?us-ascii?Q?7uYX1XKhprlTM2sqjrwsAa4x5Ut+LCpJyI9RNM5LkQtgZHiWVLzbzk8/wAKY?= =?us-ascii?Q?ox1DQmVy1BMs2a9zHecsw7Nhv1RUifyy0+ZrzhDg4uzbCR3gAo7+WxYH8YgY?= =?us-ascii?Q?mfsX0cFjyUDNRjcKgYY/hMnly3PYHgPgnZh0u4E2J+WfG5zRmvtxI4yX8ci7?= =?us-ascii?Q?3zeE8r9C9C2LSKTVYkPZWDvG8JrG6y3UqMXBgaK6LigJd8qC83B6ewYO6y8S?= =?us-ascii?Q?JDbuhf2RrNcsxCfu7h81pSxhdroGbtmSWLhI8475PmZooWzpQ3Z6mgyDTg4h?= =?us-ascii?Q?SwC8KDJ8/W8ROtUh4tNAO1Vnr1OI1tyhLYZT2idiae8C/7ZETW9EMtWXo9tX?= =?us-ascii?Q?zcZ0tmHZBS+dG+hfFXIulT2mynDzCWFZL+ZM0+OGIhHJ4a8uWmHLER0t9nCN?= =?us-ascii?Q?Ek4pXmKq2/hcHQtYJbfutKs37yB3drLhmILuZGvpPnnzZGetGu5JrSyG3OIT?= =?us-ascii?Q?MzGEa6Lg6N+7oFCwanM8yyUIAlcdjFORtV7SC9vbWC/wjxz8R4h00ZgtZTNA?= =?us-ascii?Q?NTeNTNdA/N7zt5UgFTDYJl1+IHZ63pYgS/5ESWS6V8qNh93/TH423J5YyE+W?= =?us-ascii?Q?vv2/tt5+mw8ZXXph3rQuR4IUwle629aJNWINLYIiZBlLZKtP0CT58gxwDvpx?= =?us-ascii?Q?ZfYjvNWdawP5OBza4Y93fpA58BUHQizFGjX1SDe+Lc0mkyh2RNSxFMpYxYTy?= =?us-ascii?Q?+TLyfqWtzdHFPzYI/WnlbBEa3YxFBHoatfFs0xoP2rt0md9z2EXnNtISMsm6?= =?us-ascii?Q?3NLcmxEtpFYZD9EOnXMKC2nK8uxPGnPABwHF5XAFMEC/AzYpOj2dBcmxurQa?= =?us-ascii?Q?QldDxAG3LdYSC5jbw93VMeFeJQuXTzZN+tiHtLHiURtMVfZH/GPdmlrfqRCl?= =?us-ascii?Q?gbo29zphIwQ=3D?= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PH8PR11MB8107.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(366016)(1800799024)(376014);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?K9ForIsl22cpYiHVXwb+ifYSzxPg4Htbv8nPBREQI4GelEM5jJt8Mi3kP9Wb?= =?us-ascii?Q?/J6+BRlUlyLKGfX32YmmEBM0upLuN+F1L/uRkhko9dRPSUDOrXTSOfZmUCa8?= =?us-ascii?Q?H9ey/IkRi35Wt2j/q7kwGS8HyIzGUlmbMR0mdfkEdYzMFbabao7F5gk7eBwi?= =?us-ascii?Q?Do4I/TsA0X/+zYjhx7KbmJy/7b3pMlvsgM0zBp6tcm8aAtMWnvGHi3h5V2EX?= =?us-ascii?Q?2ydR5xhYUbNzpfoSMD24qeo8MJq7hRjXUqJAz1LPSWrWqR9sQrM4q6YM3dtJ?= =?us-ascii?Q?68kctOS5IMC3aWzCchK6LMRgXc/0OUhmmt3Z+8b1UudkKjVA//RLqCrI2Bbg?= =?us-ascii?Q?j8JM12twXSnTRpnhDtR0W4CjP0SK1g7+pGIsMkFRv6XJI3rCLgdQg7I7FtLo?= =?us-ascii?Q?oicPRUz03Tcud93tqoO0I7yDtQUVSLdPtUL5DAUsPoqv/vl1PIS25BupdoVe?= =?us-ascii?Q?kGCiVgOP4Y2gmNCPWUODegEnsbpB3Fq/UvdHAZbSGIvkT5KH/cN+1wx7do99?= =?us-ascii?Q?f1mWk6uFTnE0ozwqCCepTCRGChT/oqPEoH7mIvNmK0DDBYCQsQ/BPkeXdZ7K?= =?us-ascii?Q?rK6F6Wkf+w2n26983mKETQWCEX8d5mMp3s3MZdaBhE1rMZBXqU2hWyrFyN+u?= =?us-ascii?Q?WX7uV/J58B10okKi3QbjpI33qyY/3s3gT6UgTg09ZcK3bO/0/yx7bIl3dS2X?= =?us-ascii?Q?gGTUX4UjTZp7ng09FvFEClnpon+AL5ce06NDFAVKdYa43BFSoeqKztNHrexv?= =?us-ascii?Q?psFtwFGrz90oT5loep+FJCUd5UE+iciYLksvjzanWmr/gh7cDHARyM4CbAGU?= =?us-ascii?Q?lOEjxaoNyobgFuk0LFuMol4MAj+ldHTUyb+BYVgRZd6kAY0TpyrhGwpdfL/N?= =?us-ascii?Q?mhs6PhW3nu/7/hlcYeCPqAJEx9AhNc7WKlzhFYFmmxxUujRBVfv1eMY+QvtR?= =?us-ascii?Q?FsDgk/RU8fB6Vz8yTfBEKSglO2EreaxDSwSmY/EUpkE58j9QpSspBhobSzIm?= =?us-ascii?Q?LmjY7ZSFtLtqBwU8IVe9BfTlOWMiGwk85eE0K3Zx19W681scRFEg5ET+Tg80?= =?us-ascii?Q?Qz0J2VDAS6ABLEps3yODiOz9yb2hMBWlqqVlHT7i36vDH0LjJ+IDKdGEhYJG?= =?us-ascii?Q?Z40WM6pbbBThTgV9gGTbqSjOd0ZCL/iECxWhWIbLXK05dCw39MFMUpbPxMwP?= =?us-ascii?Q?WqdF3vvlZSWI8tPv0EV+DUQumz7fFlpqOzVYG2XwEMo3d61jUoYuVcuHBz0W?= =?us-ascii?Q?nmgk+6vql1tOt8CWj6/aY+sMuFFTn2H+/fclRqhhM4OV8SFiH/YLTeBkyGua?= =?us-ascii?Q?QgX8IaMGIgFTYK2OKLrmG8AMfyrfLWDh8kQvx5Tto/jndc2m1XqmAc6szZji?= =?us-ascii?Q?9dK1fr9RKqfDAH+xnpPWJTAaRggmb0gu++iuf/S0SeEw8KOtxscIb1xR17wB?= =?us-ascii?Q?6UrBrc8C/ynParki409vWnO9hS6sTAQ8pRsaMA9z4WrI5ZPJ+i/idSiNEETR?= =?us-ascii?Q?9KtLf+ZfyiGqkQS2wYRBv+E8bhSmvev7Y3OX5kd6SxW5saIh6rZZM/7aBkqS?= =?us-ascii?Q?UlAf553Ni0fdpxWcp47WMVYIVarg/6OD619MOzcePeO9HsmCk8I8uzB39TWB?= =?us-ascii?Q?Fw=3D=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: 16cddd0b-be62-4527-47d3-08ddc54f4448 X-MS-Exchange-CrossTenant-AuthSource: PH8PR11MB8107.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jul 2025 16:30:39.8845 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: zXeVnC3Pu5nq241LtB0JwsWX0OLFTbspA7t9na0yhrY0OVVNnfwnfJ3JG+yopaPigvUvWCWKNsKQdHZAkXWrnfFMGPTf3ruJw5U9BuD2o6o= X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY8PR11MB7686 X-OriginatorOrg: intel.com Content-Type: text/plain; charset="utf-8" Stephen reports: Documentation/core-api/cleanup:7: include/linux/cleanup.h:73: ERROR: Unexpe= cted indentation. [docutils] Documentation/core-api/cleanup:7: include/linux/cleanup.h:74: WARNING: Bloc= k quote ends without a blank line; unexpected unindent. [docutils] Which points out that the ACQUIRE() example in cleanup.h missed the "::" suffix to mark the following text as a code-block. Fixes: 857d18f23ab1 ("cleanup: Introduce ACQUIRE() and ACQUIRE_ERR() for co= nditional locks") Reported-by: Stephen Rothwell Closes: http://lore.kernel.org/20250717173354.34375751@canb.auug.org.au Signed-off-by: Dan Williams Acked-by: Randy Dunlap Tested-by: Randy Dunlap --- include/linux/cleanup.h | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/include/linux/cleanup.h b/include/linux/cleanup.h index 4eb83dd71cfe..0fb796db4811 100644 --- a/include/linux/cleanup.h +++ b/include/linux/cleanup.h @@ -64,8 +64,7 @@ * the remainder of "func()". * * The ACQUIRE() macro can be used in all places that guard() can be - * used and additionally support conditional locks - * + * used and additionally support conditional locks:: * * DEFINE_GUARD_COND(pci_dev, _try, pci_dev_trylock(_T)) * ... base-commit: 857d18f23ab17284d1b6de6f61f4e74958596376 --=20 2.50.1