From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 31E16253359 for ; Wed, 18 Mar 2026 16:50:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773852638; cv=none; b=NEhAXKL/YF/XfIS2J5D/NH57GpkIM8MUikjx94+LYpQl9mtNoSNMwTfcs9dVdBOttxEl8kQe8j4NTdLpbrqgMS2pjyj1BjU61trVP/QK8a30iK2jB2LXyNzth7YKGXY2n4Sx1XAhNfK6wAMVDutIVlXhejwM7+cfm5mY8tid9Ow= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773852638; c=relaxed/simple; bh=9OaN0Uw3P7eOowaB2AzTSywGE+7W/23m2yieLmnFUE0=; h=From:To:Cc:Subject:In-Reply-To:References:Date:Message-ID: MIME-Version:Content-Type; b=XEaCY4kEwyjC6bIm8UsQJnhlu4oObfN3UMWnUFkwjCBwjO2cCgM0wLIJzu1qwwQ2WhOB2PUn2HARRUwiIU1UL7fYH39oEsI1IO34hlgaTBlonS9sC3bODIuzbjAoCtTEwy5kjHQKLiK6Mt+j+/puWjJE4CLYGp1pj4U9ZLErOF4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b=GONcFPpo; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=lwn.net header.i=@lwn.net header.b="GONcFPpo" Received: by smtp.kernel.org (Postfix) id CD1C4C2BCB0; Wed, 18 Mar 2026 16:50:37 +0000 (UTC) Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) (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 smtp.kernel.org (Postfix) with ESMTPS id 94BA2C19421; Wed, 18 Mar 2026 16:50:36 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 smtp.kernel.org 94BA2C19421 Authentication-Results: smtp.kernel.org; dmarc=pass (p=none dis=none) header.from=lwn.net Authentication-Results: smtp.kernel.org; spf=pass smtp.mailfrom=lwn.net DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 90EF640423 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1773852635; bh=2M7Isv+5gdy9BAEctVxVjLNklONTC2uyIdTw4SrIalU=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=GONcFPpoYmnGrS3SzGEF3hU7Uc9407nvyxU39NDNlEaKak4fdZYHMAmhoJhtpFZ8N JNEmd0E4olpCIQCPzZGc7MlSQ8G/Hzcp6VUh9M4ArARRPkgnIfWHwSt8IHjdP8bavs 2AIcoHGOk9PJ539nJOAvwyX6MikHdVU5I1MkF3CF0kRIIqqaCGtD+ixo3VxfqXRIFN UOQSNrtc1LMU+j+nTyXp0lfd0RM+HV5LA4aLDqPiRZVNiYIjU6MA1A5AIXrgGTD8AF SllbqNakO8IJ9uuZEkF8Gc2iVkOa0vHQV1evaJk5G0xYbh6YiEfrtv+adFLD6pLass HYiPipiWeKROA== Received: from localhost (c-71-229-227-126.hsd1.co.comcast.net [71.229.227.126]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 90EF640423; Wed, 18 Mar 2026 16:50:35 +0000 (UTC) From: Jonathan Corbet To: Sasha Levin Cc: linux-api@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-kbuild@vger.kernel.org, linux-kselftest@vger.kernel.org, workflows@vger.kernel.org, tools@kernel.org, x86@kernel.org, Thomas Gleixner , "Paul E. McKenney" , Greg Kroah-Hartman , Dmitry Vyukov , Randy Dunlap , Cyril Hrubis , Kees Cook , Jake Edge , David Laight , Askar Safin , Gabriele Paoloni , Mauro Carvalho Chehab , Christian Brauner , Alexander Viro , Andrew Morton , Masahiro Yamada , Shuah Khan , Ingo Molnar , Arnd Bergmann Subject: Re: [PATCH 1/9] kernel/api: introduce kernel API specification framework In-Reply-To: References: <20260313150928.2637368-1-sashal@kernel.org> <20260313150928.2637368-2-sashal@kernel.org> <87h5qe9wig.fsf@trenco.lwn.net> Date: Wed, 18 Mar 2026 10:50:34 -0600 Message-ID: <87o6kl5bfp.fsf@trenco.lwn.net> Precedence: bulk X-Mailing-List: tools@linux.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain Sasha Levin writes: >>> +The framework exports specifications via debugfs that can be used >>> +to generate documentation. Tools for automatic documentation generation >>> +from specifications are planned for future development. >> >>Documentation always comes last :) > > So this is one thing I wanted to run by the doc maintainers: the kapi tool > already has the capability to export these specs in .rst format. Would it be > interesting to have a manual for kenrel APIs in Documentation/? It can be > automatically generated and updated and would always match the kernel code at > that point. I suspect we could certainly find a place for it. Maybe as a subsection of the user-space API manual, at least for the system-call portion of it. Thanks, jon