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

branches: 1.112.4;
PR 55413: 64-bit and OK police; grammar improvements.
From Michael Siegel.

Consistency and typo/grammar fixes from Michael Siegel in PR 55413,
With minor adjustments.

branches: 1.110.4;
More cleanup:
- simplify TOC handling and remove arg limit (from uwe)
- use Lk with explicit anchor text in some places
- do not allow official release builds when we can not derive the
proper date from the buildid

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.107.4; 1.107.6;
Remove port-acorn26

OK core@

- 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

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

branches: 1.104.4;
Bring back the playstation2 port - now that a toolchain for it is
available again.

Rename NetBSD/hp700 to NetBSD/hppa.

Unfortunately our VCS isn't very helpful here.

branches: 1.102.2;
More MI release notes updates, particularly around installing.

This could use more love!

branches: 1.101.4; 1.101.6;
- fix mdoc warning

Remove support for NetBSD/playstation2.

Kill an incorrect bit of text about creating device nodes that had been hiding
under a macppc conditional. Update for today's progress bar world.

Yet another round of INSTALL fixes.

Another round of INSTALL improvements big and small.

branches: 1.96.2;
Various updates to the install notes.

branches: 1.95.2;
Use `\*[Am]' rather than `\*&' for ampersand.

Use proper .Pq macro to restore parentheses removed by my wrong fix
in rev 1.90.

First cut at INSTALL notes for NetBSD/arc.
Finally we could close another ancient PR port-arc/11443.

After several years, we got the native bootloader and then had
sysinst which would do apprpriate partitioning for the bootloader,
so I've noted the last difficult part, how to specify boot commands
on the ARC BIOS.

I still wonder how many possible users of NetBSD/arc are there
who will need this topic though... ;-p

Use \*[Gt].

Fix a warning in macppc part.

".Po" and ".Pc" macro seems to cause the following warnings:
>> ../common/sysinst:1657: warning: macro `doc-pcresult' not defined

Use only ".Sy" for set names as common/contents and common/main.

XXX amiga/install, macppc/hardware, and sparc/prep still have them.

branches: 1.89.2;
Convert TNF licenses to new 2 clause variant

branches: 1.88.2; 1.88.6; 1.88.8;
- prepare for 5.0
- eliminate stuff specific to 4.0
- fix hp700 addition (/brick nick)
- lint

".ne" only ".if t" to avoid unwanted blank lines for text outputs.

Clean ugly figure:

.***********************************************.
* NetBSD-4.99.51 Install System * <==
* *
*>a: Install NetBSD to hard disk *
* b: Upgrade NetBSD on a hard disk *

Remove support for NetBSD/pc532.

Improve hp700 install notes somewhat.

Actually build and install a SYSNBSD.

Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

- lint
- mention set extraction progress bar

- alpha now requires three floppies
- newsmips now requires two floppies

First cut at NetBSD/ews4800mips install notes. Not well confirmed.
(I guess very few people will actually require it...)

branches: 1.79.4;
PR install/35528 from Wouter Schoot: fix typo in install docs

From dieter roelants in PR 35169:
- While reading install/12957 it was suggested
(http://mail-index.netbsd.org/port-i386/2006/11/27/0000.html)
that all notes, marked with '[PCMCIA]' should go and be
replaced with a more generic explanation about removable
devices.
- I noticed the HTML output concatenates 'NetBSD' and '4.0',
which is ugly.
- The IP addresses for ftp.NetBSD.org are wrong.

branches: 1.77.2;
PR/13749 - Incorrect options specified for dd(1) in tape installs.

Cleanup dd options accordingly to the following policy:
1) put if, of, bs, conv in this order
2) for reading/writing from/to disk don't use sync
4) reading from tape - use sync
3) writing to tape - use osync

Noted by Don Yuniskis (auryn at gci-net.com) via install/13749. Thanks!
Reviewed by <martin>. Thank you!

No acorn32 system that I know of has PCMCIA, so skip PCMCIA references there.

Properly use ".Nx Ns 's" for "NetBSD's" to avoid unknown version warning.

Don't hardcode release numbers, use \*V

branches: 1.73.2;
Clarified a few details about installing 32 bit sparc distribution on
sparc64 systems.

There is no "It-span" macro, replace with "It"; size column correctly
to fix a formatting error (hi hubertf!). Empty lines should have a single
dot, not two or none.

Fix some typos.

* Mention language selection
* Remove mentions of old releases
* More details how to drop into ddb
* Try to mention booting from CD instead of floppies on i386
* Mention mbrlabel(8) to get existing MBR partitions into a disklabel
* Default disklabel name doesn't seem to be "mydisk" any longer
(judging by this week's installation of 2.0_BETA/i386)
* Mention that DHCP will be offered

Todo:
* Enter size of extracted sets w/o X and of X sets (done for 2.0/i386)
(Portmasters?)

Add sparc64 tags
update sysinst menu example to say 2.0 instead of 1.6

branches: 1.68.2;
Remove paragraph that states that sgimips target media must be formatted first
with IRIX's fx -- this has not been true for quite some time.

sgimips now supports sysinst's sysinst's "install from cdrom" option.

minor nit about UFS support on macppc

macppc needs at least 16 MB RAM
a little rewording in the macppc disk preparation section

netbsd.org->NetBSD.org

fix a macppc TOC heading to be a little shorter

The walnut port has been subsumed by the new evbppc port.

XXX: There is some work to do here to allow for different
installation notes for different eval boards...

Minor tweak for clarity.

The mac68k installation kernels are INSTALL and INSTALLSBC, not GENERIC
and GENERICSBC.

Fix up sgimips install sections to more closely correspond to the current
state of reality: comment out O2 references since 1.6 won't support the
O2, add notes on installing via a net-booted kernel, disk partitioning
(disk must have IRIX volhdr, one-disk split NetBSD/IRIX install has not
been tested and may/may not work). Also expand/add some examples.

XXX: Should add info on the "extra" kernel sets like the INSTALL_INDY,
etc. sets.

use sh3eb or sh3el instead of sh3

- define some useful strings and use appropriately
\*[part_raw] `raw' partition (usually `c' or `d')
\*[part_free] first "free" partition (usually part_raw+1)
\*[part_usr] default "/usr" partition (usually part_free)
\*[part_max] last partition (usually `h' or `p')
- consistently use \n[MACHINE] instead of r_MACHINE
- fix up formatting fubars on mac68k (and others)

