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.3.32;
- define COMMON as "${.CURDIR}/../common", and use appropriately
- remove .PATH: ${.CURDIR}/../common
- update the various MERGED_SRCS lines to reflect reality

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

branches: 1.1.10;
Makefiles for notes.

Remove duplicated modules set description.

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

branches: 1.22.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.19.2; 1.19.4;
Fix a typo

Document debug sets and kernel module directory.

branches: 1.17.8; 1.17.14;
- 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.16.12;
Add a description of the 'modules' set for all arches which have
MODULAR somewhere in the configs.

branches: 1.15.4; 1.15.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.11.8;
Delete maze of twisty little conditionals. 6 down, 11 to go.

* 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

Remove these before someone changes them. There is a common contents file
in distrib/notes/common/contents, conditionalized for the differences
between platform distributions.

1) Remove all vestiges of tar from src/distrib. Use pax and appropriate
commandlines for all tar operations. (work supplied by Matt Green)
2) Update arch/*/md.c to deal with new sysinst/run.c. Special case
anything that needs to do a redirect or a pipe.
3) #if 0 some unused code in target.c. This code will need to be updated,
or special cased with do_system.

Big thank you to Matt for all his work on this.

RCS Id Police.

Updated installation notes from Thorsten Frueauf.

Create _S_VERS to hold output of `osversion.sh -s`
Replace all explicit version numbers with _VER or _SVER_S
for automagic expansion

branches: 1.4.2;
Reword the `domestic' items a bit so they do not state an explicit legal
opinion regarding ITAR/EAR.

merge in 1.2 branch

branches: 1.2.4;
Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes

Update description about 362 and 382 framebuffers.

Use https:// links for www.NetBSD.org port pages.

Fix typo.

branches: 1.28.2;
Add 98542 and 98543 framebuffers to supported "Graphics Devices" section.

I hope someone will sync a list of supported devices in port wiki pages
with one in this installation notes.

Add three button trackballs (M1309A) to a supported HP-HIL device list.

Asked by Jonathan Stone on port-hp300@, and tested by me:
https://mail-index.netbsd.org/port-hp300/2024/01/14/msg000238.html

branches: 1.26.2;
Mention that emulated disks by HPDisk and HPDrive work.

Also add more HP-IB disk models per recent changes.

HP9000/360 can have up to 16 MB RAM, not 48 MB.

Per Service Information Manual HP 9000 Series 300 Computers Models 360/370.

Add A1659A CRX framebuffer to "Supported hardware" list.

Also remove SGC support from "Unsupported hardware" list.

Now Xserver works on hp425e built-in EVRX framebuffer.

Move HP332 to "Supported hardware" list, as reported by Chris Hanson.

Fix typo.

branches: 1.20.12; 1.20.14;
Sync description of "supported hardware" with reality.

- internal video on 362 and 382 works (no palette support)
- framebuffer 425e works (console text only)
- serial console for 425e on bootloader works
- Tigershark PersonalVRX was ported from OpenBSD (untested)
- Apollo Domain keyboard and mouse work
- ARCOFI audio on 425e works
- internal SCSI floppy is recognized as usual removable disk by MI SCSI

branches: 1.19.2; 1.19.6; 1.19.54; 1.19.58;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.18.4; 1.18.6; 1.18.10;
Update some description about SCSI devices to refrect MI SCSI support.

- dcl not really supported
- Update to reflect that dca and apci are now handled by the com driver.

netbsd.org->NetBSD.org

Update info on models 362 and 382

clean up whitespace, formatting, copyrights

branches: 1.13.2;
Model 310 has a 10 MHz CPU
minor typo

move suggested partition info to prep
mention that tapes and printers go on slow HP-IB and disks on fast HP-IB
point to FAQ for help setting up a serial console
list unsupported hardware

Clarify that only miniroot installs are supported ATM.

Flesh out details and make it look more like other platforms hardware
sections

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.7.10;
Markup for -mdoc and -mdoc2html.

RCS Id Police.

Updated installation notes from Thorsten Frueauf.

Create _S_VERS to hold output of `osversion.sh -s`
Replace all explicit version numbers with _VER or _SVER_S
for automagic expansion

branches: 1.3.2;
merge in 1.2 branch

branches: 1.2.4;
Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes

Convert TNF licenses to new 2 clause variant

branches: 1.9.32; 1.9.34;
clean up whitespace, formatting, copyrights

branches: 1.8.2;
move mention of partition a offset to section in prep
clean up a little formatting
mention that sysinst isn't described here
describe how to restart install program

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.5.4;
Fix doubled 'the's.

Markup for -mdoc and -mdoc2html.

RCS Id Police.

Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes

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.34; 1.6.80;
use .It for formatting legal section.

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.4.10;
Markup for -mdoc and -mdoc2html.

RCS Id Police.

Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes

Use https for www.NetBSD.org links.

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

branches: 1.23.2; 1.23.4;
Use \*[Gt].

Fix a warning.

branches: 1.21.2; 1.21.6; 1.21.10;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.20.2; 1.20.4; 1.20.8;
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!

Fix typo, improve English; new sentence, new line.

Add more description about rbootd(8) and YAMAMORI Takenori's
sun-rbootd package for NetBSD/hp300 and OpenBSD/hp300, which
works on more other OSs including SunOS 4.x, Solaris 2.x, HP-UX 10,
HP-UX 9, NEWS-OS 4.x, FreeBSD, and Linux.

netbsd.org->NetBSD.org

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

consistently use Ic for sysinst

clean up whitespace, formatting, copyrights

branches: 1.13.2;
typo

move netboot stuff to ../common/netboot
major overhaul

Clarify that only miniroot installs are supported ATM.

Minor spelling fixes.

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.7.10;
Markup for -mdoc and -mdoc2html.

RCS Id Police.

Update for SYS_INST changes.

Updated installation notes from Thorsten Frueauf.

branches: 1.3.2;
merge in 1.2 branch

branches: 1.2.4;
Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes

fix various typos in comments, docs and log messages.

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

branches: 1.19.64; 1.19.66;
Convert TNF licenses to new 2 clause variant

branches: 1.18.32; 1.18.34;
consistently use \n[MACHINE] instead of r_MACHINE in places

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

clean up whitespace, formatting, copyrights

branches: 1.15.2;
move installing new bootloader to top of list of things to do (in case
kernel is incompatible with older version of SYS_UBOOT).
add section headings
describe how to prepare the miniroot easier than normal installation methods
mention that you have to reboot manually after miniroot is done

remove unnecessary "

remove reference to update(8)

fix bad quoting in .Dl .. .Ic lines when using other formatting (e.g, Ar)

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.9.4;
remove netstart

1) Remove all vestiges of tar from src/distrib. Use pax and appropriate
commandlines for all tar operations. (work supplied by Matt Green)
2) Update arch/*/md.c to deal with new sysinst/run.c. Special case
anything that needs to do a redirect or a pipe.
3) #if 0 some unused code in target.c. This code will need to be updated,
or special cased with do_system.

