Date: Wed, 11 Dec 2002 17:33:54 -0500 From: Tom Rhodes <trhodes@FreeBSD.org> To: Marc Fonvieille <blackend@FreeBSD.org> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 11 Dec 2002 22:16:18 +0100
Marc Fonvieille <blackend@FreeBSD.ORG> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20021211173354.62dd76ae.trhodes>