• Randy Dunlap's avatar
    fs: eventpoll: fix comments & kernel-doc notation · a6c67fee
    Randy Dunlap authored
    Use the documented kernel-doc format for function Return: descriptions.
    Begin constant values in kernel-doc comments with '%'.
    
    Remove kernel-doc "/**" from 2 functions that are not documented with
    kernel-doc notation.
    
    Fix typos, punctuation, & grammar.
    
    Also fix a few kernel-doc warnings:
    
    ../fs/eventpoll.c:1883: warning: Function parameter or member 'ep' not described in 'ep_loop_check_proc'
    ../fs/eventpoll.c:1883: warning: Excess function parameter 'priv' description in 'ep_loop_check_proc'
    ../fs/eventpoll.c:1932: warning: Function parameter or member 'ep' not described in 'ep_loop_check'
    ../fs/eventpoll.c:1932: warning: Excess function parameter 'from' description in 'ep_loop_check'
    Signed-off-by: default avatarRandy Dunlap <rdunlap@infradead.org>
    Cc: Andrew Morton <akpm@linux-foundation.org>
    Cc: Alexander Viro <viro@zeniv.linux.org.uk>
    Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
    a6c67fee
eventpoll.c 63.8 KB