Skip to content

Improve block layer function documentation

Bart Van Assche linux-block 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest8 patches 10 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/8block/partitions/ldm: Convert a kernel-doc header into a non-kernel-doc headerblock/partitions/ldm.c+1 -11 reply
2/8block: Convert blk_invalidate_devt() header into a non-kernel-doc headerblock/genhd.c+2 -21 reply
3/8block: Fix throtl_pending_timer_fn() kernel-doc headerblock/blk-throttle.c+1 -12 replies
4/8block: Fix blk_mq_*_map_queues() kernel-doc headersblock/blk-mq-pci.c block/blk-mq-rdma.c block/blk-mq-virtio.c+5 -51 reply
5/8block: Fix rq_qos_wait() kernel-doc headerblock/blk-rq-qos.c+4 -31 reply
6/8block: Fix bsg_setup_queue() kernel-doc headerblock/bsg-lib.c+1 -01 reply
7/8blk-mq: Fix spelling in a source code commentblock/blk-mq-cpumap.c+2 -21 reply
8/8blk-mq: Document the blk_mq_hw_queue_to_node() argumentsblock/blk-mq-cpumap.c+5 -11 reply

Reviews trailers per patch

All 8 patches have a Reviewed-by or Acked-by.

PatchChaitanya KulkarniKees Cook
1/8R-b
2/8R-b
3/8R-b R-b
4/8R-b
5/8R-b
6/8R-b
7/8R-b
8/8R-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v1 thread

Cover letter [PATCH 0/8] Improve block layer function documentation

Hi Jens,

This is a series with eight patches that address source code comments. Most patches suppress kernel-doc warnings that appear when building with W=1. Please consider these patches.

Thanks,

Bart.

Bart Van Assche (8):
block/partitions/ldm: Convert a kernel-doc header into a
non-kernel-doc header
block: Convert blk_invalidate_devt() header into a non-kernel-doc
header
block: Fix throtl_pending_timer_fn() kernel-doc header
block: Fix blk_mq_*_map_queues() kernel-doc headers
block: Fix rq_qos_wait() kernel-doc header
block: Fix bsg_setup_queue() kernel-doc header
blk-mq: Fix spelling in a source code comment
blk-mq: Document the blk_mq_hw_queue_to_node() arguments

 block/blk-mq-cpumap.c  | 10 +++++++---
 block/blk-mq-pci.c     |  2 +-
 block/blk-mq-rdma.c    |  4 ++--
 block/blk-mq-virtio.c  |  4 ++--
 block/blk-rq-qos.c     |  7 ++++---
 block/blk-throttle.c   |  2 +-
 block/bsg-lib.c        |  1 +
 block/genhd.c          |  4 ++--
 block/partitions/ldm.c |  2 +-
 9 files changed, 21 insertions(+), 15 deletions(-)
Signature · 1 line
2.22.0.rc1