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>