Patchwork [3/7] net: delete excess kernel-doc notation

login
register
mail settings
Submitter Randy Dunlap
Date Oct. 30, 2008, 5:34 a.m.
Message ID <20081029223458.d5295690.randy.dunlap@oracle.com>
Download mbox | patch
Permalink /patch/6437/
State Accepted
Delegated to: David Miller
Headers show

Comments

Randy Dunlap - Oct. 30, 2008, 5:34 a.m.
From: Randy Dunlap <randy.dunlap@oracle.com>

Remove excess kernel-doc function parameters from networking header
& driver files:

Warning(include/net/sock.h:946): Excess function parameter or struct member 'sk' description in 'sk_filter_release'
Warning(include/linux/netdevice.h:1545): Excess function parameter or struct member 'cpu' description in 'netif_tx_lock'
Warning(drivers/net/wan/z85230.c:712): Excess function parameter or struct member 'regs' description in 'z8530_interrupt'

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
---
 drivers/net/wan/z85230.c  |    1 -
 include/linux/netdevice.h |    1 -
 include/net/sock.h        |    1 -
 3 files changed, 3 deletions(-)

--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
David Miller - Oct. 31, 2008, 6:54 a.m.
From: Randy Dunlap <randy.dunlap@oracle.com>
Date: Wed, 29 Oct 2008 22:34:58 -0700

> From: Randy Dunlap <randy.dunlap@oracle.com>
> 
> Remove excess kernel-doc function parameters from networking header
> & driver files:
> 
> Warning(include/net/sock.h:946): Excess function parameter or struct member 'sk' description in 'sk_filter_release'
> Warning(include/linux/netdevice.h:1545): Excess function parameter or struct member 'cpu' description in 'netif_tx_lock'
> Warning(drivers/net/wan/z85230.c:712): Excess function parameter or struct member 'regs' description in 'z8530_interrupt'
> 
> Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>

Applied, thanks Randy.
--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Patch

--- lin2628-rc2.orig/include/linux/netdevice.h
+++ lin2628-rc2/include/linux/netdevice.h
@@ -1537,7 +1537,6 @@  static inline void __netif_tx_unlock_bh(
 /**
  *	netif_tx_lock - grab network device transmit lock
  *	@dev: network device
- *	@cpu: cpu number of lock owner
  *
  * Get network device transmit lock
  */
--- lin2628-rc2.orig/include/net/sock.h
+++ lin2628-rc2/include/net/sock.h
@@ -936,7 +936,6 @@  extern void sock_init_data(struct socket
 
 /**
  *	sk_filter_release: Release a socket filter
- *	@sk: socket
  *	@fp: filter to remove
  *
  *	Remove a filter from a socket and release its resources.
--- lin2628-rc2.orig/drivers/net/wan/z85230.c
+++ lin2628-rc2/drivers/net/wan/z85230.c
@@ -695,7 +695,6 @@  EXPORT_SYMBOL(z8530_nop);
  *	z8530_interrupt - Handle an interrupt from a Z8530
  *	@irq: 	Interrupt number
  *	@dev_id: The Z8530 device that is interrupting.
- *	@regs: unused
  *
  *	A Z85[2]30 device has stuck its hand in the air for attention.
  *	We scan both the channels on the chip for events and then call