linux-kernel - Re: [PATCH v2 3/8] docs: dma-api: remove remnants of PCI DMA API

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <7a31ca61-755b-46b6-9f49-ec1fe7f59451@infradead.org>
Date: Sat, 28 Jun 2025 11:58:12 -0700
From: Randy Dunlap <rdunlap@...radead.org>
To: Petr Tesarik <ptesarik@...e.com>, Jonathan Corbet <corbet@....net>,
 Robin Murphy <robin.murphy@....com>,
 Marek Szyprowski <m.szyprowski@...sung.com>
Cc: Andrew Morton <akpm@...ux-foundation.org>, Keith Busch
 <kbusch@...nel.org>, Jens Axboe <axboe@...nel.dk>,
 Bagas Sanjaya <bagasdotme@...il.com>,
 "open list:DOCUMENTATION" <linux-doc@...r.kernel.org>,
 open list <linux-kernel@...r.kernel.org>,
 "open list:MEMORY MANAGEMENT" <linux-mm@...ck.org>
Subject: Re: [PATCH v2 3/8] docs: dma-api: remove remnants of PCI DMA API



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 <ptesarik@...e.com>
> Reviewed-by: Bagas Sanjaya <bagasdotme@...il.com>

Tested-by: Randy Dunlap <rdunlap@...radead.org>

Thanks.

> ---
>  Documentation/core-api/dma-api.rst | 25 ++++++++++---------------
>  1 file changed, 10 insertions(+), 15 deletions(-)

-- 
~Randy