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 39C84C36001 for ; Fri, 21 Mar 2025 13:46:58 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 1AE1F280005; Fri, 21 Mar 2025 09:46:56 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 15B72280001; Fri, 21 Mar 2025 09:46:56 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id F41F6280005; Fri, 21 Mar 2025 09:46:55 -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 D41C3280001 for ; Fri, 21 Mar 2025 09:46:55 -0400 (EDT) Received: from smtpin21.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 12C40ADDAC for ; Fri, 21 Mar 2025 13:46:57 +0000 (UTC) X-FDA: 83245684074.21.ACD5BA4 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by imf04.hostedemail.com (Postfix) with ESMTP id DECA040010 for ; Fri, 21 Mar 2025 13:46:54 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=JEshP6ni; spf=pass (imf04.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=pass (policy=none) header.from=lwn.net ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1742564815; 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:dkim-signature; bh=2bzQ39oJ6FKRT59C+Uimbt2z4p+cGnCUiJQU6Ut1RkE=; b=1DlW7PHZZqxLDFzLEPkOUnb4QE2mxbt6xkERyRsYvDUDjZzpODxhFvsUbvekVS1NFxeAWk wBjy/M8ieD88DhSDU+Hq/Gtzz9pLXZyzViYlBPB4cGfTHLvmYUaSihVKY2YOnxrh8zJ6Q+ oh4i5CD31gfOV13k4Z9OwZQhaXld7F0= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=pass header.d=lwn.net header.s=20201203 header.b=JEshP6ni; spf=pass (imf04.hostedemail.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net; dmarc=pass (policy=none) header.from=lwn.net ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1742564815; a=rsa-sha256; cv=none; b=FpBmlCI1L5FcZcsQH7mOj0xXXgW1znEmhM/u0zxJNzFJsfQRZ+cXPtCZwKp/qMI6cM7nMv fFkG72/89UUdgPmjDrueM3Zt1h3DwZk4hZs6okB+qFGj0yn7yJY8KOKb3h8b6kxnV6sLUE dZ4jU9NZ4ipSwbhznOMZCxktv9B1Cc4= DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net AFB0541061 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1742564812; bh=2bzQ39oJ6FKRT59C+Uimbt2z4p+cGnCUiJQU6Ut1RkE=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=JEshP6ni6yTLpiaYeOas9Jrjng77WDd/fjCMr/gyDDWDqacAJ+YuUA8xDXXFER0bT skcsq4eOugcFKMrAOhAi5bJelZY5jeMWSuiex8mG+kjmeigm/4eb4IX4uDvZ3rhzjb uTPpLNk55qCifj+0RtgKCO8lr13t4OjPqyVdNXdKWcdpjLB8vdRS7mmYjWkYli1QVF T6JGg6nJ5dp6Iys4YrQyveK3B7Qdrjs1qbajVQPpCSuKoxwQMgI28OvBtX2zxUm4cl YmbNWfFdDGyr3sOosFT031TE7EXwH8N3uAYsRNSTCevKWhC1dLLjJq+wYgtYrWpFIA t+cnjbyGdB9jA== Received: from localhost (mdns.lwn.net [45.79.72.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id AFB0541061; Fri, 21 Mar 2025 13:46:52 +0000 (UTC) From: Jonathan Corbet To: Changyuan Lyu Cc: akpm@linux-foundation.org, anthony.yznaga@oracle.com, arnd@arndb.de, ashish.kalra@amd.com, benh@kernel.crashing.org, bp@alien8.de, catalin.marinas@arm.com, changyuanl@google.com, dave.hansen@linux.intel.com, devicetree@vger.kernel.org, dwmw2@infradead.org, ebiederm@xmission.com, graf@amazon.com, hpa@zytor.com, jgowans@amazon.com, kexec@lists.infradead.org, krzk@kernel.org, linux-arm-kernel@lists.infradead.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org, luto@kernel.org, mark.rutland@arm.com, mingo@redhat.com, pasha.tatashin@soleen.com, pbonzini@redhat.com, peterz@infradead.org, ptyadav@amazon.de, robh+dt@kernel.org, robh@kernel.org, rostedt@goodmis.org, rppt@kernel.org, saravanak@google.com, skinsburskii@linux.microsoft.com, tglx@linutronix.de, thomas.lendacky@amd.com, will@kernel.org, x86@kernel.org Subject: Re: [PATCH v5 16/16] Documentation: add documentation for KHO In-Reply-To: <20250321063356.381646-1-changyuanl@google.com> References: <87wmcj69sg.fsf@trenco.lwn.net> <20250321063356.381646-1-changyuanl@google.com> Date: Fri, 21 Mar 2025 07:46:51 -0600 Message-ID: <87frj6o5ro.fsf@trenco.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Rspam-User: X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: DECA040010 X-Stat-Signature: mipb9mdhntgtbcy7uuyeb9ks4kpe1eib X-HE-Tag: 1742564814-280417 X-HE-Meta: U2FsdGVkX1/z3uXkwvaDi9o6alMhNESDKRoNX0YKMiiJxAyN//Zki1B+mRRayw8lsPq4xlyFESjJzQz5QOY/L6dqnzX27MrVk4isXYuycG5N6y0Vc4E2eS7dN10Mvi6e01tt70q16eX+Yso/IpGKfI/iTnRtXH1EJpCIlm0DAZjITuNfttmEgbykriq3r4YzjacHIs04/XaKqXwkjFuW1QaxwkiXLEJyry3/08md1N0mTW3i3/wVKCAcgEXXeiNueT6GVKEkrq0NSt1hZb0RB5+jgolZOrnJtuZZTA1eHq7mWX3U33j945e9CFNx6m64eZDVnOy2/+jjCIH8NpFziAaxnI/PCsLpEmH9BGAkqSSYU8UbL3IRtbilQokB1n2rbAeGWDajPW3hx+OqkMRdmI0VckN1gtcluPF3KbYSDsYykDJnKRlTsAWFx5Jd6noSXtAbpExo3Il0t0vAF+ULNvEtJeg0Z3ArXdLVyOHQD6i5Jsj+ByXjmcTWfaVlwcY2ql+4Gx0IM/hMwlfZL/rANdmBMnbhtDuv53XXb3GBNdwSn8Y0AeZnx4ZHkf2BdFeuZJlA2SZLP83+L1kqM/E5q1pu4PHP/CWEYDGZM3bBkdhHeNkqzNaPRpTcsJOb5Epbh/c+IaTp2Qq5m3LAf0X3Bhlk6mvonf9fZPStJYxpIYp4mMzHbBlxP3PDiCWj+3j7HbzDN2AhQoEW/HNm5soYwXj2kAbkTnd4Jqug8YchVhXLvHonXmb+AuRc7d3LFW3rLA9sLxKMzjp9MKTYLRMjdAYYatzW0DFeyGtMszXgAVek8mFCNkgnYvvpYS4zb3aMdFcN6Bnk97a26A9WDSF8vzYZSjmlNvhQPvkwXXPzad89lERchnSfQap3xaryrjrwB/0ErNoLNVlUFjvyLjoR5sesWyxFjmMcCdvVuojCvWMdukrMQIM+Q4N6YBAg08ohgRzhL/LComjOh92NBEV M+uiZT5V RQ+D3TQFOfByEUMB6o/9+nwt7dBleKcVx0MVAXbTOseFofCZqhE/zQ7c+BPtTzOIoA7D/AChsSwgJ0M6g42G9VN+X2gdsx5Ni9yMWZGy8AQ3/NWzdpyIrfqSMWRtFHpgG9dAVTtBqpYtkoBawJS5/gJfAQcEV/XFYLDuAMZDgiSnkWIcYHxgz8yO1cCT9TjvUzG64W1W0psIIXuL9/+8GMJVvjudBhTmUCGJ5E2fMwundTmsv2JObdnfrzUjkq6IrarvrFsCR0h5MBXX0/loquIPcSIhoDBA6rAwBrk9IKjQ5QcenRKqLv8PoN9NWxGgiO791/MizzFEPkpqq+GBXXQaDrHI2xdPM5mroma/ORxGQzUY= 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: Changyuan Lyu writes: > However, I think concepts.rst and fdt.rst are not not end-user oriented, > but for kernel developers of other subsystems to use KHO API (I also plan > to include the kernel-doc generated from kernel/kexec_handover.c and > include/linux/kexec_handover.h here in the next version). > Should Documentation/core-api be a better choice? Yes, I think it would be. Thanks, jon