[0/8] Improve block layer function documentation

Message

Bart Van Assche May 31, 2019, midnight UTC

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(-)

Comments

Jens Axboe May 31, 2019, 4:58 p.m. UTC | #1

On 5/30/19 6:00 PM, Bart Van Assche wrote:
> 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, applied.