From owner-freebsd-doc  Wed Aug 30 14:31:28 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from spirit.jaded.net (shortbus.jaded.net [216.94.132.8])
	by hub.freebsd.org (Postfix) with ESMTP
	id 7B14237B422; Wed, 30 Aug 2000 14:31:25 -0700 (PDT)
Received: (from dan@localhost)
	by spirit.jaded.net (8.9.3/8.9.3) id RAA17841;
	Wed, 30 Aug 2000 17:31:21 -0400 (EDT)
	(envelope-from dan)
Date: Wed, 30 Aug 2000 17:31:21 -0400
From: Dan Moschuk <dan@freebsd.org>
To: Nik Clayton <nik@freebsd.org>
Cc: Jim Mock <jim@freebsd.org>, "Bruce A. Mah" <bmah@freebsd.org>,
	freebsd-doc@freebsd.org
Subject: Re: HARDWARE.TXT vs. {i386,alpha}/RELNOTES.TXT
Message-ID: <20000830173121.D17060@spirit.jaded.net>
References: <200008291834.e7TIYFm20218@bmah-freebsd-0.cisco.com> <20000829204112.A5240@luna.osd.bsdi.com> <20000830154508.A62946@canyon.nothing-going-on.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000830154508.A62946@canyon.nothing-going-on.org>; from nik@freebsd.org on Wed, Aug 30, 2000 at 03:45:08PM +0100
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


| Agreed.  In my ideal world, Appendix F becomes the official supported
| hardware list.  HARDWARE.TXT is generated by a process that does 
| something like
| 
|      cp ...../handbook/hardware/chapter.sgml .
|      cat doctype.sgml chapter.sgml | jade -foo -bar -baz ... > chapter.html
|      w3m -dump chapter.html > HARDWARE.TXT
| 
| I'm handwaving somewhat, but you get the idea.  HARDWARE.TXT in the 
| repository should say:
| 
|     DO NOT TOUCH THIS FILE.  IT IS GENERATED AUTOMATICALLY FROM THE 
|     HANDBOOK, GO AND EDIT THE HANDBOOK INSTEAD!

I volunteered about a month back to take over the responsibility of
maintaining the HARDWARE.TXT file.  In my ideal world, this file as well
as the handbook would be generated from some central XML point.  

I always meant to open up discussion on this list as to the best way of
doing this... now is as good of time as any. :)

Dan
-- 
Man is a rational animal who always loses his temper when he is called
upon to act in accordance with the dictates of reason.
                -- Oscar Wilde


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