From owner-freebsd-doc  Thu Jun 29 20: 8:54 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from waterblue.imgsrc.co.jp (waterblue.imgsrc.co.jp [210.226.20.160])
	by hub.freebsd.org (Postfix) with ESMTP
	id 2E7EF37B68D; Thu, 29 Jun 2000 20:08:49 -0700 (PDT)
	(envelope-from kuriyama@FreeBSD.org)
Received: from waterblue.imgsrc.co.jp (localhost [127.0.0.1])
	by waterblue.imgsrc.co.jp (8.11.0.Beta3/8.11.0.Beta1) with ESMTP id e5U38oh58502;
	Fri, 30 Jun 2000 12:08:52 +0900 (JST)
Date: Fri, 30 Jun 2000 12:08:50 +0900
Message-ID: <7m1z1fx3ul.wl@waterblue.imgsrc.co.jp>
From: Jun Kuriyama <kuriyama@FreeBSD.org>
To: doc@FreeBSD.org, current@FreeBSD.org
Subject: Re: XML driver config file to replace LINT
In-Reply-To: In your message of "29 Jun 2000 16:01:36 GMT"
	<200006291558.JAA34002@harmony.village.org>
References: <20000629144257.A23415@catkin.nothing-going-on.org>
	<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>
	<200006290024.SAA59981@harmony.village.org>
	<200006291558.JAA34002@harmony.village.org>
User-Agent: Wanderlust/1.1.1 (Purple Rain) SEMI/1.13.7 (Awazu) FLIM/1.13.2 (Kasanui) MULE XEmacs/21.1 (patch 9) (Canyonlands) (i386--freebsd)
MIME-Version: 1.0 (generated by SEMI 1.13.7 - "Awazu")
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: quoted-printable
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


So, this is what I worried about. :-)

At 29 Jun 2000 16:01:36 GMT,
Warner Losh <imp@village.org> wrote:
> I'd violently oppose this.  I'd rather see the XML file generated from =

> the .h files that we already use to build the system with.  You would
> be making it just as hard to keep things up to date with little gain
> from the programmer's point of view.  You need to make it easier for
> the programmer to keep things up to date rather than harder.

=46rom the documentation point of view, XML source file should be used
to generate other "rendered" text such as *.c/*.h.  In principle,
using XML is same process such as using src/sys/dev/usb/usbdevs.  As
you know, generation of usbdevs{,_data}.h is done by awk script.  And
same procedure is done in src/sys/dev/pccarddevs for generating
pccarddevs{,_data}.h.

I think what Nik wants to say is, suggesting standard scheme to
generate these files from human readable source file.  And he suggests
XML as that source file format.

Of course, source tree are for programmers.  First thing we should
consider is not to stress programmers for that procedure.  Nik's
suggestion is more conceptual one.  We need more discussion for this
subject.

# Nik, we should explain more about XML for freebsd-current people
# before stepping forward. :-)


-- =

Jun Kuriyama <kuriyama@FreeBSD.org> // FreeBSD Project


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message