From 3b61bb3fe1e6582673f19cc83f8d81644f2a5092 Mon Sep 17 00:00:00 2001 From: Randy Dunlap Date: Tue, 23 Jun 2026 12:00:04 -0700 Subject: [PATCH 1/9] kernel-doc: xforms: support __SYSFS_FUNCTION_ALTERNATIVE() MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add support for __SYSFS_FUNCTION_ALTERNATIVE() to create a union of its members (as though CONFIG_CFI is unset). Fixes these docs build warnings: WARNING: include/linux/device.h:117 Invalid param: __SYSFS_FUNCTION_ALTERNATIVE( ssize_t (*show)(struct device *dev, struct device_attribute *attr, char *buf) WARNING: include/linux/device.h:117 struct member '__SYSFS_FUNCTION_ALTERNATIVE( ssize_t (*show' not described in 'device_attribute' WARNING: include/linux/device.h:117 Invalid param: __SYSFS_FUNCTION_ALTERNATIVE( ssize_t (*store)(struct device *dev, struct device_attribute *attr, const char *buf, size_t count) WARNING: include/linux/device.h:117 struct member '__SYSFS_FUNCTION_ALTERNATIVE( ssize_t (*store' not described in 'device_attribute' Signed-off-by: Randy Dunlap Reviewed-by: Thomas Weißschuh Signed-off-by: Jonathan Corbet Message-ID: <20260623190006.406571-1-rdunlap@infradead.org> --- tools/lib/python/kdoc/xforms_lists.py | 1 + 1 file changed, 1 insertion(+) diff --git a/tools/lib/python/kdoc/xforms_lists.py b/tools/lib/python/kdoc/xforms_lists.py index aab70e5eaa6f..0734f9f94bf8 100644 --- a/tools/lib/python/kdoc/xforms_lists.py +++ b/tools/lib/python/kdoc/xforms_lists.py @@ -49,6 +49,7 @@ class CTransforms: (CMatch("DEFINE_DMA_UNMAP_ADDR"), r"dma_addr_t \1"), (CMatch("DEFINE_DMA_UNMAP_LEN"), r"__u32 \1"), (CMatch("VIRTIO_DECLARE_FEATURES"), r"union { u64 \1; u64 \1_array[VIRTIO_FEATURES_U64S]; }"), + (CMatch("__SYSFS_FUNCTION_ALTERNATIVE"), r"union { \1+ }"), (CMatch("__attribute__"), ""), # From afb5a55498e121b1382f139512c8a3ea3de68e49 Mon Sep 17 00:00:00 2001 From: "David Hildenbrand (Arm)" Date: Mon, 20 Apr 2026 23:03:16 +0200 Subject: [PATCH 2/9] docs/mm: clarify that we are not looking for LLM generated content Let's make it clear that we are not looking for LLM generated content from contributors not familiar with the details of MM, as it shifts the real work onto reviewers. Signed-off-by: David Hildenbrand (Arm) Acked-by: Dev Jain Acked-by: Michal Hocko Acked-by: Zi Yan Acked-by: Vlastimil Babka (SUSE) Reviewed-by: Lorenzo Stoakes Acked-by: Mike Rapoport (Microsoft) Acked-by: Harry Yoo (Oracle) Acked-by: SeongJae Park Signed-off-by: Jonathan Corbet Message-ID: <20260420-llmdoc-v1-1-47d2091177c4@kernel.org> --- Documentation/mm/index.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/mm/index.rst b/Documentation/mm/index.rst index 7aa2a8886908..13a79f5d092c 100644 --- a/Documentation/mm/index.rst +++ b/Documentation/mm/index.rst @@ -7,6 +7,19 @@ of Linux. If you are looking for advice on simply allocating memory, see the :ref:`memory_allocation`. For controlling and tuning guides, see the :doc:`admin guide <../admin-guide/mm/index>`. +.. note:: + + Unfortunately, parts of this guide are still incomplete or missing. + While we appreciate contributions, documentation in this area is hard + to get right and requires a lot of attention to detail. New contributors + should reach out to the relevant maintainers early. + + This guide is expected to reflect reality, which requires contributors + to have a detailed understanding. Documentation generated with LLMs + by contributors unfamiliar with these details shifts the real work onto + reviewers, which is why such contributions will be rejected without + further comment. + .. toctree:: :maxdepth: 1 From de5c46373eb8148aa92c024cf30d26a6d495e278 Mon Sep 17 00:00:00 2001 From: Doehyun Baek Date: Mon, 22 Jun 2026 18:18:21 +0000 Subject: [PATCH 3/9] Docs/driver-api/uio-howto: document mmap_prepare callback The UIO howto still documents an mmap callback in struct uio_info. That field was replaced by mmap_prepare, which takes a struct vm_area_desc. A UIO driver following the current howto no longer builds because struct uio_info has no mmap member. Update the documented callback signature and matching text to match the current API. Fixes: 933f05f58ac6 ("uio: replace deprecated mmap hook with mmap_prepare in uio_info") Signed-off-by: Doehyun Baek Reviewed-by: Lorenzo Stoakes Acked-by: Randy Dunlap Signed-off-by: Jonathan Corbet Message-ID: <20260622181821.1195257-1-doehyunbaek@gmail.com> --- Documentation/driver-api/uio-howto.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/driver-api/uio-howto.rst b/Documentation/driver-api/uio-howto.rst index 907ffa3b38f5..c08472dfbcfe 100644 --- a/Documentation/driver-api/uio-howto.rst +++ b/Documentation/driver-api/uio-howto.rst @@ -246,10 +246,10 @@ the members are required, others are optional. hardware interrupt number. The flags given here will be used in the call to :c:func:`request_irq()`. -- ``int (*mmap)(struct uio_info *info, struct vm_area_struct *vma)``: +- ``int (*mmap_prepare)(struct uio_info *info, struct vm_area_desc *desc)``: Optional. If you need a special :c:func:`mmap()` function, you can set it here. If this pointer is not NULL, your - :c:func:`mmap()` will be called instead of the built-in one. + ``mmap_prepare`` will be called instead of the built-in one. - ``int (*open)(struct uio_info *info, struct inode *inode)``: Optional. You might want to have your own :c:func:`open()`, From 8a66c094793ec68cf15260538017b0f661ae400a Mon Sep 17 00:00:00 2001 From: Yudistira Putra Date: Mon, 22 Jun 2026 10:37:35 -0400 Subject: [PATCH 4/9] Documentation: tracing: fix typo in events documentation Fix a typo in the tracing events documentation: "can by built up" should be "can be built up". Signed-off-by: Yudistira Putra Signed-off-by: Jonathan Corbet Message-ID: <20260622143735.71778-1-pyudistira519@gmail.com> --- Documentation/trace/events.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/trace/events.rst b/Documentation/trace/events.rst index 18d112963dec..581f2260614b 100644 --- a/Documentation/trace/events.rst +++ b/Documentation/trace/events.rst @@ -1064,7 +1064,7 @@ correct command type, and a pointer to an event-specific run_command() callback that will be called to actually execute the event-specific command function. -Once that's done, the command string can by built up by successive +Once that's done, the command string can be built up by successive calls to argument-adding functions. To add a single argument, define and initialize a struct dynevent_arg From dd07489fead45f0947aaa4cfb72066594df0fde4 Mon Sep 17 00:00:00 2001 From: Zenghui Yu Date: Sun, 21 Jun 2026 07:40:35 +0800 Subject: [PATCH 5/9] docs: kgdb: Fix path of driver options The correct path of driver options should be /sys/module//parameters/