Fix some kernel-doc warnings for hns
cover Fix some kernel-doc warnings for hns
Fix some kernel-doc warnings for hns.
Wang Hai (6):
hinic: Fix some kernel-doc warnings in hinic_hw_io.c
net: hns: fix 'cdev' kernel-doc warning in hnae_ae_unregister()
net: hns: Fix some kernel-doc warnings in hns_dsaf_xgmac.c
net: hns: Fix some kernel-doc warnings in hns_enet.c
net: hns: Fix a kernel-doc warning in hinic_hw_api_cmd.c
net: hns: Fix a kernel-doc warning in hinic_hw_eqs.c
drivers/net/ethernet/hisilicon/hns/hnae.c | 2 +- drivers/net/ethernet/hisilicon/hns/hns_dsaf_xgmac.c | 3 +-- drivers/net/ethernet/hisilicon/hns/hns_enet.c | 3 +-- drivers/net/ethernet/huawei/hinic/hinic_hw_api_cmd.c | 2 +- drivers/net/ethernet/huawei/hinic/hinic_hw_eqs.c | 2 +- drivers/net/ethernet/huawei/hinic/hinic_hw_io.c | 4 ++-- 6 files changed, 7 insertions(+), 9 deletions(-)
Signature · 1 line
2.17.1
PATCH 1/6 hinic: Fix some kernel-doc warnings in hinic_hw_io.c
Fixes the following W=1 kernel build warning(s):
drivers/net/ethernet/huawei/hinic/hinic_hw_io.c:373: warning: Excess function parameter 'sq_msix_entry' description in 'hinic_io_create_qps' drivers/net/ethernet/huawei/hinic/hinic_hw_io.c:373: warning: Excess function parameter 'rq_msix_entry' description in 'hinic_io_create_qps'
Rename these wrong names.
--- drivers/net/ethernet/huawei/hinic/hinic_hw_io.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
drivers/net/ethernet/huawei/hinic/hinic_hw_io.c +2 -2
@@ -363,8 +363,8 @@ static void destroy_qp(struct hinic_func_to_io *func_to_io,* @func_to_io: func to io channel that holds the IO components * @base_qpn: base qp number * @num_qps: number queue pairs to create -* @sq_msix_entry: msix entries for sq -* @rq_msix_entry: msix entries for rq +* @sq_msix_entries: msix entries for sq +* @rq_msix_entries: msix entries for rq * * Return 0 - Success, negative - Failure **/
Signature · 1 line
2.17.1
PATCH 2/6 net: hns: fix 'cdev' kernel-doc warning in hnae_ae_unregister()
In reply to Wang HaiRename cdev to hdev.
Fixes the following W=1 kernel build warning(s):
drivers/net/ethernet/hisilicon/hns/hnae.c:444: warning: Excess function parameter 'cdev' description in 'hnae_ae_unregister'
--- drivers/net/ethernet/hisilicon/hns/hnae.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/ethernet/hisilicon/hns/hnae.c +1 -1
@@ -438,7 +438,7 @@ EXPORT_SYMBOL(hnae_ae_register);/** * hnae_ae_unregister - unregisters a HNAE AE engine -* @cdev: the device to unregister +* @hdev: the device to unregister */ void hnae_ae_unregister (struct hnae_ae_dev *hdev) {
Signature · 1 line
2.17.1
PATCH 3/6 net: hns: Fix some kernel-doc warnings in hns_dsaf_xgmac.c
In reply to Wang HaiFixes the following W=1 kernel build warning(s):
drivers/net/ethernet/hisilicon/hns/hns_dsaf_xgmac.c:137: warning: Excess function parameter 'drv' description in 'hns_xgmac_enable' drivers/net/ethernet/hisilicon/hns/hns_dsaf_xgmac.c:497: warning: Excess function parameter 'cmd' description in 'hns_xgmac_get_regs'
--- drivers/net/ethernet/hisilicon/hns/hns_dsaf_xgmac.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-)
drivers/net/ethernet/hisilicon/hns/hns_dsaf_xgmac.c +1 -2
@@ -130,7 +130,7 @@ static void hns_xgmac_lf_rf_control_init(struct mac_driver *mac_drv)/** *hns_xgmac_enable - enable xgmac port -*@drv: mac driver +*@mac_drv: mac driver *@mode: mode of mac port */ static void hns_xgmac_enable (void *mac_drv,enum mac_commom_mode mode)
@@ -490,7 +490,6 @@ static void hns_xgmac_get_link_status(void *mac_drv, u32 *link_stat)/** *hns_xgmac_get_regs - dump xgmac regs *@mac_drv: mac driver -*@cmd:ethtool cmd *@data:data for value of regs */ static void hns_xgmac_get_regs (void *mac_drv,void *data)
Signature · 1 line
2.17.1
PATCH 4/6 net: hns: Fix some kernel-doc warnings in hns_enet.c
In reply to Wang HaiFixes the following W=1 kernel build warning(s):
drivers/net/ethernet/hisilicon/hns/hns_enet.c:1841: warning: Excess function parameter 'netdev' description in 'hns_set_multicast_list' drivers/net/ethernet/hisilicon/hns/hns_enet.c:1841: warning: Excess function parameter 'p' description in 'hns_set_multicast_list'
--- drivers/net/ethernet/hisilicon/hns/hns_enet.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-)
drivers/net/ethernet/hisilicon/hns/hns_enet.c +1 -2
@@ -1829,8 +1829,7 @@ static int hns_nic_uc_unsync(struct net_device *netdev,/** * nic_set_multicast_list - set mutl mac address -* @netdev: net device -* @p: mac address +* @ndev: net device * * return void */
Signature · 1 line
2.17.1
PATCH 5/6 net: hns: Fix a kernel-doc warning in hinic_hw_api_cmd.c
In reply to Wang HaiFixes the following W=1 kernel build warning(s):
drivers/net/ethernet/huawei/hinic/hinic_hw_api_cmd.c:382: warning: Excess function parameter 'size' description in 'api_cmd'
--- drivers/net/ethernet/huawei/hinic/hinic_hw_api_cmd.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/ethernet/huawei/hinic/hinic_hw_api_cmd.c +1 -1
@@ -373,7 +373,7 @@ static int wait_for_api_cmd_completion(struct hinic_api_cmd_chain *chain)* @chain: chain for the command * @dest: destination node on the card that will receive the command * @cmd: command data -* @size: the command size +* @cmd_size: the command size * * Return 0 - Success, negative - Failure **/
Signature · 1 line
2.17.1
PATCH 6/6 net: hns: Fix a kernel-doc warning in hinic_hw_eqs.c
In reply to Wang HaiFixes the following W=1 kernel build warning(s):
drivers/net/ethernet/huawei/hinic/hinic_hw_eqs.c:115: warning: Excess function parameter 'hw_handler' description in 'hinic_aeq_register_hw_cb'
--- drivers/net/ethernet/huawei/hinic/hinic_hw_eqs.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/net/ethernet/huawei/hinic/hinic_hw_eqs.c +1 -1
@@ -106,7 +106,7 @@ enum eq_arm_state {* @aeqs: pointer to Async eqs of the chip * @event: aeq event to register callback for it * @handle: private data will be used by the callback -* @hw_handler: callback function +* @hwe_handler: callback function **/ void hinic_aeq_register_hw_cb(struct hinic_aeqs *aeqs, enum hinic_aeq_type event, void *handle,
Signature · 1 line
2.17.1
David Miller
maintainerFrom: Wang Hai <[email protected]>
Date: Thu, 10 Sep 2020 22:56:14 +0800
Quoted 1 line
Fix some kernel-doc warnings for hns.
Series applied to net-next, thanks.