Subject: Re: Doxygen generated documentation
To: Rui Paulo <>
From: Julio M. Merino Vidal <>
List: netbsd-docs
Date: 05/21/2005 14:10:03
On Sat, 2005-05-21 at 11:29 +0000, Rui Paulo wrote:

> > Rui im more than happy to help you mark up code with doxygen comments
> That's something that must be discussed, because not everyone may want to
> add Doxygen comments to the source. Another ideia is to add some target
> to to generate Doxygen documentation.
> Doxygen comments aren't very intrusive, though.

The thing is that we already have documentation for frameworks,
functions and data structures in manual pages; duplicating it inside
source code is not a very good idea, as I see it.

FWIW, the existing manual pages are very good.  Check, for example,
spl(9), mbuf(9), wscons(9), etc.


Julio M. Merino Vidal <>
The NetBSD Project -