share/man/man7/Makefile: Hook stack.7

share/man/man7/Makefile: Split MAN on separate lines, and sort.

Makes sorting and merging changes easier.

No functional change intended.

Preparing for a new stack(7) in the service of PR pkg/57708.

XXX pullup-10

c.7: mention that C11 and C17 have been published

branches: 1.36.6;
Various entropy integration improvements.

- New /etc/security check for entropy in daily security report.

- New /etc/rc.d/entropy script runs (after random_seed and rndctl) to
check for entropy at boot -- in rc.conf, you can:

. set `entropy=check' to halt multiuser boot and enter single-user
mode if not enough entropy

. set `entropy=wait' to make multiuser boot wait until enough entropy

Default is to always boot without waiting -- and rely on other
channels like security report to alert the operator if there's a
problem.

- New man page entropy(7) discussing the higher-level concepts and
system integration with cross-references.

- New paragraph in afterboot(8) about entropy citing entropy(7) for
more details.

This change addresses many of the issues discussed in security/55659.
This is a first draft; happy to take improvements to the man pages and
scripted messages to improve clarity.

I considered changing motd to include an entropy warning with a
reference to the entropy(7) man page, but it's a little trickier:
- Not sure it's appropriate for all users to see at login rather than
users who have power to affect the entropy estimate (maybe it is,
just haven't decided).
- We only have a mechanism for changing once at boot; the message would
remain until next boot even if an operator adds enough entropy.
- The mechanism isn't really conducive to making a message appear
conditionally from boot to boot.

kernel_sanitizers.7

Draft man pages for the standard users and groups.

These are currently listed in order of uid because I went through
src/etc/group and src/etc/master.passwd line by line, and sorting any
other way after the fact -- like lexicographically, how it should be
-- was kinda inconvenient.

Feel free to sort, add information, add historical references,
correct any mistakes, &c., so that these remain living documents
describing NetBSD's standard users and groups and practices around
them.

branches: 1.33.2;
Move the audio specification to section 9 under audio_system.

Ok wiz@

Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."

branches: 1.31.8; 1.31.14;
Add missing src(7) reported by Patrick Welche.

branches: 1.30.4;
Remove tests.7 in objdir before copying to it.

If one's source tree has non-writable files (because of CVSREAD=t, or
someone else owns it, or it's on some read-only filesystems, some
other reason), recently-added makefile code would cp tests.foo.7 in
the sources to tests.7 in objdir, preserving permissions, but not
forcing the copy. A subsequent copy would result in an error, failing
the build. Therefore, rm -f the target file before doing the copy.

(Arguably there should some standard support for this, but copying
files from the source directory to objdir is quite unusual.)

Provide Kyua instructions in tests(7) when MKKYUA!=no.

I was first going to do this by doing automatic replacements of special
macros within the tests.7 file, but that turned out to be too complex
and confusing.

Instead, just rename the previous tests.7 to tests.atf.7 and add a new
tests.kyua.7 file. Choose which one to install as tests(7) depending on
the MKKYUA knob.

branches: 1.28.2; 1.28.8;
add new rfc6056.7, from vlad

Move security(8) to the section 7. Discussed on source-changes a while back.
Should address PR # 35718 at least partially.

By majority vote, move module(4) to the section 7.

Add glob(7).

From OpenBSD. Written by Todd C. Miller.

Add c(7).

Pillaged from FreeBSD. Written by Gabor Kovesdan.

Add orders(7) as a miscellaneous manual page.

Add the tests(7) manual page, which describes why and how to run the
test suite and how to configure it.

Add simple pkgsrc(7) man page linking to pkg_add, pkg_delete, pkg_info
and the pkgsrc guide. Requested by Alan Barrett.

packages(7) has (finally!) completely been integrated in the pkgsrc guide,
remove it.

Move the description of sysctl MIBs from sysctl.3 to a new manual page
sysctl.7. Remove the list of MIBs from sysctl.8 so we don't have to
maintain duplicate information, as proposed by YAMAMOTO Takashi on
tech-userlevel. Also remove references to header files from sysctl.8.

The numeric constants remain documented, they are still needed in some
cases. See the discussion on tech-userlevel. ("mib list in sysctl.8")

OK by YAMAMOTO Takashi.

PR/32641: David Maxwell: No 'pkgsrc' manpage

Link pkgsrc(7) -> packages(7).

add script.7

Add the sticky file in the proper section and add a history section for it
explaining what sticky means and meant on plain files.

Do not install mdoc.7 -- we use mdoc.7 from the groff distribution now.

Add setuid(7), from Henry Spencer, converted to mdoc by me.
XXX: Improvements are welcome, in parts a bit out of date.

Some NLS discussion.

Make mandoc point to mdoc.

Add signal(7) manpage, with list of signals available under NetBSD.
For now, it includes just the list with basic information about
each signal, some more general signal-related staff might be
added in the future.

Thanks to Soren S. Jorvang <soren@NetBSD.org> for his help.

Move symlink.7 to share/man/man7/, where it belongs

branches: 1.9.4;
add a packages(7) man page, cobbled from bsd.pkg.mk

Add a document describing the layout of a NetBSD release.

branches: 1.7.2;
Use bsd.man.mk and bsd.subdir.mk as appropriate.

specify man pages the new way.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

Once more, don't make `all' depend on man page; bsd.prog.mk does this.

term manpage is missing

branches: 1.1.1;
Initial revision

Sync with FreeBSD which capitalizes the control character names, and adds
a binary set.
Add a table with the full names for the control character set.

Document standards and correct history.
via Free / OpenBSD.

branches: 1.13.4; 1.13.6;
Remove Tn.

Revert previous changes due to popular demand. Instead, add a note at
the bottom of each document to provide the original ASCII characters'
names.

While here, also update 014 - it's name is "ff" ("form feed"), and not
"np" ("new page").

Bump date for previous

Since this is describing the ASCII character set, use the correct
ASCII abbreviation for character 012. All references I can find
which seem to be even remotely authoritative and/or definitive use
"lf" (for "line feed") rather than "nl" (for "new line").

See https://www.ascii-code.com and https://en.wikipedia.org/wiki/ASCII

From Eitan Adler in PR misc/52989

Remove workaround for ancient HTML generation code.

branches: 1.7.90;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Boring whitespace fixes.

Fix .Nm usage.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Move the audio specification to section 9 under audio_system.

Ok wiz@

Mark up argument. Fix typo.

Using audioctl without the -p switch defaults to the mix ring. This allows
setting the hardware gain etc.

Update the audio spec in audio.7 to reflect these changes.

Addresses PR kern/52781.

branches: 1.2.2; 1.2.4;
Various improvements, more markup, typo fixes.

Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."

c.7: mention that C11 and C17 have been published

