Date: Wed, 30 Aug 2000 15:45:08 +0100
From: Nik Clayton <nik@freebsd.org>
To: Jim Mock <jim@FreeBSD.ORG>
Cc: "Bruce A. Mah" <bmah@FreeBSD.ORG>, freebsd-doc@FreeBSD.ORG
Subject: Re: HARDWARE.TXT vs. {i386,alpha}/RELNOTES.TXT
Message-ID: <20000830154508.A62946@canyon.nothing-going-on.org>
In-Reply-To: <20000829204112.A5240@luna.osd.bsdi.com>; from jim@FreeBSD.ORG on Tue, Aug 29, 2000 at 08:41:12PM -0700
References: <200008291834.e7TIYFm20218@bmah-freebsd-0.cisco.com> <20000829204112.A5240@luna.osd.bsdi.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Aug 29, 2000 at 08:41:12PM -0700, Jim Mock wrote:
> On Tue, 29 Aug 2000 at 11:34:15 -0700, Bruce A. Mah wrote:
> > Could someone explain to this newbie why we maintain separate lists
> > of supported hardware in HARDWARE.TXT vs. {i386,alpha}/RELNOTES.TXT?
>
> I've never been able to figure this out either.
Me either (certainly predates me). Feel free to nuke it.
> > It seems to me we ought to have this information in one place only,
> > but maybe I'm missing something.
>
> Agreed.
>
> While I'm on the subject, I also think that Appendix F in the handbook
> (PC Hardware Compatibility) should die, and the Supported Hardware
> section of the install chapter should be what's kept up-to-date. Either
> that or the exact opposite -- rip the hardware out of the install
> chapter and put it in the appendix. Whichever is chosen doesn't really
> matter -- the point is, we only need one, and if it's not updated
> regularly, it's fairly useless anyway.
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!
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000830154508.A62946>