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 98C77D12D78 for ; Mon, 11 Nov 2024 06:38:56 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 2A7AD6B0083; Mon, 11 Nov 2024 01:38:56 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 230A16B0085; Mon, 11 Nov 2024 01:38:56 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0D2326B0088; Mon, 11 Nov 2024 01:38:56 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id E15046B0083 for ; Mon, 11 Nov 2024 01:38:55 -0500 (EST) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id 8A4B8AD768 for ; Mon, 11 Nov 2024 06:38:55 +0000 (UTC) X-FDA: 82772861052.29.E7F0056 Received: from verein.lst.de (verein.lst.de [213.95.11.211]) by imf29.hostedemail.com (Postfix) with ESMTP id 57F5712000E for ; Mon, 11 Nov 2024 06:37:59 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=none; dmarc=none; spf=pass (imf29.hostedemail.com: domain of hch@lst.de designates 213.95.11.211 as permitted sender) smtp.mailfrom=hch@lst.de ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1731306960; 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: in-reply-to:in-reply-to:references:references; bh=cOb277arSCKCjUv25YUtltHFeCBKt9wBpzLvkC59Bac=; b=agvh9hctovn00L+4LWQzPRoflgxwneTWQ502AapnhD1MWAcXxGt8Jwo09o7JehDugnlLvn PRvNjzPQJ4LOlvAVpHBDfjLwme2Lv0DZ7eFYeVMuQdYIBaj5atPNBMONfVijr0bpwpmL6J 8SliFHbFugor86gqkeAaWX4Ykp+ZY68= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=none; dmarc=none; spf=pass (imf29.hostedemail.com: domain of hch@lst.de designates 213.95.11.211 as permitted sender) smtp.mailfrom=hch@lst.de ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1731306960; a=rsa-sha256; cv=none; b=1KAh5QDxh03JbEGQWreNZAkTrdWwdtKcvvwP9fa/2/oPLbWZCNAzRLYVZi2Ba/GG7aqB9E Jo4UHvuWfRGoKDAokXYglPDUn8CGEQ6U9LRoxJfiuOSTLA+3ohiyqQeGo76tY1NzfOsJjj FxKwAK5mmLwznJZGAig+7mPLZ8sqy5c= Received: by verein.lst.de (Postfix, from userid 2407) id 93F2A68C7B; Mon, 11 Nov 2024 07:38:47 +0100 (CET) Date: Mon, 11 Nov 2024 07:38:47 +0100 From: Christoph Hellwig To: Leon Romanovsky Cc: Jonathan Corbet , Jens Axboe , Jason Gunthorpe , Robin Murphy , Joerg Roedel , Will Deacon , Christoph Hellwig , Sagi Grimberg , Keith Busch , Bjorn Helgaas , Logan Gunthorpe , Yishai Hadas , Shameer Kolothum , Kevin Tian , Alex Williamson , Marek Szyprowski , =?iso-8859-1?B?Suly9G1l?= Glisse , Andrew Morton , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-block@vger.kernel.org, linux-rdma@vger.kernel.org, iommu@lists.linux.dev, linux-nvme@lists.infradead.org, linux-pci@vger.kernel.org, kvm@vger.kernel.org, linux-mm@kvack.org Subject: Re: [PATCH v1 09/17] docs: core-api: document the IOVA-based API Message-ID: <20241111063847.GB23992@lst.de> References: <881ef0bcf9aa971e995fbdd00776c5140a7b5b3d.1730298502.git.leon@kernel.org> <87ttchwmde.fsf@trenco.lwn.net> <20241108200355.GC189042@unreal> <87h68hwkk8.fsf@trenco.lwn.net> <20241108202736.GD189042@unreal> <20241110104130.GA19265@unreal> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20241110104130.GA19265@unreal> User-Agent: Mutt/1.5.17 (2007-11-01) X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 57F5712000E X-Stat-Signature: 49b1xtkkb3q8c18njam4di1e8rskeoas X-Rspam-User: X-HE-Tag: 1731307079-801905 X-HE-Meta: U2FsdGVkX18V2vS8thPUlD1QEXE+SSF2A5PyhFgHrmk48z7kFoeFEYVPp9tgTBMzlyl/A0hfRlEVxsfyAUUGK3MZViHonwGRFQDquMys3S/+LNzGN4xYZxDF5pYX7Ggr7ZiZJ6IxlnEYiBtVeh6QDVmV4AxI9lSQ/gJsvElcJ/n2w+qbVJzas4k5wEdm2S+8joxj+yPUDkGLOVWEkiFr2NTnwZaHP6Rpnu6DnDIEFHdKPZhVLUiAOTcGIhA+Ws/w7JIoMHfbj5i/+JXP5dCZ3QPbL3dPQ36k6TvEYc3SklKGONB5C8JfDryCNfdvIXCUPMSu9C6q9FMmoLfvjc3rF4UqDrhfOeVwb3UIbnWP7BC5Sgot4rh2nm51N+tnKSLVl6HQMD38jgCiNvKGo6pLyrkjBZ1TyXbWbEVM6gEnfmK0oJoXN2NXgCMKjLC/jpwkMOsLL/dZKz+p+ouQPQWNivXeVeq2/XDjUodz/+hp1++Y+D7sXMpW0JdWXD2OZuduN9DcCnLP+QfPflIlcHwABSX78vpNcyE2Vlj737FbnMePJucUlbOpxQhqq4pEHYBUVnRPhLsF7Ag+fThV5DDRwftxelqCZm0CRLO8wET2Wj9d0n+7FkNXaC86JF30R3Pxk4p1Ds7ag5pOF49FbFoWkUX/pOoKlflx+q1ir1HITbnrSfSHa48z2f0TeyPCpCtzntwiiMnGOn4am5VjgH3h41FRe4KrTyg6RRxVjkNWpu95Yh+tHpsUUfRa2RveEaHRLBt7pWIwAoie4C4dCFYdGSnblxAoChPWf1nYcbcSN/VG1Ot/K8a1DeZkGNicxB73Ua0g2Jyx8pWZGWklBY7m0k4RUm8XOhX4uc7B87RwJbbOzRHvmyHZncpMzSXxfk2heYQn7ZREabgIiqKKICV/loPN2vPOpBBHfA2eeCqwgB0YaSn/1x9he8e2pzhtsWpqwtJGyV+p37ju92saTMh /GG2QnT6 VZA9FnwUmLGYQBbVkTHN7qwUNjmsArpXT8Vd6gC9bdFxNTrS5P+vm//AI9B0/jTfcdsVgxujwK3LucYs= 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 Sun, Nov 10, 2024 at 12:41:30PM +0200, Leon Romanovsky wrote: > I tried this today and the output (HTML) in the new section looks > so different from the rest of dma-api.rst that I lean to leave > the current doc implementation as is. Yeah. The whole DMA API documentation shows it's age and could use a major revamp, but for now I'd prefer to stick to the way it is done. If we have any volunteers for bringing it up to standards I'd be glad to help with input and review.