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.

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

s/MRCOFFE$/MRCOFFEE/ and s/MRCOFFE_OFW/MRCOFFEE_OFW/ in install docs.

branches: 1.28.2;
Remove floppy installation instructions from sparc documentation.

Floppy generation was disabled before NetBSD 6.0 release due to size
constraints and unlikely to be restored soon or at all. PR port-sparc/56776.
ok martin.

s/developement/development/

It's KRUPS not GENERIC-KRUPS.

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.23.2; 1.23.4;
Fix a typo

Document debug sets and kernel module directory.

branches: 1.21.8; 1.21.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.20.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 \{\ ... .\}

We ship XFree 3.3.6 these days, not 3.3.3.1.

Remove paragraph about secr set.

branches: 1.16.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.

We don't ship with a FORTRAN compiler... point this out (the old text was
misguiding).
We do ship, however, with an Objective C compiler.

RCS Id Police.

Update files sizes and set names.

RELEASE => _VER

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

Pullup changes from 1.2 branch.

merge in 1.2 branch

do md_install_sets.

update a bit for 1.2

branches: 1.4.4;
Merge changes from 1.1 branch.

Update from 1-1 branch.

update

branches: 1.1.2;
first cut

- 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.36.26;
Note that SMP is broken on sparc.

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

branches: 1.34.2; 1.34.4;
Fix an unclosed bullet list which makes all notes mangled.

branches: 1.33.2; 1.33.6; 1.33.10;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.32.10; 1.32.12; 1.32.16;
- hyperSPARC SMP works
- nell has less problems

Mention that hme cards aren't supported on sun4c systems

cgeight is TC
removed "not well tested" from hme -- it is well tested and stable.
add a little more JavaStation-NC info
zx (leo) doesn't have X server support

branches: 1.29.2;
There's no such thing as "JavaStation-10". Krups official name is
"JavaStation-NC". Pointed out by Pete Zaitcev (long ago).

Minimal setup instructions for JavaStations.

spelling nit -- AFAICT, it's officially "hyperSPARC" not HyperSPARC

- formatting tweaks
- update minimum disk requirements
- update video support info
- a little more info on the SPARCbook internal modem
- mention that multiple SuperSPARC CPUs are supported, but not HyperSPARC

netbsd.org->NetBSD.org

NetBSD-sparc supports SMP for a while now.

fix broken link to CD-ROM FAQ

Mention that some non-Sun CD-ROM drives can't boot any OS on Sun hadware
(link to CD-ROM FAQ was already present)

updates per discussion with matt green

Properly name SPARCstation Voyager.
Mention that nell PCMCIA support works for Voyager as well as Sbus card.

clean up whitespace and formatting

branches: 1.18.2;
preparing for branch to 1.6

mention nell device support and restrictions
move javastation model from supported list to status webpage since most
of the useful support is not in-tree
move VME/IPI note inside the VME disk interface list
audiocs now supports recording and the JavaStation-1 and JavaStation-10
tcx driver supports JavaStation-1
Twinhead TWINstation 5G (SS5 clone) works
change wording to list all known classes of sun4m CPUs as being supported

fix some typos.

hardware: fix a couple of typos
add ross sparc 20 clone
a little more info on sw device

prep: mention that can't boot if root partition is past first 2 GB of disk
refine wording of section on scsi id mappings

install: add a little more info to the tape booting section

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. Cleaned up a lot of explanations, clarified instructions,
provided more detail when necessary and removed extraneous instructions.

hardware: totally revamped to be more readable and include all known
supported hardware, now matches htdocs/Ports/sparc/hardware.html

install: new section on CD-ROM, netboot has instructions on setting up a
NetBSD server, removed disklabel instructions (miniroot/sysboot's
instructions are clear enough and have error-checking anyways)

prep: reorganized, put in cleaner explanation of SCSI target remapping on
OpenBOOT PROM 1 machines, put in instructions on how to figure out names
ROM uses for SCSI device, put in info about 100BaseTX network cards

upgrade: now points to ../common/upgrade

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

RCS Id Police.

we now have floppy support for sun4m's.

RELEASE => _VER

branches: 1.8.2;
Retract statement about audio on LXen.

