Larry E Kollar wrote:
> 
> Pull out the red pens, sharpen your tounges, and point your browser to
> <http://www.nyx.net/~lekollar/install.html>.  Please email your comments
> directly to me; I'll make the necessary fixes & put up a second draft.
> I know it needs a *lot* of work, but I was starting to run out of steam
> and it might have been a couple more weeks before I got satisfied.

Cool.  Pretty nice :-)

Here are my comments so far:

In your quote of minimum RAM and recommended disk space from the INSTALL
document, you might want to scrap the quote and just say that 8MB minimum
is strongly recommended.  Also, you might want to include that 4MB RAM
will require some amount of swap in order to run anything.

Although I could be wrong, I don't think that the Mac LC has any way to
install a PMMU, and therefore it will never run NetBSD.  If anyone knows
of a way around this, or perhaps if it is possible to upgrade one to an
'030 processor, please let me know.

As for 'LC040 machines, you might want to qualify that statement somewhat.
Although they are somewhat broken under -current, we do plan to have fully
working FPE for these machines one day, and I don't think we'd want lot's
of people going out and buying full '040's somewhat unnecessarily.  Of
course, it's still better to have a full '040 :-)

In the section where you point out the MacOS utilities needed to set up
NetBSD, you should probably make sure you're pointing to the latest
version.  In this case, that's Booter 1.11, Mkfs 1.45, and Installer 1.1f.
Each new version of these utilities usually fixes something or adds new
functionality, so it's best to keep current on them.  I'll see about
finding some standard place to link to in order to avoid constantly
updating documents (like I do with the FAQ).

Although I could be wrong on this one, I think that the latest version of
Mkfs can fix a broken partition map created by one of the broken
formatters.

With regards to SCSI disk naming, SCSI ID 0 isn't always the boot drive,
especially on machines with an IDE internal drive :-).  Also, you don't
actually have to have a SCSI ID 0, so /dev/sd0 is really mapped to the
SCSI disk with the lowest SCSI ID number.

The latest version of the Booter has a few more checkboxes, and some of
them need to be on.  The one for selecting the root SCSI device is the
only one that comes to mind at the moment, tho (unless that's a radio
button...I'm away from my machine at the moment).

The preferences section on the file menu has moved to the options menu, I
believe.  Also, it might no longer be called "save options & preferences".

Oh, things that you left out which might be somewhat important:
o extensions cause problems, you should boot with extensions off
o must boot in 32-bit addressing mode, this requires MODE32 on some
  machines
o should probably boot in black&white mode

I'm sure I've forgotten a few important points.

Other than that, it's great!!!!  Thanks for doing this, we've needed some
kind of update to the install docs for a while.  Now if only I could find
a way to make people actually read the thing....

Later.

-- 
Colin Wood                                 cwood@ichips.intel.com
Component Design Engineer - MD6                 Intel Corporation
-----------------------------------------------------------------
I speak only on my own behalf, not for my employer.