All of lore.kernel.org
 help / color / mirror / Atom feed
From: Lee Jones <lee.jones@linaro.org>
To: lee.jones@linaro.org
Cc: linux-kernel@vger.kernel.org,
	Mike Marciniszyn <mike.marciniszyn@cornelisnetworks.com>,
	Dennis Dalessandro <dennis.dalessandro@cornelisnetworks.com>,
	Doug Ledford <dledford@redhat.com>,
	Jason Gunthorpe <jgg@ziepe.ca>,
	linux-rdma@vger.kernel.org
Subject: [PATCH 20/20] RDMA/hw/hfi1/rc: Demote incorrectly populated kernel-doc header
Date: Tue, 26 Jan 2021 12:47:32 +0000	[thread overview]
Message-ID: <20210126124732.3320971-21-lee.jones@linaro.org> (raw)
In-Reply-To: <20210126124732.3320971-1-lee.jones@linaro.org>

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

 drivers/infiniband/hw/hfi1/rc.c:1388: warning: Function parameter or member 'packet' not described in 'hfi1_send_rc_ack'
 drivers/infiniband/hw/hfi1/rc.c:1388: warning: Function parameter or member 'is_fecn' not described in 'hfi1_send_rc_ack'
 drivers/infiniband/hw/hfi1/rc.c:1388: warning: Excess function parameter 'qp' description in 'hfi1_send_rc_ack'

Cc: Mike Marciniszyn <mike.marciniszyn@cornelisnetworks.com>
Cc: Dennis Dalessandro <dennis.dalessandro@cornelisnetworks.com>
Cc: Doug Ledford <dledford@redhat.com>
Cc: Jason Gunthorpe <jgg@ziepe.ca>
Cc: linux-rdma@vger.kernel.org
Signed-off-by: Lee Jones <lee.jones@linaro.org>
---
 drivers/infiniband/hw/hfi1/rc.c | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/drivers/infiniband/hw/hfi1/rc.c b/drivers/infiniband/hw/hfi1/rc.c
index 7194236aec8fe..0174b8ee9f00f 100644
--- a/drivers/infiniband/hw/hfi1/rc.c
+++ b/drivers/infiniband/hw/hfi1/rc.c
@@ -1376,9 +1376,8 @@ static const hfi1_make_rc_ack hfi1_make_rc_ack_tbl[2] = {
 	[HFI1_PKT_TYPE_16B] = &hfi1_make_rc_ack_16B
 };
 
-/**
+/*
  * hfi1_send_rc_ack - Construct an ACK packet and send it
- * @qp: a pointer to the QP
  *
  * This is called from hfi1_rc_rcv() and handle_receive_interrupt().
  * Note that RDMA reads and atomics are handled in the
-- 
2.25.1


      parent reply	other threads:[~2021-01-26 12:56 UTC|newest]

Thread overview: 21+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-01-26 12:47 [PATCH 00/20] [Set 3] Rid W=1 warnings from Infiniband Lee Jones
2021-01-26 12:47 ` [PATCH 01/20] RDMA/hw/hfi1/intr: Fix some kernel-doc formatting issues Lee Jones
2021-01-26 12:47 ` [PATCH 02/20] RDMA/sw/rdmavt/srq: Fix a couple of kernel-doc issues Lee Jones
2021-01-26 12:47 ` [PATCH 03/20] RDMA/hw/hfi1/iowait: Demote half-completed kernel-doc and fix formatting issue in another Lee Jones
2021-01-26 12:47 ` [PATCH 04/20] RDMA/hw/hfi1/mad: Demote half-completed kernel-doc header fix another Lee Jones
2021-01-26 12:47 ` [PATCH 05/20] RDMA/hw/hfi1/msix: Add description for 'name' and remove superfluous param 'idx' Lee Jones
2021-01-26 12:47 ` [PATCH 06/20] RDMA/sw/rdmavt/mad: Fix misspelling of 'rvt_process_mad()'s 'in_mad_size' param Lee Jones
2021-01-26 12:47 ` [PATCH 07/20] RDMA/sw/rdmavt/qp: Fix kernel-doc formatting problem Lee Jones
2021-01-26 12:47 ` [PATCH 08/20] RDMA/hw/hfi1/netdev_rx: Fix misdocumentation of the 'start_id' param Lee Jones
2021-01-26 12:47 ` [PATCH 09/20] RDMA/hw/hfi1/pcie: Demote kernel-doc abuses Lee Jones
2021-01-26 12:47 ` [PATCH 10/20] RDMA/hw/hfi1/pio_copy: Provide entry for 'pio_copy()'s 'dd' param Lee Jones
2021-01-26 12:47 ` [PATCH 11/20] RDMA/hw/hfi1/rc: Fix a few function documentation issues Lee Jones
2021-01-26 12:47 ` [PATCH 12/20] RDMA/hw/hfi1/qp: Fix some formatting issues and demote kernel-doc abuse Lee Jones
2021-01-26 12:47 ` [PATCH 13/20] RDMA/hw/hfi1/ruc: Fix a small formatting and description issues Lee Jones
2021-01-26 12:47 ` [PATCH 14/20] RDMA/hw/hfi1/sdma: Fix misnaming of 'sdma_send_txlist()'s 'count_out' param Lee Jones
2021-01-26 12:47 ` [PATCH 15/20] RDMA/hw/hfi1/tid_rdma: Fix a plethora of kernel-doc issues Lee Jones
2021-01-26 12:47 ` [PATCH 16/20] RDMA/hw/hfi1/uc: Fix a little doc-rot Lee Jones
2021-01-26 12:47 ` [PATCH 17/20] RDMA/hw/hfi1/ud: Fix a little more doc-rot Lee Jones
2021-01-26 12:47 ` [PATCH 18/20] RDMA/hw/hfi1/user_exp_rcv: Demote half-documented and kernel-doc abuses Lee Jones
2021-01-26 12:47 ` [PATCH 19/20] RDMA/hw/hfi1/verbs: Demote non-conforming doc header and fix a misspelling Lee Jones
2021-01-26 12:47 ` Lee Jones [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210126124732.3320971-21-lee.jones@linaro.org \
    --to=lee.jones@linaro.org \
    --cc=dennis.dalessandro@cornelisnetworks.com \
    --cc=dledford@redhat.com \
    --cc=jgg@ziepe.ca \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-rdma@vger.kernel.org \
    --cc=mike.marciniszyn@cornelisnetworks.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.