Merge riastradh-drm2 to HEAD.

Use Mt for email addresses.

branches: 1.12.4; 1.12.10; 1.12.14;
Xref cdefs(3).

Use .Va __func__ and .Vt restrict

There is no harm to add a manual page for the GNU typeof()-construct, given
that it has already crawled into the source tree.

Note __func__ and restrict.

Mention attribute(3) in passing.

Prompted by dholland@; add the C99 TCORs.

Various (mostly wording) improvements. Sort SEE ALSO.

Reference stdbool(3), stdint(3), and inttypes(3). Use .Vt.

typo

Minor grammar patrol.

XXX: if this is going to mention the c89 TC's, it should really
XXX: mention the c99 TC's too.

Fix botched CVS identifier.

Add c(7).

Pillaged from FreeBSD. Written by Gabor Kovesdan.

entropy.7: add a missing word to a sentence

While here, bump the date to reflect when substantive changes were last
made.

entropy(9): Reintroduce netbsd<=9 time-delta estimator for unblocking.

The system will (in a subsequent change) by default block for this
condition before almost all of userland is running (including
/etc/rc.d/sshd key generation). That way, a never-blocking
getentropy(3) API will never return any data without at least
best-effort entropy like netbsd<=9 did to applications except in
single-user mode (where you have to be careful about everything
anyway) or in the few processes that run before a seed can even be
loaded (where blocking indefinitely, e.g. when generating a stack
protector cookie in libc, could pose a severe availability problem
that can't be configured away, but where the security impact is low).

However, (in another subsequent change) we will continue to use
_only_ HWRNG driver estimates and seed estimates, and _not_
time-delta estimator, for _warning_ about security in motd, daily
security report, etc. And if HWRNG/seed provides enough entropy
before time-delta estimator does, that will unblock /dev/random too.

The result is:

- Machines with HWRNG or seed won't warn about entropy and will
essentially never block -- even on first boot without a seed, it
will take only as long as the fastest HWRNG to unblock.

- Machines with neither HWRNG nor seed:
. will warn about entropy, giving feedback about security;
and
. will avoid returning anything more predictable than netbsd<=9;
but
. won't block (much) longer than netbsd<=9 would (and won't block
again after blocking once, except with kern.entropy.depletion=1 for
testing).

(The threshold for unblocking is now somewhat higher than before:
512 samples that pass the time-delta estimator, rather than 80 as
it used to be.)

And, of course, adding a seed (or HWRNG) will prevent both warnings
and blocking.

The mechanism is:

1. /dev/random will block until _either_

(a) enough bits of entropy (256) from reliable sources have been
added to the pool, _or_

