linux_dsm_epyc7002/drivers/net/ethernet/cavium/liquidio
Jesse Brandeburg d0ea5cbdc2 drivers/net/ethernet: clean up mis-targeted comments
As part of the W=1 cleanups for ethernet, a million [*] driver
comments had to be cleaned up to get the W=1 compilation to
succeed. This change finally makes the drivers/net/ethernet tree
compile with W=1 set on the command line. NOTE: The kernel uses
kdoc style (see Documentation/process/kernel-doc.rst) when
documenting code, not doxygen or other styles.

After this patch the x86_64 build has no warnings from W=1, however
scripts/kernel-doc says there are 1545 more warnings in source files, that
I need to develop a script to fix in a followup patch.

The errors fixed here are all kdoc of a few classes, with a few outliers:
In file included from drivers/net/ethernet/qlogic/netxen/netxen_nic_hw.c:10:
drivers/net/ethernet/qlogic/netxen/netxen_nic.h:1193:18: warning: ‘FW_DUMP_LEVELS’ defined but not used [-Wunused-const-variable=]
 1193 | static const u32 FW_DUMP_LEVELS[] = { 0x3, 0x7, 0xf, 0x1f, 0x3f, 0x7f, 0xff };
      |                  ^~~~~~~~~~~~~~
... repeats 4 times...
drivers/net/ethernet/sun/cassini.c:2084:24: warning: suggest braces around empty body in an ‘else’ statement [-Wempty-body]
 2084 |    RX_USED_ADD(page, i);
drivers/net/ethernet/natsemi/ns83820.c: In function ‘phy_intr’:
drivers/net/ethernet/natsemi/ns83820.c:603:6: warning: variable ‘tbisr’ set but not used [-Wunused-but-set-variable]
  603 |  u32 tbisr, tanar, tanlpar;
      |      ^~~~~
drivers/net/ethernet/natsemi/ns83820.c: In function ‘ns83820_get_link_ksettings’:
drivers/net/ethernet/natsemi/ns83820.c:1207:11: warning: variable ‘tanar’ set but not used [-Wunused-but-set-variable]
 1207 |  u32 cfg, tanar, tbicr;
      |           ^~~~~
drivers/net/ethernet/packetengines/yellowfin.c:1063:18: warning: variable ‘yf_size’ set but not used [-Wunused-but-set-variable]
 1063 |   int data_size, yf_size;
      |                  ^~~~~~~

Normal kdoc fixes:
warning: Function parameter or member 'x' not described in 'y'
warning: Excess function parameter 'x' description in 'y'
warning: Cannot understand <string> on line <NNN> - I thought it was a doc line

[*] - ok it wasn't quite a million, but it felt like it.

Signed-off-by: Jesse Brandeburg <jesse.brandeburg@intel.com>
Signed-off-by: David S. Miller <davem@davemloft.net>
2020-09-25 16:29:00 -07:00
..
cn23xx_pf_device.c liquidio: Fix wrong return value in cn23xx_get_pf_num() 2020-08-03 15:57:31 -07:00
cn23xx_pf_device.h liquidio: enhanced ethtool --set-channels feature 2018-04-30 09:26:29 -04:00
cn23xx_pf_regs.h
cn23xx_vf_device.c liquidio CN23XX: Remove set but not used variable 'ring_flag' 2018-09-06 15:53:47 -07:00
cn23xx_vf_device.h
cn23xx_vf_regs.h
cn66xx_device.c drivers: Remove explicit invocations of mmiowb() 2019-04-08 12:01:02 +01:00
cn66xx_device.h
cn66xx_regs.h
cn68xx_device.c drivers/net/ethernet: rid ethernet of no-prototype warnings 2020-09-25 16:29:00 -07:00
cn68xx_device.h
cn68xx_regs.h
lio_core.c drivers/net/ethernet: clean up mis-targeted comments 2020-09-25 16:29:00 -07:00
lio_ethtool.c net: liquidio: reject unsupported coalescing params 2020-03-10 16:28:53 -07:00
lio_main.c drivers/net/ethernet: clean up mis-targeted comments 2020-09-25 16:29:00 -07:00
lio_vf_main.c drivers/net/ethernet: clean up mis-targeted comments 2020-09-25 16:29:00 -07:00
lio_vf_rep.c netdev: pass the stuck queue to the timeout handler 2019-12-12 21:38:57 -08:00
lio_vf_rep.h
liquidio_common.h net/liquidio: Delete non-working LIQUIDIO_PACKAGE check 2020-03-03 17:54:54 -08:00
liquidio_image.h
Makefile
octeon_config.h liquidio: remove obsolete functions and data structures 2018-08-29 20:07:42 -07:00
octeon_console.c drivers/net/ethernet: clean up mis-targeted comments 2020-09-25 16:29:00 -07:00
octeon_device.c drivers/net/ethernet: clean up mis-targeted comments 2020-09-25 16:29:00 -07:00
octeon_device.h liquidio: remove unused inline functions 2020-04-25 20:42:57 -07:00
octeon_droq.c drivers/net/ethernet: clean up mis-targeted comments 2020-09-25 16:29:00 -07:00
octeon_droq.h liquidio: Removed droq lock 2018-09-11 23:37:06 -07:00
octeon_iq.h liquidio: Added delayed work for periodically updating the link statistics. 2018-09-03 19:08:07 -07:00
octeon_mailbox.c drivers/net/ethernet: clean up mis-targeted comments 2020-09-25 16:29:00 -07:00
octeon_mailbox.h liquidio: Added ndo_get_vf_stats support 2018-04-20 10:53:46 -04:00
octeon_main.h liquidio: convert tasklets to use new tasklet_setup() API 2020-09-14 13:02:37 -07:00
octeon_mem_ops.c liquidio: Fix -Wmissing-prototypes warnings for liquidio 2020-09-18 14:52:56 -07:00
octeon_mem_ops.h
octeon_network.h liquidio: use list_empty_careful in lio_list_delete_head 2020-06-28 21:46:33 -07:00
octeon_nic.c liquidio: Add spoof checking on a VF MAC address 2018-09-06 15:52:18 -07:00
octeon_nic.h liquidio: change octnic_ctrl_pkt to do synchronous soft commands 2018-08-29 20:07:41 -07:00
request_manager.c liquidio: Replace vmalloc_node + memset with vzalloc_node and use array_size 2020-06-17 15:04:03 -07:00
response_manager.c liquidio: improve soft command handling 2018-08-29 20:07:41 -07:00
response_manager.h liquidio: improve soft command handling 2018-08-29 20:07:41 -07:00