linux-kernel - Re: [PATCH v5 02/16] IB: fix kernel-doc markups

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20201207194601.GB1773945@nvidia.com>
Date:   Mon, 7 Dec 2020 15:46:01 -0400
From:   Jason Gunthorpe <jgg@...dia.com>
To:     Mauro Carvalho Chehab <mchehab+huawei@...nel.org>
CC:     Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        Jonathan Corbet <corbet@....net>,
        "Gustavo A. R. Silva" <gustavoars@...nel.org>,
        Håkon Bugge <haakon.bugge@...cle.com>,
        Bart Van Assche <bvanassche@....org>,
        Chuck Lever <chuck.lever@...cle.com>,
        "Dennis Dalessandro" <dennis.dalessandro@...nelisnetworks.com>,
        Divya Indi <divya.indi@...cle.com>,
        Doug Ledford <dledford@...hat.com>,
        Gal Pressman <galpress@...zon.com>,
        Leon Romanovsky <leon@...nel.org>,
        Maor Gottlieb <maorg@...lanox.com>,
        Max Gurtovoy <mgurtovoy@...dia.com>,
        Mike Marciniszyn <mike.marciniszyn@...nelisnetworks.com>,
        Moni Shoua <monis@...lanox.com>,
        Parav Pandit <parav@...lanox.com>,
        Sagi Grimberg <sagi@...mberg.me>,
        "Ursula Braun" <ubraun@...ux.ibm.com>,
        Xi Wang <wangxi11@...wei.com>,
        Yamin Friedman <yaminf@...lanox.com>,
        <linux-kernel@...r.kernel.org>, <linux-rdma@...r.kernel.org>,
        <target-devel@...r.kernel.org>
Subject: Re: [PATCH v5 02/16] IB: fix kernel-doc markups

On Tue, Dec 01, 2020 at 01:08:55PM +0100, Mauro Carvalho Chehab wrote:
> Some functions have different names between their prototypes
> and the kernel-doc markup.
> 
> Others need to be fixed, as kernel-doc markups should use this format:
>         identifier - description
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@...nel.org>
> ---
>  drivers/infiniband/core/cm.c                         |  5 +++--
>  drivers/infiniband/core/cq.c                         |  4 ++--
>  drivers/infiniband/core/iwpm_util.h                  |  2 +-
>  drivers/infiniband/core/sa_query.c                   |  3 ++-
>  drivers/infiniband/core/verbs.c                      |  4 ++--
>  drivers/infiniband/sw/rdmavt/ah.c                    |  2 +-
>  drivers/infiniband/sw/rdmavt/mcast.c                 | 12 ++++++------
>  drivers/infiniband/sw/rdmavt/qp.c                    |  8 ++++----
>  drivers/infiniband/ulp/iser/iscsi_iser.c             |  2 +-
>  drivers/infiniband/ulp/opa_vnic/opa_vnic_encap.h     |  2 +-
>  .../infiniband/ulp/opa_vnic/opa_vnic_vema_iface.c    |  2 +-
>  drivers/infiniband/ulp/srpt/ib_srpt.h                |  2 +-
>  include/rdma/ib_verbs.h                              | 11 +++++++++++
>  13 files changed, 36 insertions(+), 23 deletions(-)

I've taken this to the RDMA tree, thanks

Jason