Based on feedback (various), remove the .toc files from CVS,
and instead generate them each and every time (twice!).
Based on a suggestion from Alan Barrett, allow setting MAKETOC=no
to permit rebuilding the install notes without regenerating the
.toc files, to allow more speedy debugging of markup changes.

Initial generation of table of contents for each version of the release notes.

Based on feedback (various), remove the .toc files from CVS,
and instead generate them each and every time (twice!).
Based on a suggestion from Alan Barrett, allow setting MAKETOC=no
to permit rebuilding the install notes without regenerating the
.toc files, to allow more speedy debugging of markup changes.

Initial generation of table of contents for each version of the release notes.

Based on feedback (various), remove the .toc files from CVS,
and instead generate them each and every time (twice!).
Based on a suggestion from Alan Barrett, allow setting MAKETOC=no
to permit rebuilding the install notes without regenerating the
.toc files, to allow more speedy debugging of markup changes.

Initial generation of table of contents for each version of the release notes.

Based on feedback (various), remove the .toc files from CVS,
and instead generate them each and every time (twice!).
Based on a suggestion from Alan Barrett, allow setting MAKETOC=no
to permit rebuilding the install notes without regenerating the
.toc files, to allow more speedy debugging of markup changes.

Initial generation of table of contents for each version of the release notes.

branches: 1.5.32;
add prep.OPENFIRMWARE to list of merged sources

- define COMMON as "${.CURDIR}/../common", and use appropriately
- remove .PATH: ${.CURDIR}/../common
- update the various MERGED_SRCS lines to reflect reality

branches: 1.3.2;
Use bsd.man.mk (maybe should be something else) instead of bsd.prog.mk, and
do the cleaning differently.

Update dependancies to include common/sysinst and common/upgrade
(where appropriate).

branches: 1.1.2; 1.1.10;
Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

Various style fixes (and some of VAX related errors and copy&pastos),
from Mouse on tech-install.

branches: 1.19.6;
s/developement/development/

Modernize release notes:
- use https where possible
- adapt to cdn/nycdn and our current auto-build conventions
- automate where possible
Many thanks to uwe for lots of *roff help.

Pass the set suffix (either .tgz or .tar.xz) from the makefile.
Document the rescue set.

branches: 1.16.2;
Document the netbsd-POWERMAC_G5 and netbsd-POWERMAC_G5.MP kernels.

Mention macppc 601 needs to use separate boot floppies, kernels, and specific kernel on CD

branches: 1.14.2;
Fix a typo

Document debug sets and kernel module directory.

branches: 1.12.6; 1.12.12;
updates for PPC601 support being added

branches: 1.11.2;
- update upgrade issues:
+ ARM ABI change
+ new users
+ new groups
- add modules set where missing
- formatting improvements
- note that rtsol{,d} will be gone in the future
- fix raw partition info
- update sparc64 hardware support
- remove note about sparc SMP support being broken
- update some size requirements (still lots of ancient bogus RAM
minimums lingering -- HI PORTMASTERS!)
- various other minor content modernization
- whitespace fixes

branches: 1.10.12;
Add a description of the 'modules' set for all arches which have
MODULAR somewhere in the configs.

branches: 1.9.4; 1.9.6;
Move common/contents file into MD dirs again.
I know it isn't a good thing to have many copy-and-pasted contents
(set file descriptions etc) in all MD files, but it's much more annoying
to maintain a bunch of .if \n [${MACHINE}] conditionals for all ports
and maintainers rarely notice that they also have to prepare or update
MD contents in MI content file with messy ifdefs.

XXX: of course common text should be shared by mdoc macro etc.
but I doubt playing mdoc(7) is really worth...

migrate */contents -> common/contents, as there was *way* too much
unnecessary duplication. wrap the MD stuff in .if r_foo \{\ ... .\}

We ship XFree 3.3.6 these days, not 3.3.3.1.

Remove paragraph about secr set.

branches: 1.5.8;
fix english

You are leaving a maze of twisty little conditionals.
There are macs here.