Big thank you to Matt for all his work on this.

Markup for -mdoc and -mdoc2html.

RCS Id Police.

Updated installation notes from Thorsten Frueauf.

Create _S_VERS to hold output of `osversion.sh -s`
Replace all explicit version numbers with _VER or _SVER_S
for automagic expansion

branches: 1.3.2;
merge in 1.2 branch

branches: 1.2.4;
Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes

Remove useless contents.

branches: 1.11.20;
Remove some obsolete new features.

branches: 1.10.2;
Mention there's now a sysinst installer available and fix a typo.

branches: 1.9.2;
Prep for 2.0 release:
- MI SCSI
- MI com

update MD "whatis" to closer to what 1.6 provides

branches: 1.7.2;
- update whatis files to contain (hopefully) up to date info on:
- "this is the xxx major release"
- features added and bugs fixed in 1.5
- use .Nx instead of NetBSD
- use .Sq instead of ' [...] ' or ` [ ... ] '
- use .Dq instead of " [...] "

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.5.10;
Markup for -mdoc and -mdoc2html.

RCS Id Police.

merge in 1.2 branch

branches: 1.2.4;
Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes

- 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.11.34;
move to the MI ../common/xfer

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.8.10;
Markup for -mdoc and -mdoc2html.

RCS Id Police.

Update IP address of ftp.netbsd.org.

Updated installation notes from Thorsten Frueauf.

Create _S_VERS to hold output of `osversion.sh -s`
Replace all explicit version numbers with _VER or _SVER_S
for automagic expansion

branches: 1.3.2;
merge in 1.2 branch

branches: 1.2.4;
Sync with netbsd-1-1; reflect current reality.

branches: 1.1.2;
hp300 port notes