Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

block: drbd: drbd_interval: Demote some kernel-doc abuses and fix another header

Fixes the following W=1 kernel build warning(s):

drivers/block/drbd/drbd_interval.c:11: warning: Function parameter or member 'node' not described in 'interval_end'
drivers/block/drbd/drbd_interval.c:26: warning: Function parameter or member 'root' not described in 'drbd_insert_interval'
drivers/block/drbd/drbd_interval.c:26: warning: Function parameter or member 'this' not described in 'drbd_insert_interval'
drivers/block/drbd/drbd_interval.c:70: warning: Function parameter or member 'root' not described in 'drbd_contains_interval'
drivers/block/drbd/drbd_interval.c:96: warning: Function parameter or member 'root' not described in 'drbd_remove_interval'
drivers/block/drbd/drbd_interval.c:96: warning: Function parameter or member 'this' not described in 'drbd_remove_interval'
drivers/block/drbd/drbd_interval.c:113: warning: Function parameter or member 'root' not described in 'drbd_find_overlap'

Cc: Philipp Reisner <philipp.reisner@linbit.com>
Cc: Lars Ellenberg <lars.ellenberg@linbit.com>
Cc: Jens Axboe <axboe@kernel.dk>
Cc: drbd-dev@lists.linbit.com
Cc: linux-block@vger.kernel.org
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20210312105530.2219008-3-lee.jones@linaro.org
Signed-off-by: Jens Axboe <axboe@kernel.dk>

authored by

Lee Jones and committed by
Jens Axboe
b8b87103 762d6bd2

+5 -3
+5 -3
drivers/block/drbd/drbd_interval.c
··· 3 3 #include <linux/rbtree_augmented.h> 4 4 #include "drbd_interval.h" 5 5 6 - /** 6 + /* 7 7 * interval_end - return end of @node 8 8 */ 9 9 static inline ··· 18 18 RB_DECLARE_CALLBACKS_MAX(static, augment_callbacks, 19 19 struct drbd_interval, rb, sector_t, end, NODE_END); 20 20 21 - /** 21 + /* 22 22 * drbd_insert_interval - insert a new interval into a tree 23 23 */ 24 24 bool ··· 56 56 57 57 /** 58 58 * drbd_contains_interval - check if a tree contains a given interval 59 + * @root: red black tree root 59 60 * @sector: start sector of @interval 60 61 * @interval: may not be a valid pointer 61 62 * ··· 89 88 return false; 90 89 } 91 90 92 - /** 91 + /* 93 92 * drbd_remove_interval - remove an interval from a tree 94 93 */ 95 94 void ··· 100 99 101 100 /** 102 101 * drbd_find_overlap - search for an interval overlapping with [sector, sector + size) 102 + * @root: red black tree root 103 103 * @sector: start sector 104 104 * @size: size, aligned to 512 bytes 105 105 *