On 07/30/14 06:57, Karoly Kemeny wrote:

Net_device is a vast and important structure, but it has no kernel-doc
compliant documentation. This patch extracts the comments from the structure
to clean it up, and let the scripts extract documentation from it. I know that
the patch is big, but it's just reordering of comments into the appropriate 
form, and adding a few more, for the missing members.

v2: 
Additional documentation added for some members (gflags,neigh_priv_len,
queues_kset, uc_promisc, promiscuity, allmulti, _rx, _tx, watchdog_timer,
rtnl_link_state, tstats, gso_max_size, gso_max_segs, num_tc, pm_qos_req).
Cleaned up trailing whitespaces and blank lines.
Fixed the beginning to indicate kernel-doc notation.

v3:
Fixed typos.
Added documentation for npinfo and stats

v4:
Fixed further typos pointed out by Nikolay

Signed-off-by: Karoly Kemeny <redacted>

Acked-by: Randy Dunlap <redacted>

Thank you.

---
 include/linux/netdevice.h | 381 ++++++++++++++++++++++++++++++----------------
 1 file changed, 250 insertions(+), 131 deletions(-)

-- 
~Randy