fix link to pkgsrc.tar.gz file in postinstall section.

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

branches: 1.88.2;
Improve instructions for getting you a pkgsrc.
Use awge on evbarm.

replace KDE with a desktop that's actually current in pkgsrc

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.83.2;
Remove leftovers from the separate xen port (which is now part of i386
and amd64)

branches: 1.82.2; 1.82.4;
Remove port-acorn26

OK core@

branches: 1.81.8;
- 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.79.2;
NetBSD.org police.

branches: 1.78.2;
Rename NetBSD/hp700 to NetBSD/hppa.

Unfortunately our VCS isn't very helpful here.

Prefer dhcpcd(8) over dhclient(8).

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

This could use more love!

Most contents in ftp://ftp.NetBSD.org/pub/NetBSD/packages/ seem removed
recently (do we have any announcment?) so update pakcages URLs and
descriptions accordingly.

branches: 1.74.6; 1.74.8;
Final round of INSTALL cleanups for 5.0.

Another round of INSTALL improvements big and small.

branches: 1.72.2;
Various updates to the install notes.

branches: 1.71.2;
Use a 192.0.2.0/24 address in example per RFC 3330. Suggested by tron@.

- use appropriate IFnames for each port
- use le0 as the default IFname for our favorite but orphaned antique ports,
rather than modern but obsolete de0
- use a private IP address in example

Add a note about a version mismatch warning of pkg_add(1) command.

Update URLs for packages PKG_PATH from obsolete one:
ftp://ftp.NetBSD.org/pub/NetBSD/packages/{VERSION}/{MACHINE}/All
to newer one:
ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/{MACHINE}/{VERSION}/All
which is documented in the pkgsrc guide, and also note the alternative path:
/pub/NetBSD/packages/current-packages/NetBSD/{MACHINE}/{VERSION}/All
for mirrors which don't mirror /pub/pkgsrc but have only /pub/NetBSD.

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

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

branches: 1.65.2; 1.65.6; 1.65.8;
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.

- fix some URLs
- setup postfix, not sendmail

branches: 1.63.4; 1.63.8;
merge rev. 1.58.2.2 - fix ".end-preformat" problem.

branches: 1.62.2; 1.62.4;
* Clarify that the xfont set is only needed by the X server
* simplify commands to extracts sets & pkgsrc
* add spaces around \(em - why this isn't rendered as — is far
beyond me, can someone with *roff fu have a look?

Inspired by posting by James K. Lowden on netbsd-docs.

XXX the hardware list needs real work. :(

Mozilla -> Firefox

Fix some URLs. From OKANO Takayoshi in PR 33001.

Packages.txt has been obsoleted, point to doc/pkgsrc.txt.
Whitespace and casing nit fixes.

branches: 1.58.2;
* mention DHCP
* Add vipw(8) and pwd_mkdb(8) as alternatives for editing /etc/passwd
* give a few more pkg_add examples (kde, mozilla, bash)
* Recommend Packages.txt and README as pkgsrc documentation
* Mention postfix and /etc/mailer.conf

Todo:
* what's the place for a pkgsrc-stable.tar.gz snapshot for 2.0?

formatting nit

Add sparc64 tags

Add NetBSD/xen documentation.

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

add hp700 tags and text

macppc uses tlp0 and gem0 by default now instead of de0 and gm0 for
on-board ethernet

netbsd.org->NetBSD.org

Text on pkg_add assumes sh(1). This fix adds text describing how to
set environment under csh(1) as well.

Closes PR install/14797.

The pkg_add examples assume sh(1). Adding text to mention csh(1) syntax.
Closes PR install/14797.

Fix usage of -mdoc that wiz pointed out to me.

Added a little verbiage describing that root logins from the network
are not enabled by default even via ssh(1). Thanks to Thomas
Klausner for some rewording of this.

Addresses PR: install/18456

be consistent and use \n[XXX] instead of rXXX

Fix remaining uses of ".if r_xxxx", when we really want ".if rxxxx", or
even better ".if \n[xxxx]".

Fix link to hp300 FAQ on X11

- define "termtype" string (based on \n[MACHINE] and use appropriately)
- consistently use \n[MACHINE] instead of r_MACHINE

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

simplify some sections, and improve .ie ... .el .ie stuff

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.

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

Document how to make savecore work with netbsd{,.aout}

More fixes and information for the CATS install documentation.

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

Add an item about the /etc/ttys file on the atari.

branches: 1.33.2;
next68k example ifconfig uses correct device name (xe)
also, excise mention of X windows for next68k
point to hp300 FAQ regarding X

Purge mentions of NetBSD/arm32.

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)

split the PKG_PATH example to two lines (variable set and export) to avoid
too long line in .more or .txt version of the INSTALL document
remove the pkg_add example for cvs - it's part of base system now

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

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

Workaround for misc/12593; use -Bd -unfilled instead of -Bd literal
when .IC is inside.

oops: .(bullet implies the initial .It

Update copyright date.
.Ic sysinst
Periods at ends of sentences.
X window system -> X Window System
cleanup PKG_PATH markup

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

two nits

use
(cd /foo ; tar zxpf -) < bar.tar.gz
instead of
tar -C /foo -zxpf bar.tar.gz
since the `pax as tar' on the install media doesn't have a working -C...

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)

Add an arm32 specific note that DNARD users will need to change their
console type to pc3.

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

'ex' is not in the root filesystem if /usr is a separate partition.

use new macros from ../common/macros

- use "press" instead of "hit"
- suggest looking in /etc/defaults/rc.conf or rc.conf(5) for rc.conf settings
- spell "separate" correctly
- use "third party" instead of "3rd party"
- move notes about /etc/localtime; sysinst does it for us
- update copyright date

We have useradd(8) now, no more need to bother people with vipw and
the adduser manpage.

branches: 1.9.4;
update wording for sendmail upgrade issues.

change sendmail.cf path in "postinstall".
sync "main" with reality. rc.d/sendmail will die if there's /etc/sendmail.

Clarify that /usr/pkgsrc is not the One True Location, but merely
an accepted-by-convention default, per agc.

Clarify exactly where pkgsrc.tar.gz should be extracted.
Fixes install/9580 (INSTALL is vague about pkgsrc installation location)

note that the installation software (sysinst) may have already set
rc_configured to YES in /etc/rc.conf, and that the drop to
singleuser mode may not happen.
remove special mentioning of 1.4.

Mention you usually do not need to enter terminal type on login

Fix a type (propperly -> properly), plus expand section on pkgsrc

branches: 1.2.4;
Change terminal type and ifconfig interface for pmax.
Mention some new files that have appears in NetBSD 1.4.
Make i386 and arm32 X configuration conditional on those archs.
Remove pmax X11R5 discussion - uses X11R6 now.

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