Re: [Ksummit-discuss] [CORE-TOPIC] Documentation

[Julia Lawall <julia.lawall@lip6.fr>]

> So this leads me to following questions:
> - How can we easily identify missing documentation?
> -- Maybe Julia can come up with some coccinelle magic?
> -- Maybe even mark non-extractable documentation and convert it.
> -- In the document it mentions scripts/basic/doproc.c checks for missing
> documentation, but this file does not exist anymore :/

Interesting idea.  I had not thought of this.  Coccinelle doesn't really
process comments, but one can always use grep.  So the idea would be to
find function definitions that don't have anything that looks like a
comment in the lines above (ie, the lines since the end of the previous
function definition).  One could furthermore rank the results by the
number of non-local calls to the function.  I guess there would be a lot
of reports, and it would be most productive to start with functions that
are commonly used,

julia