Date: Sun, 7 Jan 2007 22:15:46 +0100 From: "Simon L. Nielsen" <simon@FreeBSD.org> To: "Bruce A. Mah" <bmah@freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: RFC: Hardware notes rearrangement Message-ID: <20070107211545.GE996@zaphod.nitro.dk> In-Reply-To: <4596BCCE.3030302@freebsd.org> References: <4596BCCE.3030302@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2006.12.30 11:23:58 -0800, Bruce A. Mah wrote: > About a month ago, I rearranged the hardware notes on CURRENT, in effect > coalescing the multiple machine-dependent (MD) documents that got > generated into a single machine-independent (MI) document. Basically > it's easier to read and maintain this way. > > I'd like some review on a similar reorg of the hardware notes (also on > CURRENT). Hmm, seems like nobody else took the bait as I had hoped, so I guess I have to ;-). [...] > Also, as I'm reading through the hardware notes, there's a bunch of > information (particular in the "supported processor and motherboards") > section that could stand revising. That's probably best taken care of > after this. Yes, one step at the time is probably best. > Preliminary work is here: > > http://people.freebsd.org/~bmah/hardware2.tar.gz > http://people.freebsd.org/~bmah/hardware2.pdf I like the idea in general, especially since there is so much overlap between the different per arch hardware notes documents. For the PDF version I'm not particularly happy with the visual output of the [amd64,i386,sparc64] like lists, though I have no idea at the moment how to do it better. Actually, it seems like part of the problem is that the hardware notes just looks odd in the PDF version. I just built the HTML version and that looks fine, so that shouldn't be a blocker. Also, whatever format is used for the lists I think it should be explained with a couple of words in the intro. So to sum up: Go for it :-). -- Simon L. Nielsen
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20070107211545.GE996>