macppc/install:
add description of "bad partition number, using 0no bootable HFS
partition" error message
mention that boot floppy must be booted from Open Firmware, you don't just
pop it in the floppy drive like a normal MacOS boot floppy.
example of how to read directory of CD or HD from OF (I think I got the
backslashes generated properly)
describe how to boot a kernel from an HFS partition
reiterate that some OF 1.0.5 machines can't seem to netboot
reverse recommendation of ultra0 and ultra1 busses
common/postinstall:
mention stty erase '^h' or '^?'
macppc/hardware:
mention that Sonnet Tempo ATA/66 card doesn't yet work with macppc
mention that adaptec 294x cards don't boot
mention that promise ultra66 works, but isn't bootable
macppc/prep:
mention that A/UX style partitions are interpreted as NetBSD-style
partitions, also that they're unreadable from MacOS
also describe the printenv command and give examples
mention that you can't hold down command-option-o-f on a PS/2 keyboard
rehash the partitioning section to describe under what conditions you can
have a drive with MacOS and NetBSD partitions, and what are the criteria
for a drive to be bootable under NetBSD.
recommend using official NetBSD CD-R image instead of rolling own CD-R
describe how to boot a kernel from an HFS partition
moved partitioning HDs to before copying files to it.
macppc/whatis:
heh, just noticed that it needed updating from NetBSD 1.4
define what "boot media" and "distribution media" mean
macppc/install:
corrected the text in example of booting system
corrected partition number to use in example of booting from HFS partition
added example of how to use MacOS X to print partition table using pdisk
macppc/prep:
actually drive setup 1.8.1 (ships with MacOS 9.0) works too
actually describe what netbsd.ram.gz is (installation kernel)
common/postinstall:
macppc uses vt100 for console, not vt220
describe how to mount root filesystem to edit /etc/rc.conf
order of recommendations for installation methods.
macppc/hardware:
update list of unsupported models
macppc/prep:
mention that ofwboot.elf is obsoleted, and all users should be using
ofwboot.xcf instead
link to partitioning HOW-TO on website
added some info on the "official" NetBSD/macppc-1.5.1 CD-R image
added some info on cdrecord
added note that netboot must be from on-board ethernet
macppc/install:
added a few more details to some of the open firmware error messages
reordered error messages to be in order user might encounter them
removed "pciide0:0:0: lost interrupt" since this is fixed in 1.5.1
added "TFTP timeout" and explanation to list of possible problems
point to macppc X11R6 HOW-TO
common/postinstall:
point to macppc X11R6 HOW-TO
common/xfer:
recommend waiting until later to create media for distribution sets
common/sysinst:
control-C to stop sysint, but added that you can re-run it from the
command prompt, no need to reboot.
added an example of what the sysinst main menu looks like
added some more info/details.
hardware:
add Netgear FA-311 cards (sip)
added newly supported models
added that NVIDIA now has some supported cards
moved on-board audio to supported, but untested
added usb and pci audio as supported
prep:
added a "Preparing yourself" section describing how to best prepare
oneself for the adventure ahead
some rewording of the 'how to get to open firmware' sections to make some
details more clear
I've organized the topics by Open Firmware version, since many users found
the old scheme way too confusing (clause out Open Firmware version-specific
content).
It's still really confusing to read (particularly the .txt version which
doesn't adequately distinguish headings from the body)
Also added a bit more info on partitioning vs. OF version.
capitalize X Window System
kill gratuitous newline
periods after sentences.
s/Domain Name Service/the Domain Name System/
s/new install system/current install system/
Be consistent and say 'ip address' not 'ip number'
Grammar (comma)
s/GMT/UTC/
Update document date.
Periods at ends of sentences.
Don't hyphenate NetBSD (for .ps versions)
Avoid wording that implies the current release is 1.5.
Emdashes are \(em and not -- and especially not '-'; no surrounding whitespace
bound checking => bounds checking
Grammar (including parallelism, articles, etc.)
Tagged lists spaced from largest tag.
Semicolons for list delimitters where commas are ambiguous.
Colons after text before examples.
s/1.4 or later/1.4 or prior/
Simon Burge is a pmax portmaster now
Havard Eidnes -> H\(oavard Eidnes
Jaromir Dolecek -> Jarom\('ir Dolecek [can we do better?]
note The End
they are suitable (for i386).
* Mention xf86config(1) for ports that use XFree86.
* Since i386 INSTALL kernels do not have symbols, point users at
the symbol files should they need them (hopefully not).
* mention additional kernels in binary/kernel/ dir: GENERIC_LAPTOP, etc
* note that we also include firewall software (besides X, ...)
* don't Xref the BUGS file, as it's gone
* update some file sizes (source .tgz files) to match BETA2
* mention that syssrc contains the source for all architectures
* Sysinst now allows setting root password and timezone - note that.
* Explain how to actually install binary packages, giving some
examples that people may want to install.
* Mention rawrite32 near rawrite.
* Don't show preparation of install tape on i386
* update i386 hardware a bit. This needs to be generated automatically...
* Many minor nits & typos.
sysinst: tsubai-san says that macppc doesn't suffer from install-related
pcmcia interrupt problems. removed those for macppc
upgrade: add conditional for macppc and sparc (don't need to boot
from floppy)
point out that some MacOS ftp programs default to ASCII mode
OF 2 systems reset real-base to default when booted into macos
install: add info on how to get OF to always boot
also mention that users may need to remove non-apple hardware
to get their systems to boot (in extreme cases)
block, as we're not using any formatting codes in here.
improve the comments and formatting of the example
- use /etc/rc.d/dhcpd restart as the example for how to restart the
dhcp server on a 1.5 box.
and it does work, so use it instead of .Dq for key names.
- use .Ic instead of .Nm for `external' commands (i.e, not those being
specifically described by this document)
add ross sparc 20 clone
a little more info on sw device
prep: mention that can't boot if root partition is past first 2 GB of disk
refine wording of section on scsi id mappings
install: add a little more info to the tape booting section
hardware: add Gee Three's stealth serial port and scca as console info
prep: chaos/control problems with system disk as well as bootvars
clean up the various exceptions between different versions of OF
removed .Key tags, as they aren't recognized by groff
added examples of how to create install media
install: clean up the various exceptions between different versions of OF
- use .Ic, .Pa, .Key, .Ul, .Tn, .Sq, .Dq as appropriate
- use .Dl instead of .(disp when formatting changes are required (the latter
doesn't cope too well when font change macros are used)
- wrap .Dl blocks with .Pp
- consistently use `file system' instead of `filesystem'
- migrate macppc to common/xfer
- document rc.d in `compatability issues with previous releases' section
- wrap .Dl blocks with .Pp
- use .Ul, .Pa, .Tn, .Bx, ...
- use .Pp after .Ss (since .Ss2 does this, and it looks slightly better)
- add tv@ to releng
- fix up sizes for various sets based on info from tv@ (any errors are
probably due to my conversion rather than his data)
- .Ic commands, .Pa paths, .Tn trade names
hardware: updated the list of what works, broken down by OF version
added devices reported as working by port-macppc posters
added list of what devices are supported by which versions of OF
included description of how each OF version boots
described partitioning
prep: describe how to enter OF depending on OF version
also described how to set up some important OF variables
install: give examples of boot commands
list of common error messages and what they mean
provided more detail when necessary and removed extraneous instructions.
hardware: totally revamped to be more readable and include all known
supported hardware, now matches htdocs/Ports/sparc/hardware.html
install: new section on CD-ROM, netboot has instructions on setting up a
NetBSD server, removed disklabel instructions (miniroot/sysboot's
instructions are clear enough and have error-checking anyways)
prep: reorganized, put in cleaner explanation of SCSI target remapping on
OpenBOOT PROM 1 machines, put in instructions on how to figure out names
ROM uses for SCSI device, put in info about 100BaseTX network cards
upgrade: now points to ../common/upgrade
