This patch series cleans up lots of kernel-doc in drivers/infiniband/ and then adds an infiniband.rst file. It also changes a few instances of non-exported functions from kernel-doc notation back to non-kernel-doc comments. There are still a few kernel-doc and Sphinx warnings that I don't know how to resolve: ../drivers/infiniband/ulp/iser/iscsi_iser.h:401: warning: Function parameter or member 'all_list' not described in 'iser_fr_desc' ../drivers/infiniband/ulp/iser/iscsi_iser.h:415: warning: Function parameter or member 'all_list' not described in 'iser_fr_pool' ../drivers/infiniband/core/verbs.c:2510: WARNING: Unexpected indentation. ../drivers/infiniband/core/verbs.c:2512: WARNING: Block quote ends without a blank line; unexpected unindent. ../drivers/infiniband/core/verbs.c:2544: WARNING: Unexpected indentation. I have not added any Fixes: tags to these patches because I don't think that they need to be applied to any stable releases... Documentation/driver-api/index.rst | 1 Documentation/driver-api/infiniband.rst | 127 ++++++++++ drivers/infiniband/core/device.c | 23 - drivers/infiniband/core/iwpm_util.h | 5 drivers/infiniband/core/sa_query.c | 2 drivers/infiniband/core/verbs.c | 2 drivers/infiniband/sw/rdmavt/ah.c | 1 drivers/infiniband/sw/rdmavt/cq.c | 2 drivers/infiniband/sw/rdmavt/qp.c | 30 +- drivers/infiniband/sw/rdmavt/vt.c | 3 drivers/infiniband/ulp/iser/iscsi_iser.c | 2 drivers/infiniband/ulp/iser/iscsi_iser.h | 26 +- drivers/infiniband/ulp/iser/iser_initiator.c | 5 drivers/infiniband/ulp/iser/iser_verbs.c | 60 ++-- drivers/infiniband/ulp/opa_vnic/opa_vnic_encap.h | 42 +++ drivers/infiniband/ulp/opa_vnic/opa_vnic_internal.h | 8 drivers/infiniband/ulp/srpt/ib_srpt.h | 7 17 files changed, 269 insertions(+), 77 deletions(-)
