There are some nested structs on this header, with aren't properly document them. This should solve some warnings after the addition of a patche at kernel-doc adding support for nested structs/unions.
Unified · Split
| @@ -94,15 +94,20 @@ struct dvb_demux_filter { · 93 unmodified lines | |||
| 94 | /** | 94 | /** |
| 95 | * struct dvb_demux_feed - describes a DVB field | 95 | * struct dvb_demux_feed - describes a DVB field |
| 96 | * | 96 | * |
| 97 | * @feed: a digital TV feed. It can either be a TS or a section feed: | 97 | * @feed: a union describing a digital TV feed. |
| 98 | * if the feed is TS, it contains &struct dvb_ts_feed @ts; | 98 | * Depending on the feed type, it can be either |
| 99 | * if the feed is section, it contains | 99 | * @feed.ts or @feed.sec. |
| 100 | * &struct dmx_section_feed @sec. | 100 | * @feed.ts: a &struct dmx_ts_feed pointer. |
| 101 | * @cb: digital TV callbacks. depending on the feed type, it can be: | 101 | * For TS feed only. |
| 102 | * if the feed is TS, it contains a dmx_ts_cb() @ts callback; | 102 | * @feed.sec: a &struct dmx_section_feed pointer. |
| 103 | * if the feed is section, it contains a dmx_section_cb() @sec | 103 | * For section feed only. |
| 104 | * callback. | 104 | * @cb: a union describing digital TV callbacks. |
| 105 | * | 105 | * Depending on the feed type, it can be either |
| 106 | * @cb.ts or @cb.sec. | ||
| 107 | * @cb.ts: a dmx_ts_cb() calback function pointer. | ||
| 108 | * For TS feed only. | ||
| 109 | * @cb.sec: a dmx_section_cb() callback function pointer. | ||
| 110 | * For section feed only. | ||
| 106 | * @demux: pointer to &struct dvb_demux. | 111 | * @demux: pointer to &struct dvb_demux. |
| 107 | * @priv: private data that can optionally be used by a DVB driver. | 112 | * @priv: private data that can optionally be used by a DVB driver. |
| 108 | * @type: type of the filter, as defined by &enum dvb_dmx_filter_type. | 113 | * @type: type of the filter, as defined by &enum dvb_dmx_filter_type. |