linux-kernel - kernel-doc: handle DECLARE

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <2b1e5b50-ceb7-594f-92fc-4cc7ff12f858@infradead.org>
Date:   Sat, 16 Sep 2017 18:40:28 -0700
From:   Randy Dunlap <rdunlap@...radead.org>
To:     "linux-doc@...r.kernel.org" <linux-doc@...r.kernel.org>,
        LKML <linux-kernel@...r.kernel.org>
Cc:     Linus Walleij <linus.walleij@...aro.org>
Subject: kernel-doc: handle DECLARE_KFIFO() ?

scripts/kernel-doc handles DECLARE_BITMAP() and DECLARE_HASHTABLE().

Recently drivers/gpio/gpiolib.c has been changed to use DECLARE_KFIFO() *and*
that is inside kernel-doc notation, but scripts/kernel-doc doesn't know about
DECLARE_KFIFO(), so it causes these warnings:

../drivers/gpio/gpiolib.c:593: warning: No description found for parameter '16'
../drivers/gpio/gpiolib.c:593: warning: Excess struct/union/enum/typedef member 'events' description in 'lineevent_state'

	DECLARE_KFIFO(events, struct gpioevent_data, 16);

-- 
~Randy