| 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
| ||
|
Date: Thu, 26 Aug 2010 11:48:30 -0700 From: Randy Dunlap <rdunlap@...otime.net> To: Johannes Berg <johannes@...solutions.net> Cc: LKML <linux-kernel@...r.kernel.org> Subject: Re: [PATCH] Docbook: allow warning on unused documentation On Thu, 26 Aug 2010 19:43:14 +0200 Johannes Berg wrote: > From: Johannes Berg <johannes.berg@...el.com> > > When you don't use !E or !I but only !F, then > it's very easy to miss including some functions, > structs etc. in documentation. To help finding > which ones were missed, allow printing out the > unused ones as warnings. > > For example, using this on mac80211 yields a > lot of warnings like this: > > Warning: didn't use docs for DOC: mac80211 workqueue > Warning: didn't use docs for ieee80211_max_queues > Warning: didn't use docs for ieee80211_bss_change > Warning: didn't use docs for ieee80211_bss_conf > > when generating the documentation for it. > > Signed-off-by: Johannes Berg <johannes.berg@...el.com> > --- > v2: - fix comment > - use !C instead of !A > > Documentation/kernel-doc-nano-HOWTO.txt | 5 + > scripts/basic/docproc.c | 129 +++++++++++++++++++++++++++++++- > scripts/kernel-doc | 52 ++++++++++++ > 3 files changed, 183 insertions(+), 3 deletions(-) Applied, thanks. --- ~Randy *** Remember to use Documentation/SubmitChecklist when testing your code *** -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@...r.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Powered by blists - more mailing lists