The patch titled Subject: Documentation/vm: include kdocs from highmem*.h into highmem.rst has been added to the -mm tree. Its filename is documentation-vm-include-kdocs-from-highmemh-into-highmemrst.patch This patch should soon appear at https://ozlabs.org/~akpm/mmots/broken-out/documentation-vm-include-kdocs-from-highmemh-into-highmemrst.patch and later at https://ozlabs.org/~akpm/mmotm/broken-out/documentation-vm-include-kdocs-from-highmemh-into-highmemrst.patch Before you just go and hit "reply", please: a) Consider who else should be cc'ed b) Prefer to cc a suitable mailing list as well c) Ideally: find the original patch on the mailing list and do a reply-to-all to that, adding suitable additional cc's *** Remember to use Documentation/process/submit-checklist.rst when testing your code *** The -mm tree is included into linux-next and is updated there every 3-4 working days ------------------------------------------------------ From: "Fabio M. De Francesco" <fmdefrancesco@xxxxxxxxx> Subject: Documentation/vm: include kdocs from highmem*.h into highmem.rst kernel-docs that are in include/linux/highmem.h and in include/linux/highmem-internal.h should be included in highmem.rst. Use kdocs directives to include the above-mentioned comments into highmem.rst. Link: https://lkml.kernel.org/r/20220421180200.16901-3-fmdefrancesco@xxxxxxxxx Signed-off-by: Fabio M. De Francesco <fmdefrancesco@xxxxxxxxx> Cc: Jonathan Corbet <corbet@xxxxxxx> Cc: Thomas Gleixner <tglx@xxxxxxxxxxxxx> Cc: Ira Weiny <ira.weiny@xxxxxxxxx> Cc: Matthew Wilcox <willy@xxxxxxxxxxxxx> Cc: Peter Zijlstra <peterz@xxxxxxxxxxxxx> Cc: Mike Rapoport <rppt@xxxxxxxxxxxxx> Signed-off-by: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx> --- Documentation/vm/highmem.rst | 7 +++++++ 1 file changed, 7 insertions(+) --- a/Documentation/vm/highmem.rst~documentation-vm-include-kdocs-from-highmemh-into-highmemrst +++ a/Documentation/vm/highmem.rst @@ -145,3 +145,10 @@ The general recommendation is that you d machine - although more might work for you and your workload, you're pretty much on your own - don't expect kernel developers to really care much if things come apart. + + +Functions +========= + +.. kernel-doc:: include/linux/highmem.h +.. kernel-doc:: include/linux/highmem-internal.h _ Patches currently in -mm which might be from fmdefrancesco@xxxxxxxxx are mm-highmem-fix-kernel-doc-warnings-in-highmemh.patch documentation-vm-include-kdocs-from-highmemh-into-highmemrst.patch documentation-vm-remove-using-kmap-atomic-from-highmemrst.patch documentation-vm-rework-temporary-virtual-mappings.patch