> The idea is not to produce documentation but to make pre-function
> paragraphs of comments useful for other programmers so they don't
> need to waste time trying to work out what code does or come to the
> wrong conclusion.

Sure sounds like documentation to me.  Just documentation aimed at
maintainers rather than at users.

/~\ The ASCII				der Mouse
\ / Ribbon Campaign
 X  Against HTML	       mouse@rodents.montreal.qc.ca
/ \ Email!	     7D C8 61 52 5D E7 2D 39  4E F1 31 3E E8 B3 27 4B