[Corelinux-develop] Comments and documentation

[Frank V. C. <fr...@co...>]

Christophe introduced a new form of documentation for code (headers and
modules).

A couple of issues with this

1. It is not consistent with the majority of the code and makes
readability a problem.
2. By including all the source code and all the headers, documentation
is growing and is redundant.

Thoughts?