]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
RDMA/restrack: fix kernel-doc indicator
authorRandy Dunlap <rdunlap@infradead.org>
Tue, 24 Feb 2026 00:31:49 +0000 (16:31 -0800)
committerLeon Romanovsky <leon@kernel.org>
Tue, 24 Feb 2026 10:39:21 +0000 (05:39 -0500)
Use "/**" to begin kernel-doc comments. This eliminates these
kernel-doc warnings:

Warning: include/rdma/restrack.h:123 struct member 'kref' not described in
 'rdma_restrack_entry'
Warning: include/rdma/restrack.h:123 struct member 'comp' not described in
 'rdma_restrack_entry'

(not adding missing return value kernel-doc descriptions)

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://patch.msgid.link/20260224003149.3175815-1-rdunlap@infradead.org
Signed-off-by: Leon Romanovsky <leon@kernel.org>
include/rdma/restrack.h

index 8a9bcf77dacebeb270192bde5c1ae0cdef133257..451f99e3717d80819124d29d8bca840f007888b5 100644 (file)
@@ -87,11 +87,11 @@ struct rdma_restrack_entry {
         * query stage.
         */
        u8                      no_track : 1;
-       /*
+       /**
         * @kref: Protect destroy of the resource
         */
        struct kref             kref;
-       /*
+       /**
         * @comp: Signal that all consumers of resource are completed their work
         */
        struct completion       comp;