In message <[EMAIL PROTECTED]> Nik Clayton writes:
: On Wed, Jun 28, 2000 at 11:27:12AM -0400, Thomas M. Sommers wrote:
: > Warner Losh wrote:
: > >
: > > Any reason that the .c/.h files of the drivers couldn't be used to
: > > generate this information?
: >
: > Or perhaps the other way around.
:
: That's what I'd prefer. Any solution that relys on trying to parse
: "structured comments" like that is a kludge at best. I'd rather get
: all this information in to a usefully structured form now, and then
: process it to produce the various output formats we need.
I think that this will doom the information to always being obsolete.
If the information is in the .h or .c files, then it will be looked at
(and corrected) all the time by the programmers. If not, then it will
rot as badly as LINT has been rotting. It has taken much effort to
keep LINT as non-rotten as it has been kept.
Then again, there are some comments in the kernel that are in good
need of a swift kick to the head as well since they have rotted beyond
all usefulness in the source they are in.
Warner
To Unsubscribe: send mail to [EMAIL PROTECTED]
with "unsubscribe freebsd-current" in the body of the message
