mac80211.h: fix kernel-doc excesses
PATCH 1/1 mac80211.h: fix kernel-doc excesses
From: Randy Dunlap <[email protected]>
Fix mac80211.h kernel-doc: it had some extra parameters that were no longer valid and incorrect format for a return value in 2 places.
Warning(lin2628-rc2//include/net/mac80211.h:1487): Excess function parameter or struct member 'control' description in 'ieee80211_beacon_get' Warning(lin2628-rc2//include/net/mac80211.h:1596): Excess function parameter or struct member 'control' description in 'ieee80211_get_buffered_bc' Warning(lin2628-rc2//include/net/mac80211.h:1632): Excess function parameter or struct member 'rc4key' description in 'ieee80211_get_tkip_key' Warning(lin2628-rc2//include/net/mac80211.h:1735): Excess function parameter or struct member 'return' description in 'ieee80211_start_tx_ba_session' Warning(lin2628-rc2//include/net/mac80211.h:1775): Excess function parameter or struct member 'return' description in 'ieee80211_stop_tx_ba_session'
--- include/net/mac80211.h | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-)
include/net/mac80211.h +5 -6
@@ -1474,7 +1474,6 @@ void ieee80211_tx_status_irqsafe(struct* ieee80211_beacon_get - beacon generation function * @hw: pointer obtained from ieee80211_alloc_hw(). * @vif: &struct ieee80211_vif pointer from &struct ieee80211_if_init_conf. -* @control: will be filled with information needed to send this beacon. * * If the beacon frames are generated by the host system (i.e., not in * hardware/firmware), the low-level driver uses this function to receive
@@ -1575,7 +1574,6 @@ __le16 ieee80211_generic_frame_duration(* ieee80211_get_buffered_bc - accessing buffered broadcast and multicast frames * @hw: pointer as obtained from ieee80211_alloc_hw(). * @vif: &struct ieee80211_vif pointer from &struct ieee80211_if_init_conf. -* @control: will be filled with information needed to send returned frame. * * Function for accessing buffered broadcast and multicast frames. If * hardware/firmware does not implement buffering of broadcast/multicast
@@ -1623,9 +1621,8 @@ unsigned int ieee80211_hdrlen(__le16 fc)* * @keyconf: the parameter passed with the set key * @skb: the skb for which the key is needed -* @rc4key: a buffer to which the key will be written * @type: TBD -* @key: TBD +* @key: a buffer to which the key will be written */ void ieee80211_get_tkip_key(struct ieee80211_key_conf *keyconf, struct sk_buff *skb,
@@ -1726,7 +1723,8 @@ void ieee80211_iterate_active_interfaces* @hw: pointer as obtained from ieee80211_alloc_hw(). * @ra: receiver address of the BA session recipient * @tid: the TID to BA on. -* @return: success if addBA request was sent, failure otherwise +* +* Return: success if addBA request was sent, failure otherwise * * Although mac80211/low level driver/user space application can estimate * the need to start aggregation on a certain RA/TID, the session level
@@ -1764,7 +1762,8 @@ void ieee80211_start_tx_ba_cb_irqsafe(st* @ra: receiver address of the BA session recipient * @tid: the TID to stop BA. * @initiator: if indicates initiator DELBA frame will be sent. -* @return: error if no sta with matching da found, success otherwise +* +* Return: error if no sta with matching da found, success otherwise * * Although mac80211/low level driver/user space application can estimate * the need to stop aggregation on a certain RA/TID, the session level
Signature · 1 line
~Randy
Quoted 8 lines · Randy Dunlap
From: Randy Dunlap <[email protected]>
Fix
mac80211.hkernel-doc: it had some extra parameters that were no longer valid and incorrect format for a return value in 2 places.Warning(lin2628-rc2//include/net/mac80211.h:1487): Excess function parameter or struct member 'control' description in '
ieee80211_beacon_get'
Cool, is that new functionality? Thanks.
johannes
Quoted 11 lines · On Mon, 27 Oct 2008 17:52:06 +0100 Johannes Berg <[email protected]>…
Quoted 8 lines · Randy Dunlap
From: Randy Dunlap <[email protected]>
Fix
mac80211.hkernel-doc: it had some extra parameters that were no longer valid and incorrect format for a return value in 2 places.Warning(lin2628-rc2//include/net/mac80211.h:1487): Excess function parameter or struct member 'control' description in '
ieee80211_beacon_get'Cool, is that new functionality? Thanks.
Yes, but it reports some false positives, so I haven't merged it yet.
Quoted 1 line
Acked-by Johannes Berg <[email protected]>
Signature · 1 line
~Randy