Documenting the source?

[Daniel . Egger]

Hi developers,

 Having no real documentation of the sourcecode is really a burden
 when searching for bugs. Do you agree that having a documentation
 would be fine? I'd like to introduce a in-source-documentation 
 which an extractor program could use to make a TeX or HTML file of
 it.

 Using javadoc like comments we'd always have a specification of a 
 function handy without having to guess the sense.

-- 

Servus,
       Daniel