* Delete sun3x from SUBDIR
* The merged contents file didn't work out, so nuke it and put it back
into each port directory. Most still have the now-pointless conditionals;
these now should be deleted.
* fix alpha, amiga, and arm32 to delete the maze of twisty little conditionals

Update to reflect current status.

Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

The awacs(4) driver was enabled in GENERIC back in 2018.

Documentation staleness noted by Andrew Randrianasulu on port-macppc@.

branches: 1.49.16; 1.49.24; 1.49.26;
updates for PPC601 support being added

branches: 1.48.2;
- update upgrade issues:
+ ARM ABI change
+ new users
+ new groups
- add modules set where missing
- formatting improvements
- note that rtsol{,d} will be gone in the future
- fix raw partition info
- update sparc64 hardware support
- remove note about sparc SMP support being broken
- update some size requirements (still lots of ancient bogus RAM
minimums lingering -- HI PORTMASTERS!)
- various other minor content modernization
- whitespace fixes

branches: 1.47.26;
Various updates to the INSTALL notes in preparation for 5.0. Changes
are still to come.

branches: 1.46.2; 1.46.4;
Fix one more warning in the previous.

Fix warning which makes html version a bit mangled.

branches: 1.44.2; 1.44.6; 1.44.10;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.43.2; 1.43.6;
updates from David H. Gutteridge via PR36373

branches: 1.42.10; 1.42.12;
- update list of supported machines
- mention that NetBSD uses different names for serial ports than OF
- update date of supported hardware info

branches: 1.41.2;
RealTek -> Realtek.

Spell controller with two ls. Inspired by miod@openbsd.

remove multiple processors from list of unsupported devices

- typos
- Xserve (Slot Load) reported to work by manu
- mention Xserve serial port
- mention G5 CPUs not supported yet
- update minimum hardware requirements

netbsd.org->NetBSD.org

iBook (14.1 LCD 32 VRAM) is reported to work by David Friggens
PowerBook G4 (12-inch) and PowerBook G4 (17-inch) supported thanks to
HAMAJIMA Katsuomi

Return accidentally deleted info about multiprocessor systems

misc small typos and wording cleanup
PowerBase is actually Open Firmware 2.0.x
add iBook (16VRAM) and iBook (Summer2002) as supported models
mention next release of NetBSD will support multiple CPUs
mention that some L3 caches on CPU upgrades may not be enabled by default
PowerMacintosh G4 (FW 800) model is reported to work with 1.6.1
macppc uses gem driver instead of gm ethernet driver now
macppc uses tlp driver instead of de ethernet driver now
AirPort Extreme is unsupported
full wscons capabilities not supported (virtual terminals and color)
keyboard problems with iMac and B&W G3 seem to have been cleared up

D'oh -- PowerComputing PowerBase models are actually Open Firmware 2.0.

Apple's official name for recent iBooks is actually (16VRAM).

Add mention of experimental MP support in -current

Matt Thomas <matt@3am-software.com> just added Xserve support to -current

Fix formatting errors.

Some newer models now confirmed to work with the latest 1.6_BETA snapshots
iBook (Late 2001) (Aymeric Vincent <Aymeric.Vincent@labri.fr>)
eMac (Josh Elsasser <jre@vineyard.net>)
PowerMacintosh G4/1000MP (Quicksilver 2002) (Joseph Sarkes <jsarkes@tiac.net>)

clean up formatting

iBook (Summer 2002) works according to itojun
PowerMacintosh 4400, Moto Starmax 3000 and 4000, and APS Tech M*Power
now boot with internal video in -current and 1.6 with todays commits

awacs audio is disabled by default
PowerBook G4 (DVI) and iMac (Summer 2001) are supported
PowerMacintosh 4400, Moto Starmax 3000 and 4000, and APS Tech M*Power
won't boot with internal video in -current and 1.6

branches: 1.24.2;
Kill ncr(4), mention esiop(4).

preparing for branch to 1.6

supported in -current:
PowerBook G4 (Gigabit Ethernet)
PowerMacintosh G4 (Quicksilver)
AirPort/AirMac and Lucent WaveLan

supported in 1.5.2 and later
Apple Worgroup Server 8550
Apple 53c875 Ultra Wide SCSI (needs firmware update)
usb SCSI adapters work