More minor updates to release notes -- a large part of these changes were
sgimips specific, but there are also MI tweaks.

more fixes to previous

doh; fix previous

fix up various .ie ... .el usages

Nx*V is not a valid macro...

more .ie ... .el fixes. (atari is still complaining about a missing .El)

- move a closing ".bullet)" outside of a mac68k specific section, so
that other platforms don't warnings about missing .El
- tweak newly added stuff to be consistent with recent cleanup i did

This is a complete refit of the mac68k documentation.

Of particular note is documentation on the new preferred method of
installation using sysinst, provided (and updated) by Bob Nestor.

Update sgimips portions of release notes to more closely match reality, esp.
after the removal of the kern-GENERIC set from sysinst. While here, fix up
some minor things (wording, bad markup, typoes) in the non-sgimips specific
common portions.

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

fix rev 1.37; .el needs .ie (not .if) to work

use .Nx \*V instead of .Nx\*V

More fixes and information for the CATS install documentation.

_ copyright crank
- whitespace cleanup
- formatting cleanup (start sentences on new lines)

Update for cats.

Fix sgimips typo while I'm here.

Add walnut installation notes.
Information to fill them mostly provided by eeh and simonb.

Fix some random buglets I stumbled over.

Add install notes for newsmips.
Written by NAKAJI Hiroyuki <nakaji@tutrp.tut.ac.jp>,
and some minor tweaks by me.

Fix typo.

s/kern.tgz/kern-GENERIC.tgz/

more atari docu fixes.

Yet more atari docu.

Fix version number in sysinst welcome screen.

acorn26 has sysinst now, so adapt the documentation to reflect that.
This includes some changes to common/sysinst to get the conditionals right
that might affect other ports.

add sgimips bits

from Scott G. Akmentins-Taylor

branches: 1.32.2;
Add sysinst notes to mvme68k installation instructions.

Make sure the example sysinst menu stays on one page (primarily for .PS
output format).

Switch to constant space mode for the sysinst dialogue screen display.
There seems to be no -mdoc feature for a constant space display.

common/main
tweaks to the "Quick install for the impatient", particularly changing the
recommendation to MS-DOS floppy with bootloader and kernel instead of
boot floppy image

common/sysinst
add .To 2 tags for macppc-specific sections

common/postinstall
change tlp0 to de0 in description of typical ethernet interface

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

Mention tlp0 as possible built-in ethernet option

Mention how to manually create /dev entries, since the suggested "Re-install
sets" option doesn't automatically do this (leaving the user without
/dev/console)

Add 3rd level sections (.To) to TOC, as this is so _long_.

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

Add support for FTP through a web proxy (via the ftp_proxy environment
variable).

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).

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.

Update copyright date
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/

fix warnings from html generation due to unexpanded
unquoted tabs.

Fix three typos.

* Mention the different floppy images and the machine types for which
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).

Several changes to our release notes, OK'd by Luke Mewburn:

* 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.

"compatable"->"compatible".

postinstall: add conditionals for hp300, macppc, and sparc

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)

added macppc- and sparc-specific conditionals and included a few important
details about each

more cleanups
- 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

Add some description for news68k.

- use the new macros in ../common/macros
- reword bits here & there, including fixing some typos, etc

- use "press" instead of "hit"
- use "MB" instead of "Mb"
- replace duplicate "wd" with the contextually correct "sd"

Fix missing conditional termination (.\}) from previous.

Pulldwon changes commited to netbsd-1-4 back to the trunk.
Most of revs 1.2.2.4 and 1.2.2.5.
Fix a few wording issues, and update the PCMCIA
section to note the existing of pcic irq probing.

X68k now uses sysinst.
Also update reflecting the current version.
More cleanup is needed before pulling it up to netbsd-1-5.

branches: 1.5.4;
Make setting of pcic_isa_intr_alloc_mask via DDB a bit clearer.
Suggested in PR 9568 by sanpei@sanpei.org

Sync with reality.

For a pmax:
+ Don't include pcmcia goop.
+ Don't mention floppy disks!
+ Add minimum memory requirements.
+ Only mention rz* disks, not wd* or sd*.
Mention that watching the file extraction list can slow things down on
a slow console.

branches: 1.2.2;
Describe multi-floppy boot.
Describe possible PCMCIA workaround via DDB now that DDB is in INSTALL.

Give the common install notes components their own subdirectory.
Also, alpha and i386 now use a single merged common/sysinst,
and arm32 and sparc have a single merged common/xfer.