From owner-freebsd-doc Wed Dec 11 14:33:31 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9523E37B401; Wed, 11 Dec 2002 14:33:29 -0800 (PST) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8C02243EA9; Wed, 11 Dec 2002 14:33:28 -0800 (PST) (envelope-from trhodes@FreeBSD.org) Received: from moble.pittgoth.com (acs-24-154-229-196.zoominternet.net [24.154.229.196]) by pittgoth.com (8.12.6/8.12.6) with SMTP id gBBMXQNN043896; Wed, 11 Dec 2002 17:33:27 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Wed, 11 Dec 2002 17:33:54 -0500 From: Tom Rhodes To: Marc Fonvieille Cc: FreeBSD-doc@FreeBSD.org Subject: Re: Question for -doc team on 4.X > 5.X Message-Id: <20021211173354.62dd76ae.trhodes@FreeBSD.org> In-Reply-To: <20021211211618.GA204@nosferatu.blackend.org> References: <20021211153317.4a590b13.trhodes@FreeBSD.org> <20021211211618.GA204@nosferatu.blackend.org> X-Mailer: Sylpheed version 0.8.6claws (GTK+ 1.2.10; i386-portbld-freebsd4.7) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Wed, 11 Dec 2002 22:16:18 +0100 Marc Fonvieille wrote: > On Wed, Dec 11, 2002 at 03:33:17PM -0500, Tom Rhodes wrote: > > Fellow -docers, > > > > I've been playing around with 5.X features vs 4.X features and have > > come to a conclusion that its going to be messy for us to just make > > notes where they differ in the following chapters: > > > > install > > kernelconfig > > > > and perhaps some others. My idea is just rewriting these areas, > > which is very possible. I've spoken about this to a few people > > so far and so far I've heard nothing but ``good, if its possible to > > complete'' however I'd rather get opinions from this list. What > > does everyone think? > > > > About install chapter, it is still possible to update it to cover 4.X > and 5.X without too much pain. Rewriting it from zero could be a bit > overkill; even if 4.X is, for the moment, the "main" branch, we have > to think twice before starting a major rewriting of 4.X specific > parts. I would rather see the birth/update of more arch-specific > sections (sparc64 etc.), and addition of new 5.X things that appear > in sysinstall. > There are not too much "new" things for a vanilla installation. For > example ACPI is a new thing, however, at installation time, the user > does not really spend time on it. ACPI has to be covered but with a > link to an important ACPI section/chapter. > I see many missing things in the installation part, for example, > people use to ask: "How many RAM I need to install FreeBSD?" etc. > > For kernelconfig, what are the "big" differences between 4.X and 5.X, > the configuration file, right? So what about a "The Configuration > File for FreeBSD 4.X" section and a "The Configuration File for > FreeBSD 5.X" one at first? It will be more readable than current > situation and easier to write... > There are two NOTES files: src/sys/conf/NOTES, which is generally for architecture-independent features/options/drivers/.., and src/sys/${arch}/conf/NOTES, for features/... specific to that platform. I think thats a difference. Covering multiple archs would be nice, I'm in the middle of ACPI right now. I think we need to cover UFS2 while we are at it also. While I can agree with 'conservative' yet I'm scared of how ugly this is going to look and forgive me for rehashing this topic again but it may also make the split-up so much more difficult. *Runs* -- Tom Rhodes To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message