]> www.infradead.org Git - users/willy/xarray.git/commitdiff
docs: ABI: make the KernelVersion field optional
authorAlison Schofield <alison.schofield@intel.com>
Thu, 26 Jun 2025 02:40:58 +0000 (19:40 -0700)
committerJonathan Corbet <corbet@lwn.net>
Tue, 1 Jul 2025 19:18:04 +0000 (13:18 -0600)
The KernelVersion field has limited practical value. Git history
provides more accurate tracking of when features were introduced
and target kernel versions often change during development and
merge.

Label it optional.

Signed-off-by: Alison Schofield <alison.schofield@intel.com>
Acked-by: Dan Williams <dan.j.williams@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20250626024101.792073-1-alison.schofield@intel.com
Documentation/ABI/README

index ef0e6d11e919c80190286e1f522d9bcb4fd91017..315fffe1f831fd6c4e7c07325473820f3cca4894 100644 (file)
@@ -46,7 +46,9 @@ Every file in these directories will contain the following information:
 
 What:          Short description of the interface
 Date:          Date created
-KernelVersion: Kernel version this feature first showed up in.
+KernelVersion: (Optional) Kernel version this feature first showed up in.
+               Note: git history often provides more accurate version
+               info, so this field may be omitted.
 Contact:       Primary contact for this interface (may be a mailing list)
 Description:   Long description of the interface and how to use it.
 Users:         All users of this interface who wish to be notified when