Re: [PATCH 06/12] infiniband: fix ulp/srpt/ib_srpt.h kernel-doc notation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 10/23/19 1:30 PM, Bart Van Assche wrote:
> On 2019-10-09 20:52, rd.dunlab@xxxxxxxxx wrote:
>> --- linux-next-20191009.orig/drivers/infiniband/ulp/srpt/ib_srpt.h
>> +++ linux-next-20191009/drivers/infiniband/ulp/srpt/ib_srpt.h
>> @@ -387,12 +387,9 @@ struct srpt_port_id {
>>   * @sm_lid:    cached value of the port's sm_lid.
>>   * @lid:       cached value of the port's lid.
>>   * @gid:       cached value of the port's gid.
>> - * @port_acl_lock spinlock for port_acl_list:
>>   * @work:      work structure for refreshing the aforementioned cached values.
>> - * @port_guid_tpg: TPG associated with target port GUID.
>> - * @port_guid_wwn: WWN associated with target port GUID.
>> - * @port_gid_tpg:  TPG associated with target port GID.
>> - * @port_gid_wwn:  WWN associated with target port GID.
>> + * @port_guid_id: target port GUID
>> + * @port_gid_id: target port GID
>>   * @port_attrib:   Port attributes that can be accessed through configfs.
>>   * @refcount:	   Number of objects associated with this port.
>>   * @freed_channels: Completion that will be signaled once @refcount becomes 0.
> 
> This is sufficient to silence the warnings reported by the kernel-doc
> tool but I don't think that the new descriptions make really clear what
> these structure members represent. Do you want to address this or do you
> expect me to post a follow-up patch?

Hi Bart,

Since you know what the descriptions should say, I would appreciate it if you
would post a follow-up patch.

Thanks.
-- 
~Randy




[Index of Archives]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Photo]     [Yosemite News]     [Yosemite Photos]     [Linux Kernel]     [Linux SCSI]     [XFree86]

  Powered by Linux