tree aa7da70e2e13d085b2c0b7999eef8aff2aa89ab7
parent ddf5eabd20c6cc2814fa2c00a1a033776fbc3e44
author Yacine Belkadi <yacine.belkadi.1@gmail.com> 1354048039 +0100
committer Michal Marek <mmarek@suse.cz> 1354790968 +0100

scripts/kernel-doc: check that non-void fcts describe their return value

If a function has a return value, but its kernel-doc comment doesn't contain a
"Return" section, then emit the following warning:

   Warning(file.h:129): No description found for return value of 'fct'

Note: This check emits a lot of warnings at the moment, because many functions
don't have a 'Return' doc section. So until the number of warnings goes
sufficiently down, the check is only performed in verbose mode.

Signed-off-by: Yacine Belkadi <yacine.belkadi.1@gmail.com>
Acked-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Michal Marek <mmarek@suse.cz>