wireless: fix fatal kernel-doc error + warning in mac80211.h

rddunlap · linvjw · commit daf8cf608d57 · 2011-05-24T15:39:32.000-04:00
Fix new kernel-doc Error and Warning in &lt;net/mac80211.h&gt;:

Error(linux-2.6.39-git5/include/net/mac80211.h:550): cannot understand prototype: 'struct ieee80211_sched_scan_ies '
Warning(linux-2.6.39-git5/include/net/mac80211.h:2289): No description found for parameter 'sta'

Signed-off-by: Randy Dunlap &lt;randy.dunlap@oracle.com&gt;
Signed-off-by: John W. Linville &lt;linville@tuxdriver.com&gt;
diff --git a/include/net/mac80211.h b/include/net/mac80211.h
@@ -538,7 +538,7 @@ struct ieee80211_tx_info {
 };
 
 /**
- * ieee80211_sched_scan_ies - scheduled scan IEs
+ * struct ieee80211_sched_scan_ies - scheduled scan IEs
  *
  * This structure is used to pass the appropriate IEs to be used in scheduled
  * scans for all bands.  It contains both the IEs passed from the userspace
@@ -2278,6 +2278,7 @@ static inline int ieee80211_sta_ps_transition_ni(struct ieee80211_sta *sta,
 
 /**
  * ieee80211_sta_set_tim - set the TIM bit for a sleeping station
+ * @sta: &struct ieee80211_sta pointer for the sleeping station
  *
  * If a driver buffers frames for a powersave station instead of passing
  * them back to mac80211 for retransmission, the station needs to be told

Original file line number	Diff line number	Diff line change
`@@ -538,7 +538,7 @@ struct ieee80211_tx_info {`
`538`	`538`	`};`
`539`	`539`
`540`	`540`	`/**`
`541`		`- * ieee80211_sched_scan_ies - scheduled scan IEs`
	`541`	`+ * struct ieee80211_sched_scan_ies - scheduled scan IEs`
`542`	`542`	`*`
`543`	`543`	`* This structure is used to pass the appropriate IEs to be used in scheduled`
`544`	`544`	`* scans for all bands. It contains both the IEs passed from the userspace`
`@@ -2278,6 +2278,7 @@ static inline int ieee80211_sta_ps_transition_ni(struct ieee80211_sta *sta,`
`2278`	`2278`
`2279`	`2279`	`/**`
`2280`	`2280`	`* ieee80211_sta_set_tim - set the TIM bit for a sleeping station`
	`2281`	`+ * @sta: &struct ieee80211_sta pointer for the sleeping station`
`2281`	`2282`	`*`
`2282`	`2283`	`* If a driver buffers frames for a powersave station instead of passing`
`2283`	`2284`	`* them back to mac80211 for retransmission, the station needs to be told`