infiniband kernel-doc fixes & driver-api/ chapter
Get series with b4
b4 am [email protected]Versions newest first
- v1 Latest12 patches 12 repliesIn review
Patches in v1 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/12 | infiniband: fix ulp/iser/iscsi_iser.[hc] kernel-doc notationdrivers/ drivers/ | +5 | 0 replies | |
| 2/12 | infiniband: fix core/ipwm_util.h kernel-doc warningsdrivers/ | +4 | 0 replies | |
| 3/12 | infiniband: fix ulp/iser/iscsi_iser.h kernel-doc warningsdrivers/ | +11 | 0 replies | |
| 4/12 | infiniband: fix ulp/opa_vnic/opa_vnic_internal.h kernel-doc notationdrivers/ | +4 | 0 replies | |
| 5/12 | infiniband: fix ulp/opa_vnic/opa_vnic_encap.h kernel-doc notationdrivers/ | +41 | 4 replies | |
| 6/12 | infiniband: fix ulp/srpt/ib_srpt.h kernel-doc notationdrivers/ | +2 | 2 replies | |
| 7/12 | infiniband: fix core/verbs.c kernel-doc notationdrivers/ | +2 | 0 replies | |
| 8/12 | infiniband: fix ulp/iser/iser_verbs.c kernel-doc notationdrivers/ | +38 | 0 replies | |
| 9/12 | infiniband: fix ulp/iser/iser_initiator.c kernel-doc warningsdrivers/ | +5 | 0 replies | |
| 10/12 | infiniband: fix core/ kernel-doc notationdrivers/ drivers/ | +12 | 0 replies | |
| 11/12 | infiniband: fix sw/rdmavt/ kernel-doc notationdrivers/ drivers/ drivers/ +1 more | +17 | 0 replies | |
| 12/12 | infiniband: add a Documentation driver-api chapter for InfinibandDocumentation/ Documentation/ | +128 | 2 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.
Cover letter [PATCH 00/12] infiniband kernel-doc fixes & driver-api/ chapter
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(-)