* Davi Arnaut <Davi.Arnaut@stripped> [10/04/07 15:47]:
> I would like to suggest that it is made clear that documentation in
> a header file does not exempt documentation in source files. IMHO,
> in the headers (function prototype) we should document the function
> "interface" -- that is, everything that is relevant to a user of the
> function (eg, longer description, parameters, etc), and in the
> source file (function definition), document implementation details
> (eg, shorter description and the "guts" of the function, etc).