Subject: Re: Adding to KNF.
To: Jason R Thorpe <thorpej@wasabisystems.com>
From: Jared D. McNeill <jmcneill@invisible.ca>
List: tech-kern
Date: 06/16/2002 18:22:57
Jason R Thorpe wrote:
> 
> On Sat, Jun 15, 2002 at 03:23:11PM +1000, Darren Reed wrote:
> 
>  > What I'd like to suggest is that in going forward, we adopt some changes
>  > to the KNF that require people to at least put more text in a comment
>  > block prior to the function.
> 
> If we're going to do something like this, then I suggest people take
> a look at doxygen (which can generate manual-type documentation from
> marked up comments in source files).

I'll second that. Things like doxygen and javadoc generated
documentation become incredibly useful resources when available.

Jared