change time frame of supported/unsupported models
remove info specific to the 1.5 branch but no longer pertaining to
-current

Add Acard ATP-850/860 PCI IDE controllers to supported hardware.

Medium-scale overhaul.

macppc/hardware
Forgot to put PowerComputing PowerCenter in list of models that can't use
on-board video

macppc/prep
Reword four-key-combo c-o-O-F to imply you need to hold all four down
until the 0 > prompt appears, also a better description of the keys
shuffle System Disk instructions around a little to make more sense
Fix BootVars instruction to "uncheck auto-boot?"
Change '.Dl 0 \*> Ic "..."' to '.No 0 \*> Ic "..."' surrounded by .(disp
Link to new FAQ entries (such as how to use the Open Firmware environment
and instruction for people unfamiliar with MacOS)
Describe how to prepare an MS-DOS filesystem for booting
Be more consistent about "ISO9660"
The NetBSD/macppc boot CD-R image has "partition zero" bootloader and
XCOFF bootloader to work on all models -- this is described better now
Better info on how to netboot OF 1.0.5 systems
Mention that UFS is not currently supported by NetBSD and MacOS < 10
Detab the dhcpd.conf example
Add .To 2 tags for preparation of bootable media subsections

macppc/install
Change '.Dl 0 \*> Ic "..."' to '.No 0 \*> Ic "..."' surrounded by .(disp
Added new and very very useful "Open Firmware boot syntax" section
describing how to determine the OF boot-device and boot-file
Clean up examples of boot commands
Update descriptions of booting problems (some were incorrect)
Add .To 2 tags for OF boot command subsections and common problems

common/main:
quick start info about bootable CD-R image

common/sysinst:
point to FAQ entry on missing hard drives

macppc/hardware:
fix info on D-Link 530TX (vr) and 530TX+ (rtk)
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
mention that AirPort/AirMac 802.11b wireless is supported in -current
mention that CPU upgrades are supported

macppc/install:
point to partition numbering explanation in FAQ
fix kernel name on bootable cd-rom and mention case sensitivity

macppc/prep:
mention that people unfamiliar with MacOS should mail the port-macppc
list.
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
Umax S900 isn't supported by System Disk
describe how to use Disk Copy to create the bootable floppy
point to partition numbering explanation in FAQ
point to ISO mirror site list

D-Link DFE-530TX is really an rtk chipset, not vr

iMac (Summer 2000) has been supported for a while, but only recently
reported to port-macppc as working.

common/main:
quick guide for impatient reword netboot section, also macppc can netboot

macppc/hardware:
mention that some older models not listed might work, but are untested
mention that some iMac (Bondi Blue) and PowerMacintosh G3 (Blue and White)
systems have keyboard problems
mention that ttya is "modem" port, and ttyb is "printer" port

macppc/install:
describe the keyboard workaround for PM G3 (B&W), and that 1.4.3 works
fine for it and the iMac (Bondi)

macppc/prep:
make the whole BootROM/Open Firmware distinction clearer
describe that some models have to remove internal modem or set
input/output devices to ttyb since int modem usurps ttya.

macppc/whatis:
mention important changes, such as ELF, binary compatability, newly
supported models that don't require kernel patches, and that the install
procedure described now works for all models (i.e. Open Firmware 3
machines with only one hard drive).

Tsubai-san just added support for the iMac (Early 2001) model in -current
and netbsd-1-5

With Tsubai-san's last-minute patches, the iBook (Dual USB) is now supported!

Fix various misspellings of compatible/compatibility.

added "" around various tags (.Em, .Sq, .Li) that were missing.
this cleans up the HTML version a lot.

macppc/hardware
doubled required RAM -- bootloader needs 16 MB to be present
reworded video section -- 9500 shipped with PCI card, not on-board video

More minor updates based on user feedback

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.

macppc/hardware:
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

general clean-up. rearrange a few things to make more sense and change
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

General clean-up, some tightening of text to make it more readable. Also
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

By popular demand.

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.

Tweaks and re-detailing.

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

more work:
- use .Tn, .Bx, .Ul, .Key, .Sq, .Dq, .Li, .Dl, (etc) ... as appropriate
- be more consistent between various ports' install notes
- other cleanups

Major overhaul.

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

major terraform (this is MUCH more than a rototill :-), including:
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...

branches: 1.3.4;
sync with i386 about ahc.

branches: 1.2.2;
Update to reflect current status.

Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

Pre-release ISO installers should now be bootable, so drop a paragraph
that's no longer relevant. (Was PR port-macppc/54537.)

branches: 1.42.8; 1.42.10;
Pass the set suffix (either .tgz or .tar.xz) from the makefile.
Document the rescue set.

Add a note about pre-release ISO installers not being bootable. Relates
to PR port-macppc/54537. (This needs to also be placed in a more
prominent location. I've added it next to the explanation of the error
message for starters.)

branches: 1.40.2;
Mention macppc 601 needs to use separate boot floppies, kernels, and specific kernel on CD

branches: 1.39.30; 1.39.32;
Add some text to "Common Problems" about Open Firmware 3.x not
setting up the console and how to work around the problem. This
is an initial stab at solving PR/35348 for NetBSD 6.0. After 6.0
is released, a better solution can be done for 6.1.

branches: 1.38.4; 1.38.6; 1.38.8; 1.38.10;
Fix some typos, from OKANO Takayoshi in PR 45001.

- use \*[Gt] (for '>' prompt)
- use Li in table, not Dl
- fix warnings

branches: 1.36.2; 1.36.6; 1.36.10;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.35.10; 1.35.12; 1.35.16;
Encourage readers who have "READ TIMEOUT@" errors on floppies to write
the floppy images on the drive that will be reading them.

Mention "READ TIMEOUT@" in conjunction with the floppy boot instructions
and point the reader at the "Common problems" section. This is a really
common problem and will only get more common as floppy drives get older.

list a few more open firmware settings

Get rid of some superfluous "No Ns" calls before punctuation.

branches: 1.31.2;
Fix reference to ofwboot man page (was section 7, is section 8)

- fix some typos (netsbd.org -> NetBSD.org)
- add trailing slashes to URLs where appropriate
- netbsd.org -> NetBSD.org

- mkhybrid deprecated, describe mkisofs
- mention that OF may need version numbers from ISO 9660 file systems
- remove scsi-ext references (no such device)

- broaden note about older OF machines being unable to netboot compressed
kernels
- rearrange OF boot command examples
- minor polishing
- flesh out the details of how to get Open Firmware to boot the OS after
installation.
- mention "0 bootr" instead of boot sometimes fixes CLAIM-FAILED probs

netbsd.org->NetBSD.org

misc small typos and wording cleanup
fix links to newly updated Partitioning HOW-TO and mention use of pdisk
can't view files on official ISO image or floppy from Open Firmware
keyboard problems with iMac and B&W G3 seem to have been cleared up

Don't end line with an abbreviation dot, *roff will think it ends a sentence.

Consistently use "netbsd-XXXXX" instead of "netbsd.XXXXX".

work around argument quoting warning

Replace "filesystem" with the correct phrase, "file system."

clean up formatting

branches: 1.20.2;
remove absolute path to ofwboot.xcf from example netboot commands, making
it compatible with non-chroot tftp servers

Update macppc filenames based on files in latest snapshot (20020407).
That is, netbsd.ram.gz becomes either netbsd.INSTALL.gz or
netbsd.GENERIC_MD.gz depending on what media (and Open Firmware version).

Also, a few minor rewordings to clarify a little better.

Medium-scale overhaul.

macppc/hardware
Forgot to put PowerComputing PowerCenter in list of models that can't use
on-board video

macppc/prep
Reword four-key-combo c-o-O-F to imply you need to hold all four down
until the 0 > prompt appears, also a better description of the keys
shuffle System Disk instructions around a little to make more sense
Fix BootVars instruction to "uncheck auto-boot?"
Change '.Dl 0 \*> Ic "..."' to '.No 0 \*> Ic "..."' surrounded by .(disp
Link to new FAQ entries (such as how to use the Open Firmware environment
and instruction for people unfamiliar with MacOS)
Describe how to prepare an MS-DOS filesystem for booting
Be more consistent about "ISO9660"
The NetBSD/macppc boot CD-R image has "partition zero" bootloader and
XCOFF bootloader to work on all models -- this is described better now
Better info on how to netboot OF 1.0.5 systems
Mention that UFS is not currently supported by NetBSD and MacOS < 10
Detab the dhcpd.conf example
Add .To 2 tags for preparation of bootable media subsections

macppc/install
Change '.Dl 0 \*> Ic "..."' to '.No 0 \*> Ic "..."' surrounded by .(disp
Added new and very very useful "Open Firmware boot syntax" section
describing how to determine the OF boot-device and boot-file
Clean up examples of boot commands
Update descriptions of booting problems (some were incorrect)
Add .To 2 tags for OF boot command subsections and common problems

Quote > and < characters with \*> and \*< in order to get semi-correct
HTML as one of the results.

common/main:
quick start info about bootable CD-R image

common/sysinst:
point to FAQ entry on missing hard drives

macppc/hardware:
fix info on D-Link 530TX (vr) and 530TX+ (rtk)
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
mention that AirPort/AirMac 802.11b wireless is supported in -current
mention that CPU upgrades are supported

macppc/install:
point to partition numbering explanation in FAQ
fix kernel name on bootable cd-rom and mention case sensitivity

macppc/prep:
mention that people unfamiliar with MacOS should mail the port-macppc
list.
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
Umax S900 isn't supported by System Disk
describe how to use Disk Copy to create the bootable floppy
point to partition numbering explanation in FAQ
point to ISO mirror site list

common/main:
quick guide for impatient reword netboot section, also macppc can netboot

macppc/hardware:
mention that some older models not listed might work, but are untested
mention that some iMac (Bondi Blue) and PowerMacintosh G3 (Blue and White)
systems have keyboard problems
mention that ttya is "modem" port, and ttyb is "printer" port

macppc/install:
describe the keyboard workaround for PM G3 (B&W), and that 1.4.3 works
fine for it and the iMac (Bondi)

macppc/prep:
make the whole BootROM/Open Firmware distinction clearer
describe that some models have to remove internal modem or set
input/output devices to ttyb since int modem usurps ttya.

macppc/whatis:
mention important changes, such as ELF, binary compatability, newly
supported models that don't require kernel patches, and that the install
procedure described now works for all models (i.e. Open Firmware 3
machines with only one hard drive).

Describe how to install onto a drive that will also be used by MacOS (such
as most of the post-1998 models).

Also reminder about reversed MAC address on early models (macppc/install).

added "" around various tags (.Em, .Sq, .Li) that were missing.
this cleans up the HTML version a lot.

macppc/hardware
doubled required RAM -- bootloader needs 16 MB to be present
reworded video section -- 9500 shipped with PCI card, not on-board video

More minor updates based on user feedback

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.

macppc/hardware:
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

general clean-up. rearrange a few things to make more sense and change
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

By popular demand.

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.

tsubai said the 'panic mesh' error is fixed in 1.5

also mention about a bug in which the backlight on laptops is turned
all the way down and the screen may appear black.

prep: point to ZTerm as a MacOS terminal emulator
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)

- revert parts of previous
- use .Key instead of .Dq
- ``[kernel] [-as]'' is arguably better than ``[-as | kernel [-as]]''
- fix typo noted by tv on the releng mailing list

Tweaks and re-detailing.

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

more work:
- use .Tn, .Bx, .Ul, .Key, .Sq, .Dq, .Li, .Dl, (etc) ... as appropriate
- be more consistent between various ports' install notes
- other cleanups

Major overhaul.

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

branches: 1.2.2; 1.2.10;
Update to reflect current status.

Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

merge port-specific legal sections into the common file. most of these
entries were already in the common file, and it's a pain to maintain
them separately.

branches: 1.6.26;
Bradley A. Grantham's ad clause is no more.

briggs' acknowledgement is in mac68k and newsmips, where it belongs.

branches: 1.4.34;
use .It for formatting legal section.

Remove .Pp between items. (sync with common/legal.common rev 1.19)

major terraform (this is MUCH more than a rototill :-), including:
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...

branches: 1.1.2; 1.1.10;
Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

Final round of INSTALL cleanups for 5.0.

Various updates to the INSTALL notes in preparation for 5.0. Changes
are still to come.

branches: 1.42.2; 1.42.6; 1.42.12; 1.42.14;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.41.10; 1.41.12; 1.41.16;
Get rid of some superfluous "No Ns" calls before punctuation.

branches: 1.40.2; 1.40.4;
Substantial overhaul which splits OF versions up for clarity. Much of
what was in prep is now in prep.OPENFIRMWARE.

prep now calls prep.OPENFIRMWARE twice. The first time, it generates
documentation specific to Open Firmware 3 systems. The second pass, it
outputs OF 1.x and 2.x specific stuff. This makes it easier to follow
directions for a particular class of machines.

netbsd.org->NetBSD.org

misc small typos and wording cleanup
fix links to newly updated Partitioning HOW-TO
OF 3 firmware update 4.1.7, mention that it's not much of a problem anymore
point to ZTerm home page
redo partitioning section
update now that there's a pair of boot floppies
change MS-DOS floppy section to be Zip disk

Fix broken link. Pointed out by Ray Phillips on www@.
http://asu.info.apple.com/ has been replaced by
http://www.info.apple.com/support/downloads.html.

Consistently use "netbsd-XXXXX" instead of "netbsd.XXXXX".

Replace "filesystem" with the correct phrase, "file system."

Fix formatting errors.

clean up formatting

more detail about bootloader on MS-DOS partition
mention that monitor must support resolution of Open Firmware, which may
be that of previously selected res in MacOS.

Remove two unnecessary macro calls. Doesn't fix anything though :)

avoid indentation that's too deep

multi-line .Em does not work (INSTALL.txt does not generate this whole paragraph).

Someone moved the macppc boot floppy image in the distribution set to
installation/floppy/boot.fs without updating the docs.

branches: 1.27.2;
Update macppc filenames based on files in latest snapshot (20020407).
That is, netbsd.ram.gz becomes either netbsd.INSTALL.gz or
netbsd.GENERIC_MD.gz depending on what media (and Open Firmware version).

Also, a few minor rewordings to clarify a little better.

typo
move netboot stuff to ../common/netboot

mention 5500 and 6500 need nvramrc patches to use on-board video
remove info specific to the 1.5 branch but no longer pertaining to -current

Medium-scale overhaul.

macppc/hardware
Forgot to put PowerComputing PowerCenter in list of models that can't use
on-board video

macppc/prep
Reword four-key-combo c-o-O-F to imply you need to hold all four down
until the 0 > prompt appears, also a better description of the keys
shuffle System Disk instructions around a little to make more sense
Fix BootVars instruction to "uncheck auto-boot?"
Change '.Dl 0 \*> Ic "..."' to '.No 0 \*> Ic "..."' surrounded by .(disp
Link to new FAQ entries (such as how to use the Open Firmware environment
and instruction for people unfamiliar with MacOS)
Describe how to prepare an MS-DOS filesystem for booting
Be more consistent about "ISO9660"
The NetBSD/macppc boot CD-R image has "partition zero" bootloader and
XCOFF bootloader to work on all models -- this is described better now
Better info on how to netboot OF 1.0.5 systems
Mention that UFS is not currently supported by NetBSD and MacOS < 10
Detab the dhcpd.conf example
Add .To 2 tags for preparation of bootable media subsections

macppc/install
Change '.Dl 0 \*> Ic "..."' to '.No 0 \*> Ic "..."' surrounded by .(disp
Added new and very very useful "Open Firmware boot syntax" section
describing how to determine the OF boot-device and boot-file
Clean up examples of boot commands
Update descriptions of booting problems (some were incorrect)
Add .To 2 tags for OF boot command subsections and common problems

Quote > and < characters with \*> and \*< in order to get semi-correct
HTML as one of the results.

common/main:
quick start info about bootable CD-R image

common/sysinst:
point to FAQ entry on missing hard drives

macppc/hardware:
fix info on D-Link 530TX (vr) and 530TX+ (rtk)
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
mention that AirPort/AirMac 802.11b wireless is supported in -current
mention that CPU upgrades are supported

macppc/install:
point to partition numbering explanation in FAQ
fix kernel name on bootable cd-rom and mention case sensitivity

macppc/prep:
mention that people unfamiliar with MacOS should mail the port-macppc
list.
Some PowerBooks (FireWire and G4) won't work with FirmWare update 4.1.8,
need to use -current
Umax S900 isn't supported by System Disk
describe how to use Disk Copy to create the bootable floppy
point to partition numbering explanation in FAQ
point to ISO mirror site list

s/recommenation/recommendation/

common/main:
quick guide for impatient reword netboot section, also macppc can netboot

macppc/hardware:
mention that some older models not listed might work, but are untested
mention that some iMac (Bondi Blue) and PowerMacintosh G3 (Blue and White)
systems have keyboard problems
mention that ttya is "modem" port, and ttyb is "printer" port

macppc/install:
describe the keyboard workaround for PM G3 (B&W), and that 1.4.3 works
fine for it and the iMac (Bondi)

macppc/prep:
make the whole BootROM/Open Firmware distinction clearer
describe that some models have to remove internal modem or set
input/output devices to ttyb since int modem usurps ttya.

macppc/whatis:
mention important changes, such as ELF, binary compatability, newly
supported models that don't require kernel patches, and that the install
procedure described now works for all models (i.e. Open Firmware 3
machines with only one hard drive).

Fix various misspellings of compatible/compatibility.

Describe how to install onto a drive that will also be used by MacOS (such
as most of the post-1998 models).

Also reminder about reversed MAC address on early models (macppc/install).

added "" around various tags (.Em, .Sq, .Li) that were missing.
this cleans up the HTML version a lot.

macppc/hardware
doubled required RAM -- bootloader needs 16 MB to be present
reworded video section -- 9500 shipped with PCI card, not on-board video

More minor updates based on user feedback

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.

macppc/prep:
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

macppc/hardware:
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

general clean-up. rearrange a few things to make more sense and change
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

General clean-up, some tightening of text to make it more readable. Also
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

By popular demand.

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.

mountd and nfsd live in /usr/sbin, not /sbin.

prep: point to ZTerm as a MacOS terminal emulator
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)

- for the example dhcp config, use .(disp .. .disp) instead of a huge .Dl
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.

- revert part of previous: .Key is a macro defined in ../common/macros,
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)

Tweaks and re-detailing.

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

more work:
- use .Tn, .Bx, .Ul, .Key, .Sq, .Dq, .Li, .Dl, (etc) ... as appropriate
- be more consistent between various ports' install notes
- other cleanups

Major overhaul.

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

major terraform (this is MUCH more than a rototill :-), including:
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...

branches: 1.2.8;
fix english

branches: 1.1.2;
Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

Update for pkgsrc README.html transition

Modernize release notes:
- use https where possible
- adapt to cdn/nycdn and our current auto-build conventions
- automate where possible
Many thanks to uwe for lots of *roff help.

branches: 1.20.2;
Mention macppc 601 needs to use separate boot floppies, kernels, and specific kernel on CD

branches: 1.19.4; 1.19.6;
Change the deprecation notice about ofwboot.elf to say that it may
still be required in some cases, as observed by some MacMini users.

branches: 1.18.8;
first pass de-suckification for 2015. modernize content a bit, fix dirty
rotten lies, improve wording, sync legalese with reality, yada yada yada.

catch up with current ISO naming conventions

Update path to release ISOs.

branches: 1.15.20;
PR# install/44593: Please give release ISO's more meaningful names

Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.

ok snj@

branches: 1.14.6;
Update rawrite32 url

Final round of INSTALL cleanups for 5.0.

Various updates to the INSTALL notes in preparation for 5.0. Changes
are still to come.

branches: 1.11.2; 1.11.4;
Use \*[Lt] and \*[Gt].

Fix warnings.

branches: 1.9.2; 1.9.6; 1.9.10;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.8.2; 1.8.4; 1.8.8;
Adapt iso image names to current conventions and suffix them with the current
version number.

cdrecord package has been renamed to cdrtools, fix paths.
From OKANO Takayoshi in PR 33008.

Get rid of some superfluous "No Ns" calls before punctuation.

branches: 1.5.2; 1.5.4;
- fix some typos (netsbd.org -> NetBSD.org)
- add trailing slashes to URLs where appropriate
- netbsd.org -> NetBSD.org

branches: 1.4.2;
- mkhybrid deprecated, describe mkisofs
- update Toast instructions for Toast 5 instead of Toast 4

include UFS support in partitioning section

fix typos

Substantial overhaul which splits OF versions up for clarity. Much of
what was in prep is now in prep.OPENFIRMWARE.

prep now calls prep.OPENFIRMWARE twice. The first time, it generates
documentation specific to Open Firmware 3 systems. The second pass, it
outputs OF 1.x and 2.x specific stuff. This makes it easier to follow
directions for a particular class of machines.

branches: 1.3.34;
major terraform (this is MUCH more than a rototill :-), including:
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...

branches: 1.2.2; 1.2.10;
Update to reflect current status.

Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

Make the port-specific changelog ($MACHINE/whatis) optional by using .pso
to call a shell script which outputs nothing if the file is not present.

Remove the "whatis" file for ports where it does not contain anything
useful and hasn't been updated for years. OK tsutsui@, hubertf@.

Clear the old list of changes (between NetBSD 2.0 and 3.0 releases) as a
preparation for filling the list of changes between NetBSD 3.0 and 4.0
releases. In some obsolete claims like "this is the n-th major releae of
NetBSD for the xyz platform" replace n by XXX.

branches: 1.7.6; 1.7.12; 1.7.14;
- remove AirPort and audio -- they were for 1.6
- add SMP since it will be in 2.0
- add UFS support since it will be in 2.0

clean up formatting

Update for 1.6, remove some stuff that was new in 1.5.

branches: 1.4.2;
common/main:
quick guide for impatient reword netboot section, also macppc can netboot

macppc/hardware:
mention that some older models not listed might work, but are untested
mention that some iMac (Bondi Blue) and PowerMacintosh G3 (Blue and White)
systems have keyboard problems
mention that ttya is "modem" port, and ttyb is "printer" port

macppc/install:
describe the keyboard workaround for PM G3 (B&W), and that 1.4.3 works
fine for it and the iMac (Bondi)

macppc/prep:
make the whole BootROM/Open Firmware distinction clearer
describe that some models have to remove internal modem or set
input/output devices to ttyb since int modem usurps ttya.

macppc/whatis:
mention important changes, such as ELF, binary compatability, newly
supported models that don't require kernel patches, and that the install
procedure described now works for all models (i.e. Open Firmware 3
machines with only one hard drive).

macppc/prep:
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

major terraform (this is MUCH more than a rototill :-), including:
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...

branches: 1.1.2; 1.1.10;
Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.

- move "MD instructions on setting up boot media"
from common/xfer with messy mdoc .if conditionals
into MD xfer files so that developers can see
what contents are missing or obsolete and should be
written or updated
- remove some useless MD description for maintainability

XXX: still a bunch of unmaintained .if \n [${MACHINE}] in common files

branches: 1.5.34;
more work:
- use .Tn, .Bx, .Ul, .Key, .Sq, .Dq, .Li, .Dl, (etc) ... as appropriate
- be more consistent between various ports' install notes
- other cleanups

major terraform (this is MUCH more than a rototill :-), including:
- update for 1.5 (still more MD stuff to check)
- use new macros in ../common/macros as appropriate
- introduce some CONSISTENCY between the various ports' install docs
- use various mdoc macros as appropriate, including .Li, .Pa, .Sy, and .Ic.
- migrate more stuff into ../common/*
- whitespace cleanup
- lots of other little things i'm sure...

branches: 1.3.2;
Fixed typo.

fix english

branches: 1.1.2;
Add notes from SUNAGAWA Keiki <kei_sun@ba2.so-net.ne.jp>.