From owner-freebsd-doc@FreeBSD.ORG Sun Jan 7 21:37:41 2007 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 49FB316A407 for ; Sun, 7 Jan 2007 21:37:41 +0000 (UTC) (envelope-from simon@zaphod.nitro.dk) Received: from mx.nitro.dk (zarniwoop.nitro.dk [83.92.207.38]) by mx1.freebsd.org (Postfix) with ESMTP id 0504113C468 for ; Sun, 7 Jan 2007 21:37:40 +0000 (UTC) (envelope-from simon@zaphod.nitro.dk) Received: from zaphod.nitro.dk (unknown [192.168.3.39]) by mx.nitro.dk (Postfix) with ESMTP id 78BD12D6046; Sun, 7 Jan 2007 21:15:22 +0000 (UTC) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 386DB11434; Sun, 7 Jan 2007 22:15:46 +0100 (CET) Date: Sun, 7 Jan 2007 22:15:46 +0100 From: "Simon L. Nielsen" To: "Bruce A. Mah" Message-ID: <20070107211545.GE996@zaphod.nitro.dk> References: <4596BCCE.3030302@freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4596BCCE.3030302@freebsd.org> User-Agent: Mutt/1.5.11 Cc: freebsd-doc@freebsd.org Subject: Re: RFC: Hardware notes rearrangement X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Jan 2007 21:37:41 -0000 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