(b) enough samples have been added from any sources (512), passing
the old time-delta entropy estimator, that the possible
security benefit doesn't justify holding up availability any
longer (`best effort'), except on systems with higher security
requirements like securelevel=2 which can disable non-HWRNG,
non-seed sources with rndctl_flags in rc.conf(5).

2. dmesg will report `entropy: ready' when 1(a) is satisfied, but if
1(b) is satisfied first, it will report `entropy: best effort', so
the concise log messages will reflect the timing and whether in
any period of time any of the system might be relying on best
effort entropy.

3. The sysctl knob kern.entropy.needed (and the ioctl RNDGETPOOLSTAT
variable rndpoolstat_t::added) still reflects the number of bits
of entropy from reliable sources, so we can still use this to
suggest regenerating ssh keys.

This matters on platforms that can only be reached, after flashing
an installation image, by sshing in over a (private) network, like
small network appliances or remote virtual machines without
(interactive) serial consoles. If we blocked indefinitely at boot
when generating ssh keys, such platforms would be unusable. This
way, platforms are usable, but operators can still be advised at
login time to regenerate keys as soon as they can actually load
entropy onto the system, e.g. with rndctl(8) on a seed file copied
from a local machine over the (private) network.

4. On machines without HWRNG, using a seed file still suppresses
warnings for users who need more confident security. But it is no
longer necessary for availability.

This is a compromise between availability and security:

- The security mechanism of blocking indefinitely on machines without
HWRNG hurts availability too much, as painful experience over the
multiple years since I made the mistake of introducing it have
shown. (Sorry!)

- The other main alternative, not having a blocking path at all (as I
pushed for, and as OpenBSD has done for a long time) could
potentially reduce security vs netbsd<=9, and would run against the
expectations set by many popular operating systems to the severe
detriment of public perception of NetBSD security.

Even though we can't _confidently_ assess enough entropy from, e.g.,
sampling interrupt timings, this is the traditional behaviour that
most operating systems provide -- and the result here is a net
nondecrease in security over netbsd<=9, because all paths from the
entropy pool to userland now have at least as high a standard before
returning data as they did in netbsd<=9.

PR kern/55641
PR pkg/55847
PR kern/57185
https://mail-index.netbsd.org/current-users/2020/09/02/msg039470.html
https://mail-index.netbsd.org/current-users/2020/11/21/msg039931.html
https://mail-index.netbsd.org/current-users/2020/12/05/msg040019.html

XXX pullup-10

entropy(7): don't use .Nx inside .Ss

These macros don't adapt to context style, so in PostScript output the
.Nx inside .Ss is suddenly in a different font.

entropy(7): use .Ql instead of .Sc Li

entropy(7): don't try to cram things into one-liners

entropy(7): Omit needless offset for diagnostic listing.

branches: 1.4.2;
entropy(9): Improve entropy warning messages and documentation.

- For the main warning message, use less jargon, say `security', and
cite the entropy(7) man page for further reading. Document this in
rnd(4) and entropy(7).

- For the debug-only warning message, say `entropy' only once and omit
it from the rnd(4) man page -- it's not very important unless you're
debugging the kernel in which case you probably know what you're
doing enough to not need the text explained in the man page.

Clarify that `entropy' may be left unset in rc.conf.

entropy(7): Add missing URL to reference.

Various entropy integration improvements.

- New /etc/security check for entropy in daily security report.

- New /etc/rc.d/entropy script runs (after random_seed and rndctl) to
check for entropy at boot -- in rc.conf, you can:

. set `entropy=check' to halt multiuser boot and enter single-user
mode if not enough entropy

. set `entropy=wait' to make multiuser boot wait until enough entropy

Default is to always boot without waiting -- and rely on other
channels like security report to alert the operator if there's a
problem.

- New man page entropy(7) discussing the higher-level concepts and
system integration with cross-references.

- New paragraph in afterboot(8) about entropy citing entropy(7) for
more details.

This change addresses many of the issues discussed in security/55659.
This is a first draft; happy to take improvements to the man pages and
scripted messages to improve clarity.

I considered changing motd to include an entropy warning with a
reference to the entropy(7) man page, but it's a little trickier:
- Not sure it's appropriate for all users to see at login rather than
users who have power to affect the entropy estimate (maybe it is,
just haven't decided).
- We only have a mechanism for changing once at boot; the message would
remain until next boot even if an operator adds enough entropy.
- The mechanism isn't really conducive to making a message appear
conditionally from boot to boot.

Document EDITRC

branches: 1.26.4;
Change reference from malloc(3) to jemalloc(3) as the MALLOC_OPTIONS variable
is actually described in jemalloc(3).

branches: 1.25.26; 1.25.30;
Add comma in enumeration.

Describe the new terminfo environment settings.

branches: 1.23.2;
Sprinkle some markup.

Use .In instead of .Aq Pa for header files.

Document LOGNAME; from Pavel Cahyna in PR misc/30671.

branches: 1.20.4; 1.20.6;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Remove empty line, and use Aq instead of \*[Lt]\*[Gt].

add nls(7) environment variables

* Document $RCMD_CMD in environ(7).
* Cross-reference rcmd(1), rcmd(3), and environ(7) as appropriate.

Should fix [bin/21670] from Geoff Wing.

Bump date.

document PAGER

Comment out Xref to plot(1), which we don't have.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Whitespace fix.

Added TIMEFORMAT entry.

add LIBC_DIAGASSERT and MALLOC_OPTIONS

- Use .Dq instead of hardcoding double quote.
- Sync the value of default PATH environment variable with _DEF_PATH
defined in paths.h.

Mention those environment variables related to audio; suggested by Perry.

branches: 1.7.2;
First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

fix .Xr references

/etc/termcap -> /usr/share/misc/termcap. Fixes misc/1401.

fix default path

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Update glob example from X11R6 to X11R7

Be consistent in using (fixed width font) literals.

Fix PostScript formatting of the character classes table.

Add glob(7).

From OpenBSD. Written by Todd C. Miller.

branches: 1.8.2;
Add _dhcpcd entries.

Typo fix (remove extra TPM)

Fix .Dt to match installed section

Minor formatting tweaks.

Fix unedited pasto.

Minor fixes.

Fix Xr section numbers.

Draft man pages for the standard users and groups.

These are currently listed in order of uid because I went through
src/etc/group and src/etc/master.passwd line by line, and sorting any
other way after the fact -- like lexicographically, how it should be
-- was kinda inconvenient.

Feel free to sort, add information, add historical references,
correct any mistakes, &c., so that these remain living documents
describing NetBSD's standard users and groups and practices around
them.

add entry for /var/shm.

branches: 1.144.2;
hier(7): mention KERNEL_DIR in /stand section

branches: 1.143.2;
hier(7): remove reference to /var/db/pkg

The pkg database lives in ${PREFIX}/pkgdb instead now.

Bump date.

hier(7): Document /usr/share/certs/mozilla.

XXX pullup-10

hier(7): Document /etc/openssl.

branches: 1.140.6;
Remove a reference to /etc/netstart

It was removed in rc.d era and no longer honored (except by newbtconf(8)).

Noticed by Ottavio Caruso on #netbsd@Freenode, thanks!

remove mount_smbfs(8)/nsmb(4) references

Fix markup typo.

Add some more licenses appearing in external.
Remove mentions of src/gnu that no longer exists.
Mention /usr/pkg/etc.
Bump date

Remove compat_osf1, discussed on tech-kern@.

Retire compat_ibcs2, as discussed on tech-kern@. FreeBSD did the same
recently.

Remove compat_svr4 and compat_svr4_32, as discussed on tech-kern@ recently,
but also as discussed several times in the past.

more netkey->netipsec

Replace netkey/ -> netipsec/, everything was moved into netipsec/.

Remove the network ATM code.

Retire ipkdb entirely. The option was removed from the config files
yesterday.

ok kamil christos

branches: 1.129.2; 1.129.4;
remove reference to /usr/X11R6

Remove port-acorn26

OK core@

Use Pa for paths.

Remove superfluous Pp.

Stop using Tn.

Merge autofs support from: Tomohiro Kusumi
XXX: Does not work yet

Remove workaround for ancient HTML generation code.

branches: 1.122.6;
Put some text in pursuant to the rest of PR 48471, about /stand.

File system police.

More stuff spotted by jnemeth: fix wording for /var/mail, and document
utmpx/wtmpx. While here also document dmesg.boot.

Document /etc/login.conf, /etc/profile, /etc/ttyaction.

More important fix: there is an /etc/skel but no /usr/share/skel.

More improvements from jnemeth

Another typo.

another typo; spotted by jnemeth

typo in previous.

Harmfully sentence fragments. Use sentences instead.

I've also made some additional minor edits, and added missing
/usr/src/sys/ufs/{chfs,ext2fs}.

We don't use mfs for /tmp by default, so the man page shouldn't
suggest this is the typical case.

Because there's so little content in this entry, eliminate the
parentheses around the explanation that /tmp is usually not preserved
across reboots.

Fix description of /home

From Vadim Ushakov in PR 50938.

Lua 5.1 -> Lua 5.3
From Kamil Rytarowski.

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

Bump date for previous.

Note the existence of /libdata. PR 48471 from David H. Gutteridge,
with a couple minor adjustments.

PR/48199 - David H. Gutteridge -- remove some vestiges left over from UUCP removal

Fix sendmail section (8 -> 1) in xrefs.

Fix dates.

Retire OSI network stack. OK core@

branches: 1.101.2;
Switch terminfo(3) to cdb(5).

Add capfile(5) to describe the termcap format.
Adjust various man pages and other documentation to point to capfile(5)
instead of termcap(5).
Remove getcap(3) as curses hasn't been building it for a long time.
Punt wrterm.c as tset no longer uses it.

branches: 1.99.4; 1.99.6;
Remove PECOFF/Win32 emulation.

Remove references to UUCP.

Xref paths(3).

Bump for emips.

plop new emips port into various places it should be plopped in to

A place for Lua 5.1 modules.

branches: 1.93.2;
Fix section, atf(1) -> atf(7).

Nit-picks.

reflect current reality.

Remove the portalfs kernel file system driver. Replace mount_portal(8)
with a version based on puffs. User functionality remains the same.

Remove support for NetBSD/playstation2.

mention both X11R6 and X11R7
requested by mrg@ on source-changes-d

X11R6 -> X11R7
ok wiz@

Point to pkg_add(1) instead of non-existing pkg_install(1).

Remove physical markup.

branches: 1.84.2;
Also add cdrom (which is created by sysinst).

And add trailing slash to pts directory (just added a moment ago).

Add pts, kern, proc mount points.
These are created by sysinst.
(I don't see in mtree spec files either.)

Remove LKMs and switch to the module framework, pass 1.

Proposed on tech-kern@.

Document src/external.
Per discussion with core.

branches: 1.80.4; 1.80.6; 1.80.8;
Remove support for NetBSD/pc532.

Remove some old sh5 references.

Add the tests.tgz set

This adds a new tests.tgz set to releases which includes all the tests
for the system. It is important to note that this set does not rely on
comp.tgz: a user of the system can run the tests without having the
development tools installed, which can be useful in a production machine.

Add the libatf library

This adds reachover Makefiles to build the libatf library and enables it in
the parent Makefile.

Things to review in this change:

* Add proper version numbers in the shlib_version files.

* Is libatf properly listed in lib/Makefile? It theoretically needs
libstdc++, but the resulting binary library is not linked against it.

Fix a few more misc. pmppc references

branches: 1.75.4;
Bump date for previous.

XXX: this needs updating for the sendmail and uucp removals.

Update to include the new Zaurus port as per new-port checklist.

Remove references to netccitt and netns directories. Bump date.

Remove /usr/include/netns reference. Bump date.

Excise kerberosIV. Bump date.

Fix macro. Add /usr/src/common. Bump date.

- add ews4800mips
- add some missing dirs under sys/arch
(XXX openblocks405 and pdp10 are still missing)
- sync some descriptions with 3.0 announcement

XXX: any reason to keep sys/arch/openblocks405?

Add trailing slashes to some directories missing them.

Add src/sys/fs/ptyfs. Bump date.

note about /usr/share/{i18n,locale,nls}

hparm -> hpcarm.

Initial import of iyonix port.

The Iyonix is a desktop machine from Castle Technology, based on a 600MHz
XScale[tm] 80321 processor.

* Uses the bootloader from NetBSD/acorn32, which is now 32-bit compatible.
* Currently boots multiuser with a serial console.
* Device support is not yet complete.

With help from abs.

Comment out /amd and /dump, since they are not there in the
default install.

Gack! Bump date for last.

Sprinkle a couple of commas and update to reflect x86_64 being renamed to
amd64. Okayed by wiz.

Drop trailing space; use Nx instead of NetBSD.

Might as well put the default location for pkgsrc metadata files in
the right place - /var/db/pkg, not /var/pkg.

Over to you, wiz.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

add /etc/kerberosV

No dots after last SEE ALSO. Bump date.

more fixes suggested by Igor Sobrado in PR misc/19609
also a bunch of changes of my own.
also independant->independent
Also 4Kb->4KB (page sizes measured in bytes, not bits)

Uppercase MIPS. Igor Sobrado, PR 19678.

Uppercase ULTRIX, from Igor Sobrado in PR 19678.

document /usr/lkm
place /dev/fd and /dev/null into alphabetical order
alphabetize and individually document /etc/master.passwd, /etc/passwd,
/etc/pwd.db, /etc/spwd.db

Partial fix for PR misc/19609 by Igor Sobrado
XXX still need to do a bunch of this PR
XXX it would have been nice if there had been patches supplied.

Uppercase VAX. Igor Sobrado in PR 19678.

Add trailing slash to some directories that did not have them (to look like
others in the manpage).
Add missing /libexec/ directory.

Approved by wiz.

Remove /usr/local (and children) from the base distribution; we shouldn't
be creating directories or modifying permissions under there.

(/usr/local/* is still retained in various default PATHs, for convenience)

Remove /sys -> /usr/src/sys symlink.

Add evbppc, delete walnut.

Fix minor formatting bug. From Joerg Klemenz <joerg@gmx.net> in
misc/18428.

document /lib and /rescue. other minor tweaks

Add pmppc.

Move manual pages, man[48].arm26 -> man[48].acorn26.

Add entries for evbarm and evbmips.

Add entry for sbmips.

update sys/arch descriptions closer to reality:
* instead of saying "support for the" for every entry, say it once
* add:
+ algor
+ arm
+ cats
+ cesfic
+ hpcarm
+ sandpoint
+ shark
+ sun2
+ sun68k
+ walnut
+ x86_64
* remove:
+ arm32

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Typo in macro.

Add acorn32.

add playstation2 port.

NetBSD -> .Nx

/var/chroot

kerberos(8), not (1)

- add /dev/zero.
- remove sys/vm.

add dreamcast and hpcsh

minor update of /boot; from simonb

update to reality:
- add /boot, /etc/*.conf, /etc/defaults, various bits in /usr/src and /sys,
/var/cron, /var/heimdal, /var/pkg, /var/yp
- remove /etc/disklabels, /usr/src/domestic

Add mipsco port

Correct description of /etc/sliphome/; add a little more introductory
text describing the purpose of the manual page, all per PR 8980.

Add cobalt and sgimips.

branches: 1.25.2;
mention /etc/mail. PR 10273 from roskens@elfin.net.

branches: 1.24.2;
Add arm26 port

remove reference to pica, add a directory sys/arch/arc, pointed out by enami.

Remove duplicated ``bin'' entry under /usr.

Remove unnecessary comma at the end of line of SEE ALSO list.

add /usr/include/net{inet6,key}.

branches: 1.19.2;
Remove specific models numbers from the sys/arch/pmax description.

Remove a final reference to /usr/src/contrib, to allow us to polish off
PR5599 (from jwise@unicast.com).

fix .Xr references

Change occurrences of "UNIX" to .Ux or .At as appropriate.

Fix mdoc usage: NetBSD -> .Nx

Document pkg, pkgsrc & mk.conf, remove usr/contrib (per PR 5244 by E. Fair)

macroize BSD, NetBSD, FreeBSD and misc cleanup

get rid of secretmail residue -- suggested in pr-4568 from Carl Shapiro

xref atalk.4 now as we have it

branches: 1.10.2;
update to lite-2; also, update to NetBSD reality, and include our kernel source additions, per the changes in lite-2.

- remove: /usr/include/netimp/, /usr/include/pascal/ /usr/src/kerberosIV/
/usr/src/prgm/
- add: /usr/include/netatalk/ /usr/include/netccitt/ /usr/include/natm/
/usr/share/mk/bsd.README /usr/share/lkm/ /usr/share/nls/
/usr/share/sendmail/ /usr/src/distrib/ /usr/src/domestic/
- add x-ref of ftpd(8) to /var/spool/ftp

Add a blurb on /usr/mdec.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

branches: 1.6.2;
Fix description of /usr/share.

UUCP config files live in /etc/uucp, not /usr/lib/uucp.
This file needs a lot more work.

Add RCS indentifiers.

Fix up FILES sections.

Update file names.

branches: 1.1.1;
Initial revision

Replace references to resolver(5) with ones to resolv.conf(5).

From patch by Bug Hunting.

Fix whitespace nits. Suggested by Bug Hunting.

branches: 1.11.6;
Remove trailing whitespace; new sentence, new line; fix xref.

new from libbind

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Fix .Nm usage.

First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

macroize BSD, NetBSD, FreeBSD and misc cleanup

fix the the typos

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

reference resolv.conf(5) instead of resolver(5)

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

intro.7: add missing entries

Minor fixes.

Draft man pages for the standard users and groups.

These are currently listed in order of uid because I went through
src/etc/group and src/etc/master.passwd line by line, and sorting any
other way after the fact -- like lexicographically, how it should be
-- was kinda inconvenient.

Feel free to sort, add information, add historical references,
correct any mistakes, &c., so that these remain living documents
describing NetBSD's standard users and groups and practices around
them.

branches: 1.26.2;
Move the audio specification to section 9 under audio_system.

Ok wiz@

Remove Tn.

Update the introduction page to section 7 of the manual noting the audio
spec.

branches: 1.23.24; 1.23.30;
bump date

forgot the "7"...

Add reference to rfc6056.7

branches: 1.20.4;
Note also tests(7).

Move security(8) to the section 7. Discussed on source-changes a while back.
Should address PR # 35718 at least partially.

By majority vote, move module(4) to the section 7.

Update.

General update.

NetBSD -> .Nx.

update for script(7) man page
update date

Bump date for previous; use more macros.

mention sticky.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Fix typo.

Resync list with reality:
comment out nonexistant pages (eqnchar, man, me, ms, term)
add missing ones (hostname, mdoc, mdoc.samples, operator, release, signal,
symlink)

Fix .Nm usage.

First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

convert unknown .Ds/.De sequence into a normal list.

Add David Brownlee's new intro pages, with editing. (PR #534[23])
Also, while here, expand apparently incorrectly .Dd month abbreviations.
(I thought about doing this in tmac/doc-common...heh...that would have
allowed a possible reverse map back to abbreviations.)

macroize BSD, NetBSD, FreeBSD and misc cleanup

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Note arm KUBSAN support

fix inaccuracy about kmsan

Add support for KASAN on ARMv[67]

Thanks to maxv for many pointers and reviews.

fix file path

New sentence, new line. Fix macro arguments. Improve Nd.
Remove superfluous Pp. Other minor cleanups.

kernel_sanitizers.7

Remove dead references to sendmail(8).

Consistently use 'RFC 1234' instead of 'RFC1234' or 'RFC-1234'.
From jmc@openbsd.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

existance -> existence (PR 19655); start new sentences on new lines while here.

Drop superfluous .Pp's, punctuation fixes, improve citation.

Boring whitespace fixes.

Fix .Nm usage.

First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Update for the late '90s, largely by chopping out obsolete sections.

macroize BSD, NetBSD, FreeBSD and misc cleanup

alternate -> alternative, per PR 2643

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Build orphaned man pages.

branches: 1.29.56; 1.29.62;
Missing apostrophe. ("authors discretion" -> "author's discretion").

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Straight not strait

Document .In, based on the documentation in groff-1.18.1.
Noted missing by perry.

Add .Ft.
Remove Fortran only note from .Vt.
From a discussion with Thomas Klausner.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Sort two macros.

add sections to xrefs.

Comment out CONFIGURATION section which refers to a README file that is not
installed in the system (but is in our source repository), per PR 10992

Document LIBRARY and Lb.

- Document Bsx macro.
- Fx, Nx and Ox appear to be parsed and callable.

Correct errors in examples under "MANUAL AND GENERAL TEXT DOMAIN MACROS"

Document an ``EXIT STATUS'' section appropriate for section one and eight
commands and utilities.

Document Ox macro.

branches: 1.15.4;
List .Nd macro as manual domain macros.

branches: 1.14.4;
Document .Fl.

Improve .Ns description, document the barely-useful .Ap macro.

branches: 1.12.2;
Add -unfilled.

Correct error: .Fd is _not_ parsed and is _not_ callable.

The -width attribute for the standard -tag list (.Bl -tag -width EWOULDBLOCK)
is not really optional, and bizarre things will happen if it is left out.

Implement a new manual page category ``SECURITY CONSIDERATIONS''
(suggested by mycroft)

macroize BSD, NetBSD, FreeBSD and misc cleanup

.It is not parsed, so spell out Bx and Ux

document .Bl options -column, -dash, -hyphen

branches: 1.5.2;
fix some paste-os and other minor problems.

fix .Nx description

document Nx (NetBSD) macro

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

branches: 1.1.1;
Initial revision

Build orphaned man pages.

branches: 1.45.6; 1.45.12;
- Use .Li for head line in .Bl too.
- Do not use headers as example for .Aq, they should be marked up with
.In
- Drop the use of .Xo/.Xc
- Make sure to quote .Sh as argument to .Bl. groff warns about the list
otherwise and the size computation was off anyway as the string is
used as literal later.

Fix order in preamble.

Examples should be correct, so fix the order of the preamble to follow
the rules set in mdoc(7).

branches: 1.42.28; 1.42.30;
Change all .Xr config 8 to .Xr config 1, following the recent move of
config from usr.sbin -> usr.bin.

Reviewed by wiz.

Removed accidental repetitious words.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Document .In, based on the documentation in groff-1.18.1.
Noted missing by perry.

Note that Dd argument specifies last major change to man page.
Fixes PR 9705.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

New sentence, new line. Document it as policy.
[Compare the output of this man page before and after this change to see the
effects.]

Grammar fixes from jmc@prioris.mini.pw.edu via openbsd.

Fix some typos, partly from Igor Sobrado in PR 19656.

fix isolated collateral damage from <>& churn

Sync mentioned section headers with mdoc.template; update descriptions of
.Os and .Dt arguments to current practice; don't hardwire NetBSD version
name (was still at 1.4...).

Fixed Fo/Fc example, the one given did not format correctly when
used.

Lots of formatting fixes by John Franklin in misc/10078, and some of my own.

Document LIBRARY and Lb.

- Document Bsx and Ox macros.
- Add some missing TOC entries.

Mention section 9.

branches: 1.26.2;
Sort SEE ALSO list as described in this manual.

Fix for several typos supplied by Richard Rauch in PR misc/9145.

Fix typos, as noted by Christian Weisgerber in OpenBSD PR/1030.

fix typo

Fixed typos (from OpenBSD)

branches: 1.21.4;
Improve .Ns description, document the barely-useful .Ap macro.

There was no mention of .Bd -unfilled, the -ragged description was bogus,
(actually, it described -unfilled) and there are six displays, not five.

Instead of claiming that nested displays work, note that they are prohibited.
Adjust the note permitting list nesting to note that -enum lists can't be.

Since we are "NetBSD" and not "BSD Experimental", update the definition
of .Os to reflect reality.
Also document the new AT&T laziness macros.

The -width attribute for the standard -tag list (.Bl -tag -width EWOULDBLOCK)
is not really optional, and bizarre things will happen if it is left out.

note that .Dd directives should NOT have the date quoted

more section 9 changes, plus change UNIX to NetBSD in appropriate spots

change to reflect that we now have a section 9 of the manual

note that SEE ALSO is sorted on section number, then name within section

document .Bl -column, and the bug if the first .Bl doesn't have -width

fix .Nx usage (use 1.0 instead of 0.9a, etc), and other minor cleanups

correct template file name; from Marshall M. Midden <m4@umn.edu> in
OpenBSD PR 336.

branches: 1.9.2;
document `` .Nm "" , '' support

fix an internal cross reference to "extended arguments"

document Nx (NetBSD) macro

Add a missing quote ; closes pr misc/2832

Fix path to mdoc template; From Masanobu Saitoh in PR #2293

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

Fixed spelling error: mdoc.sample -> mdoc.samples
Added RCS Header.

branches: 1.1.1;
Initial revision

Imnprove previous.

Complete the example.

Revert probably unintentional case changes from previous.
Remove superfluous Tn.

Add a note that some external software is available only via loadable
modules due to licensing concerns.

Also add an additional example of how to build modules only, using
build.sh

Bump date for previous.

Tweaks from Michael McConville - thanks!

dependant -> dependent

Per private email (to myself and core@), cgd has agreed

I'm happy to assign all copyright to this file, ...

So replace original 4-clause cgd with a 2-clause NetBSD.

By majority vote, move module(4) to the section 7.

Use semantic markup.

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

branches: 1.13.10; 1.13.12;
Use more markup. Fix a typo. Bump date for previous.

Use correct terminology for UTF.

More fixes.

.Bl ... -indent -> .Bl ... -offset indent.

New sentence, new line; fix xrefs; sort SEE ALSO; punctuation nits;
uppercase beginning of sentence; bump date for last two.

Xr xfd(1)

More on fonts. ISO C support.

New sentence, new line.

Bump date for last. Drop trailing whitespace.

Consistently use 'Native Language Support' for NLS. From Jeremy C. Reed.
Also, add table of ISO639 language codes.

Remove confusing examples.

New sentence, new line; use .Ev to mark up environment variables;
use .Dq for double-quoted words; drop trailing white space.

Some NLS discussion.

Remove workaround for ancient HTML generation code.

branches: 1.11.38;
Bring over improvements from FreeBSD.

List all of the assignment operators explicitly, for those who have
been traumatized by perl.

Add C++ operators (from Christoph Mallon <christoph.mallon@gmx.de>)

Markup improvements to make PostScript output pretty.

Bring back FILES section now that /usr/share/misc/operator is
resurrected.

Remove /usr/share/misc/operator.

Sort sections

Xref iso646(3).

Don't use an indented display with a single list in it.
When using two columns, declare them indepently.

branches: 1.6.42;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

s,order of evaluation,associativity, they aren't the same thing

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Extend orders(7) with prefixes from Resolution 3 of the 27th meeting of CGPM.

Note also common bit rates.

Fix small format error. Noted by pgoyette@.

Reference strsuftoll(3) and orders(7) with each other.

Sort SECTIONS, fix xref.

Xref number(1) and units(1).

Add orders(7) as a miscellaneous manual page.

packages(7) has (finally!) completely been integrated in the pkgsrc guide,
remove it.

Undocument internal MTREE_FILE variable.

Undocument unsupported FORCE_PKG_REGISTER.

Undocument removed NO_DEPENDS.

Undocument obsolete NO_PKG_REGISTER. Bump date.

Remove SCRIPTDIR description, update SCRIPTS_ENV description. Bump date.

Remove some more stuff that is (now) documented
in the pkgsrc guide.

Remove another paragraph that is already in the pkgsrc guide.

Remove some variables that are described in the pkgsrc guide.

Mention that this man page is obsolete and will die.

Remove duplicate MAKE_ENV description. From YOMURA Masanori in private mail.

Remove another outdated variable.

Remove COMMON VARIABLES section, moved to guide.

Adjust to The Not-Quite-That-New World Order:

bsd.pkg.defaults.mk -> defaults/mk.conf
Packages.txt -> doc/pkgsrc.txt

ALL_TARGET is now called BUILD_TARGET.
XXX: this file should be merged to the pkgsrc guide and removed.
Any takers?

New sentence, new line. Some other minor changes.

Document new RECOMMENDED and IGNORE_RECOMMENDED variables.

Use more markup and bump date for previous.

Document the PKGMAKECONF variable.

Bump date for previous; Pa is markup for paths, 0/1/2 do not need
markup (or perhaps use a Bl/El list?).

Document PKG_DEBUG_LEVEL and its possible values, as requested in PR 22200

netbsd.org->NetBSD.org

Remove superfluous macro.

Drop trailing whitespace. Reviewed by wiz.

More e.g. cleanup. Igor Sobrado, PR 19692.

... and bump date.

Add information about the "replace" target. This closes my own PR pkg/18014.
Okay'ed by wiz.

Remove documentation of obsolete variables EXTRACT_BEFORE_ARGS and
EXTRACT_AFTER_ARGS.

Fix some typos, partly from Igor Sobrado in PR 19656.

Fix some nits around BINPKG_SITE(S)
PR pkg/19005 by tv@pobox.com

Fix typo. Spotted by Adrian Mrva.

"pairs of other package this package depends" ->
"pairs of other packages this package depends upon"

Deprecate IS_INTERACTIVE, and explain INTERACTIVE_STAGE

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Edit -mdoc usage.

* There is no -indent option to .Bd or .Bl, although you would
never know that from its frequent use in this tree. There is a
"-offset indent" combination that makes sense, and you can certainly
say "-width indent".

* Also, you can't markup the -width option argument, tho you CAN
use a callable macro. So "-width Ar filename" doesn't make sense,
but either "-width Ar" or "-width filename" does, as might something
like "-width xxfilename" for a little extra space.

* There are a lot of needlessly complex hanging tag macros in man4 used
to create simple item lists. Those should be simplified one of these
days before someone copies and edits yet another man4 page.

Udpate documentation of "UNLIMIT_RESOURCES" for new format.

Markup improvements.

Add documentation for "UNLIMIT_RESOURCES".

grammar/spelling fixes

Refer bsd.pkg.defaults.mk instead of mk.conf.examples. Reported in
pkg/14899 by Jonathan Perkin.

Get rid of manually adding "nbX" to PKGNAME when a pkg was changed in
pkgsrc. Instead, a new variable PKGREVISION is invented that can get
bumped independent of DISTNAME and PKGNAME.

Example #1:
DISTNAME= foo-X.Y
PKGREVISION= Z
=> PKGNAME= foo-X.YnbZ

Example #2:
DISTNAME= barthing-X.Y
PKGNAME= bar-X.Y
PKGREVISION= Z
=> PKGNAME= bar=X.YnbZ (!)

On subsequent changes, only PKGREVISION needs to be bumped, no more risk
of getting DISTNAME changed accidentally.

Make comment about scripts/* go the same place as the scripts/* code: /dev/null

Document the new Motif-related variables. Deprecate USE_MOTIF in favor of
including motif.buildlink.mk, which contains more sophisticated and
complete logic for detecting the various Motif options that may be
installed. Though deprecated, USE_MOTIF is still recognized, though it
does no more than include motif.buildlink.mk.

Drop superfluous .Pp, punctuation fix.

Deprecate NO_WRKSUBDIR, replacing it with an explicit assignment of:

WRKSRC= ${WRKDIR}

This is much cleaner, much more indicative of what happens, and removes
another of the negative definitions (NO_.* = value).

Fix date.

* When applying patches, also look in $LOCALPATCHES/$PKGPATH for
any local patches that the user wants to maintain outside of
pkgsrc.
* print-PLIST: ignore Linux procfs entries

Explain that PKGSRCDIR is an internal definition and should not be set
by the user.

Mention REPLACE_PERL

Takes a list of files and replaces each occurence of "/usr/bin/perl", "/usr/local/bin/perl"
and "/usr/pkg/bin/perl" in the named files with the value of ${PERL5}.
This can be used to point perl scripts to the proper interpreter that pkgsrc installs.
Note: it looks for the listed files in ${WRKSRC}.

Fix date, one xref, and some whitespace.

add some variables related to bin-install

Add description of "PERL5_REQD".

Flesh out the description for MAINTAINER. Addresses pkg/11573.

Remove description for NO_DESCRIBE.

Remove documentation for NO_EXTRACT.

Note COMMENT variable.

Document MESSAGE_SUBST, and PLIST_SUBST, and generally update the
document for some changes in the last months (or even earlier).

Document OSVERSION_SPECIFIC.

Document SVR4_PKGNAME.

typo (fix it)

Reported by Tetsuya Isaki in misc/11988

Update the documentation to reflect the deletion of NO_WRKDIR

* Remove documentation of NOCLEANDEPENDS (it's set by default, and there
is no need to change things on that area)
* Document MAKEFILE, per PR 11866 by Richard Tibbetts <tibbetts@mit.edu>

Note new UPDATE_TARGET

Explain USE_MESA/USE_GLX

Xref pkgsrc/Packages.txt

Document CHECK_SHLIBS

Document "USE_XAW" and "USE_XPM".

MIRROR_DISTFILES and NO_CDROM are gone.

PACKAGE_DEPENDS_WITH_PATTERNS will soon be gone, and it was never
intended to be changed by users.

Sync description of REINSTALL w/ reality.

Note new NO_{SRC,BIN}_ON_{FTP,CDROM} variables.

add bin-install

Add entry for PKG_DEVELOPER
(There's much redundancy here with pkgsrc/mk/mk.conf.example ... :/)

branches: 1.28.4;
Document "USE_SSL".

document PACKAGE_DEPENDS_WITH_PATTERNS

Document USE_JAVA

Add LTCONFIG_OVERRIDE and LIBTOOL_OVERRIDE definitions.

identify RUN_DEPENDS as depricated

- Document the USE_FORTRAN variable used to indicate that a package needs
a fortran compiler to build.
- Document the PKG_FC variable used to control which fortran compiler is
used.

Document new behaviour of "update" target.

Add some help on when to use USE_X11BASE.

branches: 1.20.2;
Use full month names with .Dd, as per mdoc.samples(7).

Remove bogus information about ${INSTALL_TARGET}.

Document new update target.

Mention MASTER_SORT and MASTER_SORT_REGEXP.

- document LOCALBASE, CROSSBASE and X11BASE
- xref mk.conf(5) correctly
- add a see also section

branches: 1.15.2;
Fix .Bl/.El imbalance.

Xref mk.conf(5), move per-package variables from the common section over
to the package-specific section, add section on how to set defaults for
package distfile repositories (MASTER_SITES_*), from mk.conf(5).

You do not want to set PREFIX manually, and there is no patch -C here

s/USE_X11/USE_X11BASE/g
s/BUILD_USES_X11/USE_X11/g
Note the changes in meaning of the two definitions. This should be much more
intuitive.

Document BUILD_USES_X11 definition.

Document REQ_FILE and MESSAGE_FILE definitions.

Document INSTALL_FILE and DEINSTALL_FILE definitions, to be set to the
names of any INSTALL or DEINSTALL scripts, respectively.
Also bring explanation of LIB_DEPENDS up to date.
Document USE_LIBTOOL.

Document LDFLAGS in bsd.pkg.mk. Also, CFLAGS wasn't documented so I
threw that one in as well.

Document use of NOT_FOR_ARCHS.

Add glob-style wildcards to ONLY_FOR_ARCHS.

Document LICENCE definition, and ACCEPTABLE_LICENCES.

Finish documenting automatic man page handling changes.

Update the package collection documentation to reflect the automatic
manual page handling changes. The explanations for the MAN<sect> and
CAT<sect> definitions, and MANLANG, have been left in place until all
occurrences have been deleted from the package Makefiles.

Modify the section on MOTIF variables to match reality - there are now
only two: USE_MOTIF and MOTIFLIB.

add a packages(7) man page, cobbled from bsd.pkg.mk

man: use https URLs for www.NetBSD.org

branches: 1.6.58;
Add "The pkgsrc developers" to guide authors.

Wrap the pkgsrc guide and its URL around .Rs/.Re.

The layout of the website has changed. Fixed improper capitalization of
NetBSD.

branches: 1.3.4;
Add another sentence, and reword an existing one. From reed@.

Nd does not expand Nx. Weird. Found by reed@.

Add simple pkgsrc(7) man page linking to pkg_add, pkg_delete, pkg_info
and the pkgsrc guide. Requested by Alan Barrett.

Create bootable images in ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg.

Release builds for arm platforms create compressed images in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. However, in some
cases, e.g., armv7.img.gz, they are not bootable. Consequently, boot
blocks must be manually installed in the images, which is an extra
barrier for testing systems or adopting NetBSD. This has prompted
creation of external repositories, e.g., armbsd.org, to host a
collection of bootable images. However, this does not ease the burden
on developers compiling their own systems; for them, manual
installation of boot blocks is still required.

For arm platforms, etc/etc.evbarm/Makefile.inc contains the commands
used to create system images. Because installboot(8) can write boot
blocks directly to system images, a loop through possible boards can
create a series of bootable images during the normal build process.

In the case of many arm platforms, installboot(8) uses U-Boot boot
blocks, which are not part of the NetBSD source code. Developers can,
however, install as many U-Boot boot blocks as desired, either in the
default location of /usr/pkg/share/u-boot or in a set of directories
pointed to by the U-Boot search path, the INSTALLBOOT_UBOOT_PATHS
environment variable. For each board with an available boot block, a
board-specific bootable image will be created in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. If a boot block is
not available, which is the typical situation currently, no additional
image will be created.

This facility creates opportunities to build bootable images for any
number of boards within the scope of a standard release build.
However, that is not required and will not occur without the
intervention of installing U-Boot boot blocks prior to the build.

Add the missing rescue(8) and tests(7) sets. XXX: this manual is somewhat
broken due to the differences in the archival formats used.

Document xetc.tgz installation set.

Thanks to <wiz> for the review!

Remove workaround for ancient HTML generation code.

branches: 1.36.8;
bump date

fix cksum syntax, CDROM -> CD-ROM, give a specific example of a kernel set
rather than kern.tgz, add dd(1) xref for usb images

branches: 1.34.10;
Fix typo.

Update release(7) for the recent iso -> images change.

branches: 1.32.2; 1.32.4;
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.31.6;
Sync with reality.

bump date for previous

mention the new modules.tgz set

New sentence, new line. Use Aq instead of \*[Lt]\*[Gt].

Don't use .Xo/.Xc to workaround ancient groff macro argument limit.
Reduce indentation a bit to make it more readable.

Fix markup

branches: 1.25.4; 1.25.6; 1.25.8; 1.25.10;
Convert TNF licenses to new 2 clause variant

branches: 1.24.6; 1.24.8;
update for iso-image-source

branches: 1.23.4;
Mention the .../iso directory and explain the difference between
it and the .../${MACHINE}/installation/cdrom directory. Discussed in
tech-install.

* Mention that CD-ROM releases don't include the NetBSD-<rel> directory.
* More consistent indentation.

branches: 1.21.4;
Fix typo or mispelling.

branches: 1.20.2;
Change all .Xr config 8 to .Xr config 1, following the recent move of
config from usr.sbin -> usr.bin.

Reviewed by wiz.

Fix mdoc warning reported by Nicolas Joly in PR 29708.

Sync with reality...

- - Clarify how to do multi-platform releases. README, SOURCE_DATE, and
"source" are placed at the root of the heirarchy. Call the heirarchies
in <machine> the "binary releases", to distinguish from the entire
release, which includes source.
- - Split sets are gone.
- - We can now do everything with "./build.sh". Tell how.

I proposed this on tech-install and tech-toolchain, and there were no
objections.

Removed accidental repetitious words.

branches: 1.16.6;
Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

s/seperate/separate/

Fix typos, and formatting fix.

Drop superfluous .Pp.

Improve reference to config 8, and some whitespace fixes.

Describe new shared-set layout: .../shared/$MACHINE_ARCH and .../shared/ALL.

Add description about the "source" dir of a release, based on what's there
for 1.4.2.

remove security/

Add standalone "iso-image" target that can be run with DESTDIR and RELEASEDIR
set in src/etc after a "make release" in both "src" and "xsrc", to create a
ISO-image of the release in $RELEASEDIR/installation/cdrom.

Hook for architecture dependent pre/post-processing in etc/etc.*/Makefile.inc
are available as 'iso-image_md_post' and 'iso-image_md_pre', see
etc/etc.i386/Makefile.inc as an example. Might be useful for setting up
bootable CDs on alpha, sparc, ...

Reviewed by Todd Whitesel and Thomas Klausner.

branches: 1.7.8;
Legalize INSTALL.{html,more,ps,txt}

branches: 1.6.2;
First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Assign my copyrights to TNF.

Change occurrences of "UNIX" to .Ux or .At as appropriate.

macroize BSD, NetBSD, FreeBSD and misc cleanup

Fix a typo; s/accomodate/accommodate/

branches: 1.1.2;
Add a document describing the layout of a NetBSD release.

Remove weird markup.

PR/46602: Move the rfc6056 port randomization to the IP layer.

branches: 1.2.2;
New sentence, new line. Do not Xr yourself. Add serial commas.
Remove superfluous Pp.

add new rfc6056.7, from vlad

Use .In instead of .Aq Pa for header files.

Convert TNF licenses to new 2 clause variant

branches: 1.4.10; 1.4.12;
Sort sections.

Remove superfluous word, found by Jared Yanovich,
forwarded by jmc@openbsd.

New sentence, new line. Add xrefs to csh and ksh.
From jmc@openbsd.

add a man page explaining how #! scripts work

security.7: give example of a program with per-user-tmp issue

security.7: note some programs won't work with per-user-tmp

Addresses a documentation aspect of PR kern/58438.

branches: 1.16.8;
Various entropy integration improvements.

- New /etc/security check for entropy in daily security report.

- New /etc/rc.d/entropy script runs (after random_seed and rndctl) to
check for entropy at boot -- in rc.conf, you can:

. set `entropy=check' to halt multiuser boot and enter single-user
mode if not enough entropy

. set `entropy=wait' to make multiuser boot wait until enough entropy

Default is to always boot without waiting -- and rely on other
channels like security report to alert the operator if there's a
problem.

- New man page entropy(7) discussing the higher-level concepts and
system integration with cross-references.

- New paragraph in afterboot(8) about entropy citing entropy(7) for
more details.

This change addresses many of the issues discussed in security/55659.
This is a first draft; happy to take improvements to the man pages and
scripted messages to improve clarity.

I considered changing motd to include an entropy warning with a
reference to the entropy(7) man page, but it's a little trickier:
- Not sure it's appropriate for all users to see at login rather than
users who have power to affect the entropy estimate (maybe it is,
just haven't decided).
- We only have a mechanism for changing once at boot; the message would
remain until next boot even if an operator adds enough entropy.
- The mechanism isn't really conducive to making a message appear
conditionally from boot to boot.

Remove workaround for ancient HTML generation code.

branches: 1.14.8;
Mention MPROTECT issues

the data segment is not randomized.

0 mappings are currently disabled on all architectures.

Merge riastradh-drm2 to HEAD.

Use Mt for email addresses.

branches: 1.9.4;
Fix a few file system paths to use Pa macro.

branches: 1.8.4; 1.8.10;
Add some random, but decent enough, reading material to SEE ALSO.

Now that this is a generic page, clarify the AUTHORS section a little.

Remove duplicate word.

Remove xref to nonexistent option(4).