]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/commit - scripts/kernel-doc
kernel-doc: Fix parsing of DECLARE_BITMAP in struct
authorConchúr Navid <conchur@web.de>
Sun, 8 Nov 2015 09:52:00 +0000 (10:52 +0100)
committerJonathan Corbet <corbet@lwn.net>
Fri, 20 Nov 2015 23:14:10 +0000 (16:14 -0700)
commitb22b5a9ef5309287b86bac9eb47f17a12671b770
tree1ae7f039eff250d7b83b458a96c6d8d840ec73df
parent4468e21eed2dd7ee8dc91d94dbd2ccb0d291fb07
kernel-doc: Fix parsing of DECLARE_BITMAP in struct

Some documented structures in the kernel use DECLARE_BITMAP to create
arrays of unsigned longs to store information using the bitmap functions.
These have to be replaced with a parsable version for kernel-doc.

For example a simple input like

    /**
     * struct something - some test
     * @members: active members
     */
    struct something {
     DECLARE_BITMAP(members, MAX_MEMBERS);
    };

resulted in parsing warnings like

    warning: No description found for parameter 'MAX_MEMBERS)'
    warning: Excess struct/union/enum/typedef member 'members' description in 'something'

Signed-off-by: Conchúr Navid <conchur@web.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/kernel-doc