]> git.karo-electronics.de Git - karo-tx-linux.git/commit
kernel-doc: improve "no structured comments found" error
authorJohannes Berg <johannes.berg@intel.com>
Tue, 5 Nov 2013 05:57:33 +0000 (16:57 +1100)
committerStephen Rothwell <sfr@canb.auug.org.au>
Tue, 5 Nov 2013 05:57:33 +0000 (16:57 +1100)
commitf20ed64029793acdddec87edffdc7908b43a0e70
tree0a2f98950e032d345e7114108d024127448130a1
parent82e616c02c65918105e74e49a879d2a6b39cc1d2
kernel-doc: improve "no structured comments found" error

When using '!Ffile function' in a docbook template, and the function no
longer exists, you get a "no structured comments found" error from the
kernel-doc processing script.  It's useful to know which functions it was
looking for, so print them out in this case.  Also do the same for '!Pfile
doc-section'

The same error also happens when using '!Efile' when some exported
functions aren't documented (in the same file.) There's a very large
number of such functions though, so don't print the message in this case
-- right now it would give ~850 messages.

Signed-off-by: Johannes Berg <johannes.berg@intel.com>
Cc: Rob Landley <rob@landley.net>
Cc: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
scripts/docproc.c
scripts/kernel-doc