Update and clarifications (addresses PR#2933).

Pullup changes from 1.2 branch.

merge in 1.2 branch

update a bit for 1.2

branches: 1.3.4;
Merge changes from 1.1 branch.

Update (thanks Chuck).

branches: 1.1.2;
first cut

Remove floppy installation instructions from sparc documentation.

Floppy generation was disabled before NetBSD 6.0 release due to size
constraints and unlikely to be restored soon or at all. PR port-sparc/56776.
ok martin.

Punctuation in macro invocation must be a separate argument.

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

branches: 1.58.16; 1.58.18;
iso -> images

branches: 1.57.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.56.6;
point to iso/sparccd.iso, instead of the non-existant installation/cdrom/
subdir. should fix PR#32556 properly.

branches: 1.55.2; 1.55.10; 1.55.14;
Use \*[Lt] and \*[Gt] rather than \*< and \*> .

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

branches: 1.53.2; 1.53.6; 1.53.8;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

branches: 1.52.2; 1.52.4; 1.52.8;
Adapt iso image names to current conventions and suffix them with the current
version number.

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!

netbsd.org->NetBSD.org

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

clean up whitespace and formatting

branches: 1.47.2;
move netboot stuff to ../common/netboot

describe how to use bc to calculate the boot.net filename (in hex)
change ".Dl ok Ic commands" and ".Li ok Ic commands" into
".(disp/.disp) and ".No ok Ic commands"
since it actually uses a monospaced font in HTML

Fix symlink example in netboot section (PR#14809).

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

Clarify the disk2 confusion about .tgz files (grammar correction).

Seems people are very confused by the fact that floppy/disk2 is a symlink
to a .tgz file. Try to be a *bit* clearer. (Todd, please use hardlinks
next time ;-)

it is "boot net netbsd" for OBP2, from tron in private email.

Fix various misspellings of compatible/compatibility.

Switch to the more correct 'conv=sync' - from pk

dd disk2 requires conv=osync unless we are lucky enough to hit a 36k boundary
on a gzippd tarfile.

mention how to eject floppy, now that installer is on two disks and
doesn't seem to automatically eject the first one when it needs the second.

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

Note the terminal type inquiry at the start of the installation.

hardware: fix a couple of typos
add ross sparc 20 clone
a little more info on sw device

prep: mention that can't boot if root partition is past first 2 GB of disk
refine wording of section on scsi id mappings

install: add a little more info to the tape booting section

Update floppy & netboot section.
Add section on booting from tape.

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. Cleaned up a lot of explanations, clarified instructions,
provided more detail when necessary and removed extraneous instructions.

hardware: totally revamped to be more readable and include all known
supported hardware, now matches htdocs/Ports/sparc/hardware.html

install: new section on CD-ROM, netboot has instructions on setting up a
NetBSD server, removed disklabel instructions (miniroot/sysboot's
instructions are clear enough and have error-checking anyways)

prep: reorganized, put in cleaner explanation of SCSI target remapping on
OpenBOOT PROM 1 machines, put in instructions on how to figure out names
ROM uses for SCSI device, put in info about 100BaseTX network cards

upgrade: now points to ../common/upgrade

Update to reflect changes to the bootfs and miniroot images.

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

Remind people to gunzip syboot.fs

Now the miniroot based 'netbsd.ram.gz' is being installed into the installation
release dir we need to rename our 'netbsd.ram.gz' to 'netbsd.syram.gz'.
Man{ag,gl}ing two installation systems for NetBSD/sparc just gets more fun.

Try to cover the fact NetBSD/sparc has both a sysinst and a miniroot
isntallation option for all methods.

Clarify how to generate a NetBSD/sparc install floppy - from a mail by
Henry Nelson <henry@irm.nara.kindai.ac.jp>

Fix some netinstall related text

branches: 1.23.4;
Fix doubled 'the's.

Remove version number from boot image files.

Reduce block size in dd command to 4K; this should make the blocking factor
ok when reading from a pipe.

branches: 1.20.2;
note the sparc floppy somewhat

branches: 1.19.2;
add boot floppy stuff. 1.3 is the fourth netbsd/sparc release

Markup for -mdoc and -mdoc2html.

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

RCS Id Police.

RELEASE => _VER

Point at the pre-built `/usr/mdec/boot.net' file in the "diskless setup"
section.

branches: 1.13.2;
Remove cautioning against using `disklabel -r ..'

Drop in a note about the old-style `sd(c,u,p)' boot syntax.

Pullup changes from 1.2 branch.

update a bit for 1.2

branches: 1.9.4;
Merge changes from 1.1 branch.

Update from 1-1 branch.

update

Note upgrade.sh.

Update for release 1.1

branches: 1.4.2;
Start documenting 1.1 installation.

start doc on new ROMs

better and brighter

first cut

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.8.26;
Remove duplicates of ad clauses from the Alice Group (which is already
in legal.common, where it belongs).

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

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

RCS Id Police.

Update.

branches: 1.1.2;
first cut

Avoid dead link to the NVRAM FAQ in docs for sparc, too

Undo the .Ss2 quoting hack, the macros can now handle it.

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

Quote long .Ss2 title to avoid troff's limitation.

Troff is limited to 9 macro parameters and this title is 10 words, so
we lose the last word here when we pass arguments around. We have
more titles like that but for now I wanted to commit only one just to
flag the problem.

branches: 1.27.16; 1.27.18;
- 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.26.26;
Various updates to the INSTALL notes in preparation for 5.0. Changes
are still to come.

branches: 1.25.2;
Note root partition size limitations on certain sparc and sparc64 models
(taken from the boot(8) manual pages).

branches: 1.24.2;
Suppress the whitespace after parenthesis.

Fix warnings.

branches: 1.22.10; 1.22.12; 1.22.20; 1.22.26; 1.22.30;
Mention that installer defaults to serial speed of 9600 8N1 and user might
want to pre-configure their system around that.
Closes PR 11946

branches: 1.21.2;
update minimum disk requirements

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

clean up whitespace and formatting

branches: 1.18.2;
add note about dead NVRAM (ethernet address is all F's) and link to FAQ

add section describing how to boot from an SBUS card
change ".Dl ok Ic commands" into ".(disp/.disp) and ".No ok Ic commands"
since it actually uses a monospaced font in HTML

s/Asumming/Assuming/

Some factual & typographical corrections on the SCSI target mapping topic.

fix some typos.

hardware: fix a couple of typos
add ross sparc 20 clone
a little more info on sw device

prep: mention that can't boot if root partition is past first 2 GB of disk
refine wording of section on scsi id mappings

install: add a little more info to the tape booting section

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

minor fixes,
added info on how sun4 models deal with scsi targets
some typos caught
add info on how to break from automatically booting (i.e. enter ROM prompt)

Major overhaul. Cleaned up a lot of explanations, clarified instructions,
provided more detail when necessary and removed extraneous instructions.

hardware: totally revamped to be more readable and include all known
supported hardware, now matches htdocs/Ports/sparc/hardware.html

install: new section on CD-ROM, netboot has instructions on setting up a
NetBSD server, removed disklabel instructions (miniroot/sysboot's
instructions are clear enough and have error-checking anyways)

prep: reorganized, put in cleaner explanation of SCSI target remapping on
OpenBOOT PROM 1 machines, put in instructions on how to figure out names
ROM uses for SCSI device, put in info about 100BaseTX network cards

upgrade: now points to ../common/upgrade

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.8;
truely -> truly; PR 7762

Markup for -mdoc and -mdoc2html.

RCS Id Police.

Mention ifconfig(8)'s `media' parameter instead of `link[01]'.

Update and clarifications (addresses PR#2933).

merge in 1.2 branch

branches: 1.2.6;
Start documenting 1.1 installation.

first cut

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

branches: 1.15.32; 1.15.40; 1.15.42;
clean up whitespace and formatting

branches: 1.14.2;
netboot changes

Fix "NetBSD/sparc" to .Nx*M.

C&P info about sysinst moving to /emul/aout from i386 notes.

Major overhaul. Cleaned up a lot of explanations, clarified instructions,
provided more detail when necessary and removed extraneous instructions.

hardware: totally revamped to be more readable and include all known
supported hardware, now matches htdocs/Ports/sparc/hardware.html

install: new section on CD-ROM, netboot has instructions on setting up a
NetBSD server, removed disklabel instructions (miniroot/sysboot's
instructions are clear enough and have error-checking anyways)

prep: reorganized, put in cleaner explanation of SCSI target remapping on
OpenBOOT PROM 1 machines, put in instructions on how to figure out names
ROM uses for SCSI device, put in info about 100BaseTX network cards

upgrade: now points to ../common/upgrade

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.6;
fixed reference to NetBSD version

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

RCS Id Police.

RELEASE => _VER

branches: 1.5.2;
merge in 1.2 branch

update a bit for 1.2

branches: 1.3.4;
Update for release 1.1

branches: 1.2.2;
better and brighter

first cut

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.20.2; 1.20.6; 1.20.8;
- Increment to "eight major release"
- hyperSPARC SMP supported
- XFree86 4.4.0

branches: 1.19.2;
More JavaStation setup instructions.
XXX - someone please demangle the common/netboot maze and fix the markup ;-)

spelling nit -- AFAICT, it's officially "hyperSPARC" not HyperSPARC

mention improvements in PCMCIA support

note SMP & xfree4 update.

pk posted that a longstanding MMU problem with sun4c systems has been
fixed. Benefits primarily stability and SS1, SS1+, and IPC system speed.

update MD "whatis" to closer to what 1.6 provides

branches: 1.13.2;
Mention support for sun4/400 machines.

- 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.10.10;
add boot floppy stuff. 1.3 is the fourth netbsd/sparc release

Markup for -mdoc and -mdoc2html.

RCS Id Police.

RELEASE => _VER

branches: 1.6.2;
merge in 1.2 branch

do md_install_sets.

update a bit for 1.2

branches: 1.3.4;
Merge changes from 1.1 branch.

Update for release 1.1

branches: 1.1.2;
first cut

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

RCS Id Police.

merge in 1.2 branch

branches: 1.3.4;
Update from 1-1 branch.

Update to match install script.

branches: 1.1.2;
first cut