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 B005EC7115C for ; Wed, 25 Jun 2025 06:41:42 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 54D896B00C1; Wed, 25 Jun 2025 02:41:42 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 524D76B00C2; Wed, 25 Jun 2025 02:41:42 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 43A946B00C3; Wed, 25 Jun 2025 02:41:42 -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 33AE16B00C1 for ; Wed, 25 Jun 2025 02:41:42 -0400 (EDT) Received: from smtpin06.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id ED9821419EB for ; Wed, 25 Jun 2025 06:41:41 +0000 (UTC) X-FDA: 83592977202.06.3DDD05D Received: from mail-wr1-f47.google.com (mail-wr1-f47.google.com [209.85.221.47]) by imf16.hostedemail.com (Postfix) with ESMTP id 00AE9180006 for ; Wed, 25 Jun 2025 06:41:39 +0000 (UTC) Authentication-Results: imf16.hostedemail.com; dkim=pass header.d=suse.com header.s=google header.b=a9P+UzE5; spf=pass (imf16.hostedemail.com: domain of ptesarik@suse.com designates 209.85.221.47 as permitted sender) smtp.mailfrom=ptesarik@suse.com; dmarc=pass (policy=quarantine) header.from=suse.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1750833700; 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=nv4j46Gn/Kvr0K34agGb6tcrNF0OwBTrFfOvFYIVMos=; b=62qcyWvo9P6D1UkBadcMPEY19tUd/1dCOkVI2zexnEB43Em1Ax9FkKK9ceS8/ToYJZQzEE 0AyPxRyoyiYXut5fk/P4h+5fAwiA3aL+JtGsWgs2xY2WVRUxkITT9u1/72VFC6cklFavhE VwAkbYdm/wTrXQb54feaT5mY8Vv7HSk= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1750833700; a=rsa-sha256; cv=none; b=GHkk8i2kcNR+yp3Z+V+40laC3nv72la4/9MTbeF5zK+pJTIb1kJQznLe7CWjrIkjcfU00b DuzXCYE3GWWvuQFDZ7iDWb2LUFAZsxOMlyUjVSmrO/sFPmhV/SM56EGUmYG3QAV/GNqAYx B32pYAnETOLYGJRWejs+qWkI8e6iyrg= ARC-Authentication-Results: i=1; imf16.hostedemail.com; dkim=pass header.d=suse.com header.s=google header.b=a9P+UzE5; spf=pass (imf16.hostedemail.com: domain of ptesarik@suse.com designates 209.85.221.47 as permitted sender) smtp.mailfrom=ptesarik@suse.com; dmarc=pass (policy=quarantine) header.from=suse.com Received: by mail-wr1-f47.google.com with SMTP id ffacd0b85a97d-3a52878d37aso927979f8f.2 for ; Tue, 24 Jun 2025 23:41:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1750833698; x=1751438498; darn=kvack.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:from:to:cc:subject:date :message-id:reply-to; bh=nv4j46Gn/Kvr0K34agGb6tcrNF0OwBTrFfOvFYIVMos=; b=a9P+UzE5kP2+VcV5jH2OIVdRWi+Di53ieXw+GAjJF4qmo3JAiLPUj+1cxKufZU3NJd 0U8fVpryDH9+8toG+eN+09tNZfWomDJ5CLf9MNHqTnL6gQcjjzFS8ah9VTIXovhv3oNM 5U6J59Dfu4b4TdJZEpKI1+/kcS5o++bhXG2xSw3OuncsIejaWXO/OWYjW43Rch9JuKCq ErdeOS0tFYNV8DTfbFZXxX0walQMjZ3jnbfDp7e5yFCT3wBKXi1wBUbVNFGddFE+ERUZ q6+U+oseaUeu9tbGIb3jR0Fh5rzwkWFw8aUfiwhRF3ir8N8VpyBLgpWsjGB3VYKJcSxA Nlhw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750833698; x=1751438498; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=nv4j46Gn/Kvr0K34agGb6tcrNF0OwBTrFfOvFYIVMos=; b=OvH/1GySwiqCCjbxCxI7mKipVbfLdrIugq/WIO2U6TRi5LzT5KVmhiXJBcdSEQ+A9V KXuJcNSHg5lw9GLxY/Qw68ICaX8EnxgUcP7ifeyVgyLJlLOu+pQFzfDhUjFIBKISbPzQ mDLQHNn0r9pTJImvSa88tpYcFN8IlqFNw3drG0pMVpG1Vjjq7h+ssaQBCzmB35qABQLr 9QeREHCzpdPkTn4oKdZB9ibvo9NMzDsJn3ifhMJwhPiIDFwtOOKfYT+kMd1EzJQ/8mGm xiVSksbCa0YfBbaz18065C3ajQyIskGjE/AG+KbZ8kDjlnGYyIUfBzYQ3TTi2blLaWtS d3tQ== X-Forwarded-Encrypted: i=1; AJvYcCXuAbAOrkV0n7WFW33n0eehMqZjAwTAIxkv3dyRdsaQdS2H2zSMQqskbZzTwlC8N7whCjfFxwy4jA==@kvack.org X-Gm-Message-State: AOJu0YwRQRjZzCmpsbKNdBZ24h1Vs67qgy5qXuxABhn6IcEyCrLkMQ5g 32I+DQobDFxzGMpgidP4xnLTj+GlwJZYgAoj2M53Z0Y1kNst+NKRBsL7bSG7VJBu+vQ= X-Gm-Gg: ASbGnct+VnkmydC//pbfU/Nljulzgne1EaI3hK6/N5X4+D5NgO8WIhd6PVsH2E5BGL3 5cLYfgTyT3UkQQDFv1uLaGRFBuE/CSrcl1Lyr5DWRFtkV80hby9xQ3hAkJD9NeCI+3gpHm7MX8h ktRzrw4FzfTqir5GUBmdLqhT712MfNo5coW8dircevXrr/erJlje/1raKTFGjGngjNgVfyMwn27 rNkELxV0FoyJwnfJ2SGKoNlk6U97tGNkw5s4AnfjUrYm+n2UPDQmf3huowMweO/9djVpMhSdJhN v//tbC+m5DeSNtxBo9f48XEAlm0kFHaeSimoOONEq6695HPUZM9UfurXZh3+RamsxONQJXfjsoU lhpa93k/XDKbr/EhYZ4qPKyzpT2saNFQLbKxI/cQXEzZckxq5AVdFxxslPV6x0eZC/JM= X-Google-Smtp-Source: AGHT+IE7FEwxOxfhEE+iSFV9n5lEc4KGhMLsGRyFhWyAeSVP2PCDplXp/ktSglgcn/Fs2s3oXQVjvw== X-Received: by 2002:a05:600c:524d:b0:442:fff5:5185 with SMTP id 5b1f17b1804b1-453821a8633mr4333875e9.6.1750833698266; Tue, 24 Jun 2025 23:41:38 -0700 (PDT) Received: from mordecai.tesarici.cz (dynamic-2a00-1028-83b8-1e7a-3010-3bd6-8521-caf1.ipv6.o2.cz. [2a00:1028:83b8:1e7a:3010:3bd6:8521:caf1]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3a6e8069467sm3646226f8f.42.2025.06.24.23.41.37 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 24 Jun 2025 23:41:37 -0700 (PDT) Date: Wed, 25 Jun 2025 08:41:35 +0200 From: Petr Tesarik To: Randy Dunlap Cc: Jonathan Corbet , Morton , Marek Szyprowski , Leon Romanovsky , Keith Busch , Caleb Sander Mateos , Sagi Grimberg , Jens Axboe , John Garry , "open list:DOCUMENTATION" , open list , "open list:MEMORY MANAGEMENT" Subject: Re: [PATCH 5/8] docs: dma-api: remove duplicate description of the DMA pool API Message-ID: <20250625084135.02a1ab09@mordecai.tesarici.cz> In-Reply-To: <5ea93880-72fa-46c7-b69b-82e2021aa567@infradead.org> References: <20250624133923.1140421-1-ptesarik@suse.com> <20250624133923.1140421-6-ptesarik@suse.com> <5ea93880-72fa-46c7-b69b-82e2021aa567@infradead.org> X-Mailer: Claws Mail 4.3.1 (GTK 3.24.50; x86_64-suse-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Rspamd-Queue-Id: 00AE9180006 X-Stat-Signature: gmqpfh391136b3rbf1kcnmp8gorwx9y1 X-Rspam-User: X-Rspamd-Server: rspam01 X-HE-Tag: 1750833699-500614 X-HE-Meta: U2FsdGVkX18oU7fHVA7HfzDFxixL72MragL2JoMEl/0euqLURQofzZRE0eItYSDsJSYFFmB4mbbSh+qXxPg1Da1Qgv4kEDO3bFvZyLeD6mV6FmOHxuwtW5yt+zZKC+OCkpssx9j9oOxZS2ikcE8yDmDKxaWghPGcqdM4BBgmGk/j1SNN3bYRj7Bn+peQFEjRt1ewg/9T3rrAi1ft7gTpxYvOcMOt+pTwS2fqDAll24hdsH8+2PFm51zgvx1BsS1I09owCYO4jt/EsEgMch+F87vWtunvTqG+Ec89ZuEf/Ugs3chGVyGG8GZDXbf9cIPDHyt3EL7VE9/iMzpL/fHDh0T5HEwnNrO7yJs7gyQ0j639+C8YOFaB3KhGFCU5kcQB7Bshpbuz+3a5okKQJVM8+epAUw7v3s1yzJc90gnlWRLhE4F2LwyjcFyPc3XgLbkxOrH6tegCzvEENYfiqU47bI8nckHrb3kWiVvmsZVqG9dO0YnYVrGE4BdbTpsGk+TgaKXx1zAPMmp9IvBozx5lCo1bqHDyJqKI9GkTcJSnwq7m8MA2+kaCMKHNZVbKGdlcKWh4+FcYveao/GEdqN/q+mVjyLNhb6dIP4OLcIe3C6irl333d0bGvHOL4IkINblpvnB2LcfrpLPK7JamlhxcPzCD0HVUgcH7vitiB4RrqGshdN1O9ocP2dvSWNrMVwSCKRzS1pm4HKCePS+XV6F2P0fgCCtx/kMggRJShLnsL1eFpHzrGABKRJrsjLIoF+jH6Ca7T9PmKxCBbFwHvdbh6ji38Vzm13XslpZ0UJ2VCgpjADNGnm0qX3Ow9UbFSpBwovxu5R3/zkQWha5FenpdkvWv8LRFw7c4qIYpYAzH1sh4dLX/Y+Hi0lx+tUgwNkvE+Z/4774Vk37pUQ3cM7N6A2fHLHjRzpQNFW/+NwtKSqrwvFvOBjZ9I/cltFpc6NCizF80MOZT69Aq3nLWH+G 5KZKqukh 0xJJRIOXhDZYjj+VvJSHSEgva/lEd7lHxIeeZqBT0d0E1wODiOLp7PXtVfq3DMBKFl/so2HdWnZeSJHycXaY0yvOzaMFMCBV6VyHM5t8DuVB3t0T6X6Ck00UvahpZxFNWd5klaunxRKCcRbc6ECgGHgAWth5GmMouTz5c931ztutoniIUANz9iBPf8gP/ScgupFi+fPE0nx9NB1KaMRgBWymy8W29S1AxUNDyXNoOU8QVrCHMyM/Edz5UjKQcYQQwbH+6fRDVDwjNKyhl8Tr1vzcPFQ== 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 Tue, 24 Jun 2025 19:40:37 -0700 Randy Dunlap wrote: > Hi, > > On 6/24/25 6:39 AM, Petr Tesarik wrote: > > The DMA pool API is documented in Memory Management APIs. Do not duplicate > > it in DMA API documentation. > > > > This looks like it works (from just visual inspection), but I'm wondering > why not just move all DMA API interfaces to dma-api.rst and don't have any > in mm-api.rst... ? That's also an option. As long as documentation is not repeated in more than one place, I'm happy with the result. Now, seeing that it was you who originally moved DMA pools from Drivers under Memory Management in commit a80a438bd088 ("docbook: dmapool: fix fatal changed filename"), I expect no complaints when I move it to dma-api.rst in v2. Thanks for the idea! Petr T