From owner-freebsd-doc Wed Dec 11 13:18:12 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 335AA37B401; Wed, 11 Dec 2002 13:18:11 -0800 (PST) Received: from abigail.blackend.org (blackend.org [212.11.50.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6F0C143EA9; Wed, 11 Dec 2002 13:18:09 -0800 (PST) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.1.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id gBBLI7ug015717; Wed, 11 Dec 2002 22:18:07 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) by nosferatu.blackend.org (8.12.6/8.12.6) with ESMTP id gBBLGJYq005643; Wed, 11 Dec 2002 22:16:19 +0100 (CET) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.6/8.12.6/Submit) id gBBLGJ1k005642; Wed, 11 Dec 2002 22:16:19 +0100 (CET) Date: Wed, 11 Dec 2002 22:16:18 +0100 From: Marc Fonvieille To: Tom Rhodes Cc: FreeBSD-doc@FreeBSD.org Subject: Re: Question for -doc team on 4.X > 5.X Message-ID: <20021211211618.GA204@nosferatu.blackend.org> References: <20021211153317.4a590b13.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20021211153317.4a590b13.trhodes@FreeBSD.org> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.7-STABLE 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, 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... Well I sound like a "conservative" person sometimes :)) Marc To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message