From owner-freebsd-doc Mon Jun 26 8: 5:39 2000 Delivered-To: freebsd-doc@freebsd.org Received: from sr14.nsw-remote.bigpond.net.au (sr14.nsw-remote.bigpond.net.au [24.192.3.29]) by hub.freebsd.org (Postfix) with ESMTP id E72FE37B97C for ; Mon, 26 Jun 2000 08:05:27 -0700 (PDT) (envelope-from a.reilly@lake.com.au) Received: from areilly.bpc-users.org (CPE-144-132-171-71.nsw.bigpond.net.au [144.132.171.71]) by sr14.nsw-remote.bigpond.net.au (Pro-8.9.3/8.9.3) with SMTP id WAA22221 for ; Mon, 26 Jun 2000 22:32:15 +1000 (EST) Received: (qmail 98387 invoked by uid 1000); 26 Jun 2000 12:32:14 -0000 From: "Andrew Reilly" Date: Mon, 26 Jun 2000 22:32:14 +1000 To: "Daniel C. Sobral" Cc: Jun Kuriyama , doc@FreeBSD.ORG, current@FreeBSD.ORG Subject: Re: XML driver config file to replace LINT Message-ID: <20000626223214.A98107@gurney.reilly.home> References: <20000625195803.G470@kilt.nothing-going-on.org> <7mvgyw4u04.wl@waterblue.imgsrc.co.jp> <3957413B.83D5DEA4@newsguy.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <3957413B.83D5DEA4@newsguy.com>; from dcs@newsguy.com on Mon, Jun 26, 2000 at 08:40:44PM +0900 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, Jun 26, 2000 at 08:40:44PM +0900, Daniel C. Sobral wrote: > Jun Kuriyama wrote: > > > And we should keep that master text simple to ease modification by > > hackers. If we force to write complex markups, hackers will *forget* > > to update that master text. :-) > > I'm not sure I would *forget* it, but I my indulge in "forget"ing it. > :-) How about a couple of fields in the driver source itself, along the lines of http://publicsource.apple.com/projects/headerdoc/ If it's part of the source that the developers are working with, then it's more likely to stay "right". Of course we all know that comment bugs exist. -- Andrew To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message