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 ED045C7EE39 for ; Sat, 28 Jun 2025 18:58:23 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 939446B00A3; Sat, 28 Jun 2025 14:58:23 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 8F3016B00A5; Sat, 28 Jun 2025 14:58:23 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7FFE86B00A6; Sat, 28 Jun 2025 14:58:23 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 6C71F6B00A3 for ; Sat, 28 Jun 2025 14:58:23 -0400 (EDT) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id EE5C9BAB1A for ; Sat, 28 Jun 2025 18:58:22 +0000 (UTC) X-FDA: 83605720044.11.EDF2118 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf13.hostedemail.com (Postfix) with ESMTP id 4F8F620007 for ; Sat, 28 Jun 2025 18:58:21 +0000 (UTC) Authentication-Results: imf13.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=sgTV00gh ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1751137101; 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-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=1XvlWuNp4gjBKcSdNzZU5KMUhpIwvZVJU4F+yvgKsxU=; b=JNbo8eZi5eX+NInReOKy5drk92rbKFwCnqqcKUvuHQKY6k4+6NwTJfsi9GcpI+F29FduTZ B5ryI01YI1WbgQu9fYeKb+xhEabPjSd4Wk3e5Z4IAMX0qtRxGRmPBiW1iczS2K/FwRT+P/ JFRURwjOJ5yZ4ddntjBVleY/Ng9ZQlA= ARC-Authentication-Results: i=1; imf13.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=sgTV00gh; spf=none (imf13.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=rdunlap@infradead.org; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1751137101; a=rsa-sha256; cv=none; b=ko0K+12pSHjH3S/zmQc040IT39VMKh4m6FBLUAaXBRfeaee3r+Q8sO+gQFWLixetZ/gnGF vBGkIDfPdOTddARgBODl6pmZ0+9O4eN2/E9fa0oOctAlWHVHNNH6XlUfJuxw88HZRk7kUs kTdgY8y24sDlzWlUF1TkTGkIyeo74ZU= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date:Message-ID:Sender :Reply-To:Content-ID:Content-Description; bh=1XvlWuNp4gjBKcSdNzZU5KMUhpIwvZVJU4F+yvgKsxU=; b=sgTV00ghbPFAZXetQbmng4lo2s Kuh59y57uL4JGNrM5Pv+VbefBqyAKhNjPMUaIRemEMNdGP9+orVIBHtMjE/1mUrPvxDKr3B56VCWX DTBhdPyJKcEX0rUUYnkc+JRiDshMvgC5N6o60Ks8qgjjeUyNGMOQYUWnxDVznR6jPlG/n2tDjSIXD t24n6azfck+LxxBmIVG6pChucWOGlNBb5T3sVVGij+oZ3Xx2GWyKjSObS2FRsIGa7hHvCowS28x/U Jbc50NuYv7Ovm0KqBeE7gpSWXlWNDXdvY4egWy5XS6kKOnkT4eQ+zIzga5R5xNxMbw287JO50lSi6 LpNE5rjA==; Received: from [50.53.25.54] (helo=[192.168.254.17]) by casper.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1uVakh-0000000H7hU-1DZz; Sat, 28 Jun 2025 18:58:15 +0000 Message-ID: <7a31ca61-755b-46b6-9f49-ec1fe7f59451@infradead.org> Date: Sat, 28 Jun 2025 11:58:12 -0700 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v2 3/8] docs: dma-api: remove remnants of PCI DMA API To: Petr Tesarik , Jonathan Corbet , Robin Murphy , Marek Szyprowski Cc: Andrew Morton , Keith Busch , Jens Axboe , Bagas Sanjaya , "open list:DOCUMENTATION" , open list , "open list:MEMORY MANAGEMENT" References: <20250627101015.1600042-1-ptesarik@suse.com> <20250627101015.1600042-4-ptesarik@suse.com> Content-Language: en-US From: Randy Dunlap In-Reply-To: <20250627101015.1600042-4-ptesarik@suse.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Rspam-User: X-Rspamd-Server: rspam05 X-Rspamd-Queue-Id: 4F8F620007 X-Stat-Signature: ibr5yfj3sj1fcqncqwsu79j57hajy84j X-HE-Tag: 1751137101-123692 X-HE-Meta: U2FsdGVkX18Juz2rj09Ihkj7TYfidjitfU1JxiZBM2fg17+nc1hIXeHSV0p0NbFvZynsedK6IUUd5zM1tgk5d64vOyt3qXb+Hz0gLwmSq0QJLo0xmH3PXhmQ/DBT38R++Koq5ce5v5OBX1VlppnoDrUjj51mjLXQkFRIrGs+I1XwI/Lz4ReUQOb72tI+gIbi8xCUBMqcq98d/kO0f6cURIqIFfHlMS3M36vllmYfVtjLicec4v7Kho8wogB17rK4qMeloI78j0V3TieQelu4XziOggVfh0BvYzAcsNuxj/G16ob6MGaL9q3rM0QCDJCeynsNMWRRyWK+3jvGg1XuF0F8mQPorUf0cUdLfJhCOJyrs1BD+oy/63kL/KfrGiveWH9aplkaxbEDM8/YZzW529vDAD2eaueBmAm8Kh/rkg8oNR81ozNh9aLk5CTlY31PjXk+T8mtxacgSDZ7C5Q99E+lcDxaIOflkmvvclNfTmydny7P7GIyQl6+OtfqinhsBDE8CMo3ynb8ugRrLUuQp2KD7n1zvODNVEKN+tElXAkOJJmNeoBdokP9qTMFj85/GpAObZbXptfQzN/7BK05MJbffHcePdC0L8PpAuTC2cBELTO2vEt2x5s3NYRXVhcjN9qW3905Jn7i85zFQ7GTtf/GqgzQ6qLGUYwxNPH6W804ouugUDJsKyq1PqyoPE9YNLaXTgDPNsaWJF0W7nFWmlOs9sEB8M+Ez/xsr4f7R//z4es2PqPSoAFx1kfL3lcgBuXLmPBGnS583py1sAjgJJcydvcrvmSLCllXb2yX/FkWUi/izkylFvzjGnwCc81/4z7R5ETSQGFp3pEFsUugDUF42tUyz8Lr+uJAKXSANkfmKjEYTZkhQbYO3kgtMDhTRWyAPTf6PuGF7OZ86DPFmwL6SKSdTox4j3crXY4gvYmkPxWPagh2ZYru5WqzXR2ZkDOj7lk3VcfArFmSjJk UqceAmoH ErpBVdiqBxYEI80vsbzJTcsEJJRSCa7VPP8uFu3A2+7UeV3enFzGsyiEVBQYbHU/u92VRVTZ9zYzwq9ekUgIIlMKEajhMsdp3BiJ/+z9G0hhU8mLeqL+t9Rur+sI/fSp4o5tCS9ZlQaegW0HhQiNk6+ALo+xiidujSMwrU+7g0Fsh3feVHSwYKZu253mt8PJ9ge2ecZ9gfTDp5wOU3ZUgtPV4bzH0s0q2VhuVZ3Zx9UMisUIM14P87L9hEbrVivO/G7kIIxB0p08t19yp/8e3tSGeGtuGEGkKUZA6+ClbIa0UPkMuNru6A3odnSEDVtISBlfI 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: On 6/27/25 3:10 AM, Petr Tesarik wrote: > The wording sometimes suggests there are multiple functions for an > operation. This was in fact the case before PCI DMA API was removed, but > since there is only one API now, the documentation has become confusing. > > To improve readability: > > * Remove implicit references to the PCI DMA API (plurals, use of "both", > etc.) > > * Where possible, refer to an actual function rather than a more generic > description of the operation. > > Signed-off-by: Petr Tesarik > Reviewed-by: Bagas Sanjaya Tested-by: Randy Dunlap Thanks. > --- > Documentation/core-api/dma-api.rst | 25 ++++++++++--------------- > 1 file changed, 10 insertions(+), 15 deletions(-) -- ~Randy