From owner-freebsd-doc Wed Jun 28 17:24:12 2000 Delivered-To: freebsd-doc@freebsd.org Received: from rover.village.org (rover.village.org [204.144.255.49]) by hub.freebsd.org (Postfix) with ESMTP id 7783D37BA69; Wed, 28 Jun 2000 17:24:07 -0700 (PDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (harmony.village.org [10.0.0.6]) by rover.village.org (8.9.3/8.9.3) with ESMTP id SAA82400; Wed, 28 Jun 2000 18:24:05 -0600 (MDT) (envelope-from imp@harmony.village.org) Received: from harmony.village.org (localhost.village.org [127.0.0.1]) by harmony.village.org (8.9.3/8.8.3) with ESMTP id SAA59981; Wed, 28 Jun 2000 18:24:01 -0600 (MDT) Message-Id: <200006290024.SAA59981@harmony.village.org> To: Nik Clayton Subject: Re: XML driver config file to replace LINT Cc: "Thomas M. Sommers" , doc@FreeBSD.ORG, current@FreeBSD.ORG In-reply-to: Your message of "Wed, 28 Jun 2000 17:34:58 BST." <20000628173457.C51610@catkin.nothing-going-on.org> References: <20000628173457.C51610@catkin.nothing-going-on.org> <200006271619.BAA25205@mail.geocities.co.jp> <20000625195803.G470@kilt.nothing-going-on.org> <20000626115008.B462@catkin.nothing-going-on.org> <200006280714.BAA03596@harmony.village.org> <395A1950.50ECD8D5@mail.ptd.net> Date: Wed, 28 Jun 2000 18:24:01 -0600 From: Warner Losh Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org In message <20000628173457.C51610@catkin.nothing-going-on.org> 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 majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message