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.4.32;
- 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.10;
Makefiles for notes.

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

branches: 1.25.4;
Document netbsd-GENERIC.QEMU.gz

branches: 1.24.2;
alpha: GENERIC.MP is no more

s/developement/development/

Pass the name of the compressor actually used for sets to groff and use
it in the content description (XXX need to adapt a few more copies in,
as of now, unaffected architectures)

Mention that USE_XZ_SETS are either always xzipped, and in evbarm might
be xzipped or gzipped.

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.18.2; 1.18.4;
Fix a typo

Document debug sets and kernel module directory.

branches: 1.16.8; 1.16.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.15.24;
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 \{\ ... .\}

update copyright date

We ship XFree 3.3.6 these days, not 3.3.3.1.

Remove paragraph about secr set.

branches: 1.10.8;
* 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.

More edits to make these instructions apply to snapshots as well as
releases. There is now a #if _FOR_RELEASE that selects text blocks.

Edits for toolchain installation.

Insert edits suggested by cgd@netbsd.org and fix the cpp alpha/*.tgz
unclosed-comment error. (sigh)

Modify ./contents + ./install;
* no more binary toolchain tarball
* source toolchain tarball still present
* some english
* add bs=18k on the floppy dd(1) example, just to be safe on systems
that don't like to cross cylinder boundaries (and it's faster)
Modify ./upgrade:
* untangle the first pp

RCS Id Police.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install notes.

some srm firmware (including legacy platforms) still available at hp ftp.
not sure if HPE selling firmware CDs, but it is definitely not Compaq anymore.

branches: 1.19.8;
spelling (DEC called it "TURBOchannel")

- 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.17.26;
Final round of INSTALL cleanups for 5.0.

Yet another round of INSTALL fixes.

branches: 1.15.2; 1.15.4;
Use \*[Gt].

branches: 1.14.16; 1.14.18; 1.14.26; 1.14.32; 1.14.36;
netbsd.org->NetBSD.org

clean up whitespace, formatting, copyrights

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

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;
sync with i386 about ahc.

Be more precise about which of Adaptec's AIC chips we support.
Fixes PR kern/7011 by Olaf Seibert.

Markup for -mdoc and -mdoc2html.

#if 0 the entire supported hardware section and add a #else note explaining
its absence from the snapshot instructions.

Document the support of LEMAC and DEPCA type ISA cards.

Insert edits suggested by cgd@netbsd.org and fix the cpp alpha/*.tgz
unclosed-comment error. (sigh)

RCS Id Police.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install notes.

fix a/an grammar in obvious cases

branches: 1.38.18;
spelling (DEC called it "TURBOchannel")

Final round of INSTALL cleanups for 5.0.

Yet another round of INSTALL fixes.

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

branches: 1.34.2; 1.34.4;
Use \*[Lt] and \*[Gt] rather than \*< and \*> .

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

branches: 1.32.2; 1.32.6; 1.32.8;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.31.2; 1.31.4; 1.31.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 some URLs. From OKANO Takayoshi in PR 33001.

Updated URL for list of NetBSD mirrors.

branches: 1.28.2;
Update text since there are now three install floppies. It's
written to cover the 2-floppy case as well, so if this file is
updated later with delta's needed on netbsd-2-0, this one revision
does not need to be excluded.

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

netbsd.org->NetBSD.org

consistently use Ic for sysinst

clean up whitespace, formatting, copyrights

branches: 1.23.2;
Replace tabs with spaces in two places inside .(disp, so that the
bootptab and dhcpd.conf entries are not brought flush against the
right margin, but instead get sane formatting.

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

Minor spelling fix. s/necesary/necessary/

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

update copyright date

branches: 1.17.2;
Fix netboot link - noted by ADAM Sulmicki

Discuss netboot on 3000/xxx and other old SRM systems. Reported by Charles.

branches: 1.15.2;
Describe all six ways of loading the installer.

Markup for -mdoc and -mdoc2html.

s/tar xpfz/tar xpzf/

Add notes about steps to do after installation that are common to all
platforms; Thanks to Colin Wood and Simon Burge for their comments.

Keep trying to make this amount to something.

Improve the alternate unpacking shellcode.

Edits for toolchain installation.

Insert edits suggested by cgd@netbsd.org and fix the cpp alpha/*.tgz
unclosed-comment error. (sigh)

Note that a ./MAKEDEV all is needed, document the install script
functions, briefly describe a manual install, fix section cross
references, and other misc edits.

Correct spelling in */upgrade. More general editing in alpha/install.

Getting closer.

Modify ./contents + ./install;
* no more binary toolchain tarball
* source toolchain tarball still present
* some english
* add bs=18k on the floppy dd(1) example, just to be safe on systems
that don't like to cross cylinder boundaries (and it's faster)
Modify ./upgrade:
* untangle the first pp

RCS Id Police.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install 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.9.32; 1.9.78;
avoid empty lines between advert clause

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

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

indent paragraph following "in the following statement, This software [...]"

branches: 1.4.10;
Markup for -mdoc and -mdoc2html.

RCS Id Police.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install notes.

branches: 1.6.32;
clean up whitespace, formatting, copyrights

branches: 1.5.2;
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.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install notes.

branches: 1.9.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.8.10;
Merge the alpha and i386 upgrade sections: .so ../common/upgrade

Note that a ./MAKEDEV all is needed, document the install script
functions, briefly describe a manual install, fix section cross
references, and other misc edits.

Correct spelling in */upgrade. More general editing in alpha/install.

s-/usr/mdec/install-&boot-

Modify ./contents + ./install;
* no more binary toolchain tarball
* source toolchain tarball still present
* some english
* add bs=18k on the floppy dd(1) example, just to be safe on systems
that don't like to cross cylinder boundaries (and it's faster)
Modify ./upgrade:
* untangle the first pp

RCS Id Police.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install notes.

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.10.6; 1.10.12; 1.10.14;
remove unnecessary .It

update MD "whatis" to closer to what 1.6 provides

clean up whitespace, formatting, copyrights

branches: 1.7.2;
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.8;
Document some of the 1.3 -> 1.4 features.

branches: 1.4.2;
Markup for -mdoc and -mdoc2html.

RCS Id Police.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install 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.7.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.6.4;
Fix doubled 'the's.

Markup for -mdoc and -mdoc2html.

Keep trying to make this amount to something.

RCS Id Police.

Various corrections, additions and reformatting.

branches: 1.1.2;
First go at alpha install notes.