Add stub manual pages for /etc/changelist and /etc/pkgpath.conf.
Fixes PR bin/55477.

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

Process /etc/modules.conf (if present) at startup, before securelevel is
raised, to allow module loading on ports without a module aware bootloader.

branches: 1.70.4;
remove dup file

branches: 1.69.2;
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.68.2;
For completenesses sake, note, in 2011, /etc/floppytab.

branches: 1.67.2;
Link {daily, monthly, weekly}.conf.5 to {daily, monthly, weekly}.5 and move
things around a little. Part of fixing PR bin/22230.

make resolver.5 an alias to resolv.conf.5, since ours was better.

new from libbind

As was done with the man-page for <sys/types.h>, move dir(5) to dirent(3).
Add a table describing the stat <-> dirent types. Note IFTODT() and DTTOIF().

Rewrite types(5) as per perry@'s suggestion from few years back ("XXX this
document is rather musty. It needs a general update."). Also move it to the
right section from section 5. Ok wiz@.

To minimize maintenance costs, the content is mostly jargon around The
Standard. Only few NetBSD-specific types are mentioned as an example.

Document recent gpio(4) changes and introduce a new config file for GPIO.
Integrate with the startup scripts in /etc/rc.d. Introduce new variable
"gpio" for /etc/rc.conf.

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

Proposed on tech-kern@.

Following input from Matthew Mondor, some Veriexec documentation changes:

- Document the signatures file format in a veriexec(5) man-page,
- Document the strict levels and a general Veriexec intro in veriexec(8)
instead of security(8).

Okay blymn@.

Add support for /boot.cfg configuration file in x86 boot loader.
This allows easy configuration of banner text, console device and timeout
as well as allowing menus of commands to be displayed. If /boot.cfg
is not present, then the existing behaviour does not change.

The sections in the boot loader source are surrounded by #ifdef SMALL
allowing this functionality to be removed if space is at a premium.

My last commit accidently added the links for some other manpages.
Remove those for now.
And commit them later at same time with distrib/sets/lists/base/mi.
Sorry!

Add sysctl.conf.5 manpage.
Thank you, wiz, for the few mandoc suggestions.
I slightly reworded part of the description and removed the
advertising clause from the version I posted to tech-userlevel.

branches: 1.56.12;
Install nologin(5).

forward.5 from FreeBSD
resolves pr#20179

Add a pam.conf(5) manual page.

merge after importing pf from openbsd 3.6. (userland part)

some files were imported to the different places from the previous version.
v3_5:
etc/pf.conf
etc/pf.os
etc/spamd.conf
share/man/man4/pf.4
share/man/man4/pflog.4
share/man/man5/pf.conf.5
share/man/man5/pf.os.5
share/man/man5/spamd.conf.5
v3_6:
dist/pf/etc/pf.conf
dist/pf/etc/pf.os
dist/pf/etc/spamd.conf
dist/pf/share/man/man4/pf.4
dist/pf/share/man/man4/pflog.4
dist/pf/share/man/man5/pf.conf.5
dist/pf/share/man/man5/pf.os.5
dist/pf/share/man/man5/spamd.conf.5

add locale.alias(5) manpage.

Add route.conf(5). Closes PR 25818 by mrg.

spamdb(8) and spamd.conf(5). noted by Thomas Klausner

add pf manpage for installation

Replace the statfs() family of system calls with statvfs().
Retain binary compatibility.

branches: 1.47.2;
Add locate.conf(5).

Move siginfo(5) and ucontext(5) to siginfo(2) and ucontext(2) resp.,
and fix references.
Per a discussion on source-changes around Sep 14 2003.

New man page for siginfo.

Drop trailing whitespace. Reviewed by wiz.

Add ucontext(5) from Klaus Klein.

Add documentation for utmpx and some related functions.
Thanks for some explanations to christos, and for some STANDARDS hints
to Klaus Klein.

mixerctl.conf(5) documentation.

On note by kleink: Add primes.5 to crypto/dist/ssh instead of share/man/man5.

install primes.5

elf.5

install ipsec.conf.5 manpage

extend /etc/ifconfig.xxN, for comment lines (#) and shell script
fragment (!). inspired by openbsd /etc/hostname.xxN.

We now have a wscons.conf(5) manpage.

PCVT is dead. From NAKAJIMA Yoshihiro <nakayosh@kcn.ne.jp>.

Documentation for passwd.conf.

branches: 1.32.2;
add netconfig.5

branches: 1.31.2;
Add necessary support routines for login.conf.

documentation for /etc/mk.conf

add hesiod.conf(5)

Put back the rhosts(5) and master.passwd(5) links.

merge nsswitch into main branch

Add a ranlib(5) based on the one from Berkeley ranlib(1).

Add an ar(5) manual page based on the one from the Berkeley ar(1).

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

A hosts.equiv/.rhosts manual page, written from scratch

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

make a link to master.passwd.5 from passwd.5

move man pages into share/man.

branches: 1.19.2;
Add scripts and documentation for a new method to create assym.h files.
With the kern/genassym.sh script HOSTED_CC is no longer used to create
assym.h files. This should make crosscompilation easier.

remove nsswitch.conf.5 -- not in tree (yet)

add man pages for mostly new and some old configuration files.

Add ttyaction.5

initial nsswitch implementation

build/install netgroup man page from here.

this is really dave's fault :)

specify man pages the new way.

pcfs is gone

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

mv resolver.5 to resolv.conf.5

ethers(5) man page by Roland McGrath <roland@frob.com>

(take 3! the previous 2 have been -o'd)
from Thomas Eberhardt <thomas@mathematik.uni-Bremen.de>:
add link.0

now that the rpc code lives in libc, we should install the man page
for /etc/rpc from here. the man page's header was changed to note
that hackers/source-browsers should look at the README and DISCLAIMER
in libc/rpc

Add RCS indentifiers.

added some missing MLINKS

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

added man page for pcfs, the MS-DOS filesystem

branches: 1.1.1;
Initial revision

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

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.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

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

Whitespace/punctuation fixes.

Typo, whitespace and punctuation fixes.

cross-reference elf.5

Fixed typos (mostly from OpenBSD)

branches: 1.11.4;
Add #include <sys/types.h> to man page to document existing practice.
(PR misc/4540.)

branches: 1.10.2;
there is no dbx(5)

alternate -> alternative, per PR 2643

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

Fix incorrect uses of .Xr, and add some items to the SEE ALSO section.

Document new a.out flag.

branches: 1.5.2;
Describe nlists' n_other field.

i love writing documentation 10 months later

Updated the description of the relocation_info structure to reflect the
bits usurped by dynamic linking.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

reference the correct function called.

PR/58515: Kouichi Hashikawa: Sync with the header file

branches: 1.10.2; 1.10.4;
Explain the state of ASU and ACOMPAT.

branches: 1.9.78;
Note that ACOMPAT and ASU are no longer recorded.

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

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

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

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

Sort SEE ALSO, and a punctuation fix.

Update cross-references. From John Hawkinson.

branches: 1.3.2;
Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Remove workaround for ancient HTML generation code.

branches: 1.8.8;
Sort sections. From Henning Petersen in PR 49222.

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

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

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Instead of Xref to ourselves, use .Nm.

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

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

use Dq as appropriate

Add an ar(5) manual page based on the one from the Berkeley ar(1).

autofs: Change my email address in man pages to netbsd.org

branches: 1.4.4;
Add mount_autofs(8) from DragonFly BSD

.An -nosplit

Add RCS Id. Simplify SYNOPSIS and remove loader.conf(5) reference.

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

boot.cfg.5: banner can span up to 12 lines, and not 10 like stated.

For the record, the value is set by the BOOTCFG_MAXBANNER macro defined
in sys/lib/libsa/bootcfg.h.

Add a comment to clarify the selected drivers to disable in the example

Bump date for previous.

boot.cfg.5: Note that userconf can be used multiple times

Additionally:
- Make it easier for the reader to learn which keywords can be used
multiple times
- Use multiple "userconf" lines in the EXAMPLES section, conveniently
listing the current DRM drivers that a user might need to disable to
troubleshoot "blank screen after boot" issues.

Remove workaround for ancient HTML generation code.

branches: 1.27.8;
Sort keywords. From dieter roelants in PR 49855.
Bump date.

Remove superfluous '.Pp' macro (fixes mandoc(1) warning).
Patch supplied by Bug Hunting.

branches: 1.25.2;
fix incorrent example.

New sentence, new line. Use more markup. Bump date for previous.

Add support for passing saved entropy (random seed file) to the kernel
from the bootloader. This can fix the problem of poor quality keys
for other kernel modules which call arc4random() early in kernel startup
(NFS startup, in particular, causes this).

We continue to rely on the etc/rc.d/random_seed script to save entropy
to the seed file at shutdown and erase the seed file at startup.

Boot loader support implemented only for i386 and amd64 ports for now but
it should be easy for other ports to do the same or similar.

branches: 1.22.4;
Support userconf(4) command in boot(8)/boot.cfg(5) on i386/amd64.

From jmmv@, no objections seen in the proposed thread:

http://mail-index.netbsd.org/tech-kern/2009/01/22/msg004081.html

Correct section in xref.

Bump to the right date.

Xref boothowto(8).

Use \*[Lt] and \*[Gt] instead of < and >.

PR# port-i386/39463: boot.cfg(8) does not mention about relative path for
the 'load' option

Document the search behaviour of the 'load' directive when an absolute
path is not specified.

Fix incorrect wording. From Bug Hunting in PR 41989.

sort keywords

document the clear option, from Anon Ymous..

ramdisk.kmod -> miniroot.kmod

branches: 1.12.2;
Correct existing Xen example and add Xen with serial console example.
Refer to boot.cfg(5) for Xen examples from boot(8).

Add example of booting Xen.

Add missing .El directive.

Bump date for previous.
Use more markup. Sort sections.

Document the new format option

branches: 1.7.2;
Fix syntax for load command. There is no = sign when specified as a command
vs being a boot.cfg directive.

Add support for multiple commands separated by semi-colons on menu lines
in boot.cfg.
e.g.
menu=Boot with module foo:load=/foo.kmod;boot

- Give x86 BIOS boot the ability to load new style modules and pass them
into the kernel. Based on a patch by jmcneill@, with many fixes and
improvements by me.

- Put MEMORY_DISK_DYNAMIC and MODULAR into the GENERIC kernels, so that
you can load miniroot.kmod from the boot blocks and boot into the
installer!

branches: 1.4.2; 1.4.6; 1.4.8;
If a menu line in boot.cfg has an empty description, then re-use the
command as the description. For example,

menu=:boot netbsd -s

now works like

menu=boot netbsd -s:boot netbsd -s

i386 and amd64 share a bootloader, so this should work on both.

Thanks to xtraeme@ and bouyer@ for pointing out this oversight.

While boot.cfg support is currently i386 only, it is hoped that its use
will be extended to other appropriate ports in future. Note as such in the
bugs section.

This is an MI man page, so should not be flagged as i386 in the header.

Add support for /boot.cfg configuration file in x86 boot loader.
This allows easy configuration of banner text, console device and timeout
as well as allowing menus of commands to be displayed. If /boot.cfg
is not present, then the existing behaviour does not change.

The sections in the boot loader source are surrounded by #ifdef SMALL
allowing this functionality to be removed if space is at a premium.

Man page typo fix.

Remove workaround for ancient HTML generation code.

branches: 1.3.18;
Merge riastradh-drm2 to HEAD.

Use Mt for email addresses.

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

Add stub manual pages for /etc/changelist and /etc/pkgpath.conf.
Fixes PR bin/55477.

Remove misleading comments from core(5)

netbsd_elfcore_procinfo is still in version 1.
cpi_siglwp is stored in the same netbsd_elfcore_procinfo version (1).

The size of struct is stored in cpi_cpisize and the struct can be
expanded without versioning the struct.

core(5) was in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf
via Ingo Schwarze <schwarze@OpenBSD>

branches: 1.31.6;
Remove workaround for ancient HTML generation code.

branches: 1.30.4;
More markup.

Update core(5) with current reality

Note cpi_siglwp addition in NetBSD-2.0 and retaining the procinfo ver. 1.

Note ELF_NOTE_NETBSD_CORE_AUXV (2) addition in NetBSD-8.0.

Update the HISTORY section.

branches: 1.28.2; 1.28.4;
Minor fixes.

New sentence, new line.

Sort SEE ALSO. From Henning Petersen in PR 49327.

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

Move TNF licenses to 2 clause form

branches: 1.23.20; 1.23.22;
u_intN_t -> uintN_t

"consists of", not "contains of".

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.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

register with only one "ist".

Document the ELF core file format.

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

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Typo, whitespace and punctuation fixes.

use Dq as appropriate

Rewrite description of core dump format to reflect reality.
Addresses PR#11145 by me.

xref signal(7) instead of sigaction(2)

s/remplaced/replaced/

Document CTL_PROC, the core filename format it core(5), and xref sysctl(8),
sysctl(3), core(5) in various place.
Document 'options DEFCORENAME' inj options(4) and $defcorename in rc.conf(5).

branches: 1.8.4;
More and more .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 minor formatting error.

Document shortcorename support and control.

kill xrefs to obsolete debuggers

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

Update for new file naming convention.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Update default pkgsrc database location from /var/db/pkg to /usr/pkg/pkgdb.

New sentence, new line. Use more markup.

PR/46756: Edgar Fu�: Enable ignoring subdirectories in daily's find_core

mention run_makemandb

branches: 1.3.4; 1.3.6;
Indent the two lists with the same width.

Fix PR bin/22230.

Link {daily, monthly, weekly}.conf.5 to {daily, monthly, weekly}.5 and move
things around a little. Part of fixing PR bin/22230.

Link {daily, monthly, weekly}.conf.5 to {daily, monthly, weekly}.5 and move
things around a little. Part of fixing PR bin/22230.

Mark up PKGDB_DIR with Dv (same as in pkg_install.conf).

Note that pkgdb_dir is deprecated and point to the alternative setting.

Document the new package-related maintenance options and security checks
in daily.conf and security.conf.

As Mikael Magnusson notes, run_fsck_flags does not take a YES or NO
and it should be in the second listing of variables. While here,
capitalize and make the description a little bit more explicit.

Add a run_fsck_flags variable to daily.conf(5), allowing extra flags to
be passed to to daily fsck run.
For example, run_fsck_flags="-Tffs:-X" will run the nighly fsck_ffs on a
snapshot :)

remove clause #3 from my license where there are no other
copyright holders involved.

branches: 1.21.4; 1.21.6; 1.21.8;
Remove references to check_uucp in daily.conf(5) and the defaults
file... uucp was removed a while ago.

branches: 1.20.18;
Bump date for *ignore_fstypes addition; new sentence, new line;
mark up the bang.

PR misc/7716: document the check_devices_ignore_fstypes and
find_core_ignore_fstypes options.

Remove non-intended arguments from macro line; drop trailing
spaces and bump date.

Clarify the relationship of the /etc/daily.conf file and the
/etc/defaults/daily.conf file, explain how you can check for defaults,
etc.

document show_remote_fs

Bump date for previous (hi perry!).

document full_netstat variable

Suppress emailing the daily security report if it is empty, unless
send_empty_security=YES. Implements change-request PR security/17249
from Takahiro Kambe <taca@sky.yamashina.kyoto.jp>.

Fix Xref.

Note that check_disks also reports failed raidframe components.

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

skeyaudit(1), not (8).

Run skeyaudit (only) from /etc/daily instead of /etc/security, else there's
some risk that the users don't get warned if an admin turns off running
/etc/security (by putting run_security=no into daily.conf).

Fixes PR 12267.

use Dq as appropriate

run skeyaudit, if run_skeyaudit is set to yes

branches: 1.5.4;
- Make /etc/daily run /etc/daily.local if it exists. Make similar change for
weekly and monthly scripts.
- Update FILES section in manpages.

More and more .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.

remove advertising clause from all my licenses.

fix some typos.

add man pages for mostly new and some old configuration files.

As was done with the man-page for <sys/types.h>, move dir(5) to dirent(3).
Add a table describing the stat <-> dirent types. Note IFTODT() and DTTOIF().

Add a note that the "whiteout inode", DT_WHT, is an implementation detail
and should not be seen in normal user applications.

Move the more detailed discussion around the dirent-structure from
getdents(2) to dirent(5), and extend it with some compatibility notes.

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

reflect reality in the struct members.

struct dirent is padded to an 8 byte boundary according to sys/dirent.h.

u_intN_t -> uintN_t

64 bit inode changes

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

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

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Remove duplicate defines.

And make that getdents(_2_).

Don't back-reference getdirentries(3).

Nit.

s/file format/format/

Bring up to date with getdents(2) reality.

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

Typo, whitespace and punctuation fixes.

More and more .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.

don't xref nonexistent mount(1)

KERNEL -> _KERNEL

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

Comma separate items in SEE ALSO list.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Sort SEE ALSO; new sentence, new line.

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.11.56;
Move UCB-licensed code from 4-clause to 3-clause licence.

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

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

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

Whitespace/punctuation fixes.

fix up various .Nm abuses:
- keep the case consistent between the actual name and what's referenced.
e.g, if it's `foo', don't use '.Nm Foo' at the start of a sentence.
- remove unnecessary `.Nm foo' after the first occurrence (except for
using `.Nm ""' if there's stuff following, or for the 2nd and so on
occurrences in a SYNOPSIS
- use Sx, Ic, Li, Em, Sq, and Xr as appropriate

More and more .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 typo, as per PR 5296 by Patrick Welche <prlw1@newn.cam.ac.uk>

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

Fix typo: or -> for.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

elf(5): brush up markup

Mostly use consistent -width for tagged lists. Add subsection titles
for ELF, section, and program headers so that it's easier to see the
section boundaries at a glance.

elf(5): new sentence - new line

elf.5: Use the gABI spelling for a constant.

s/of of/of/ in comment.

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

Convert TNF licenses to new 2 clause variant

branches: 1.13.16; 1.13.18;
elf loader lives in /libexec these days. and besides, it's called
ld.elf_so, not ld.so_elf

fix magic indices: EI_MAG, not ELFMAG

Typos, mostly a -> an.

Reviewed by: grant

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Fix typo reported by Anthony Sofia in PR 21015.

Give core files a mention.

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

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Typo, whitespace and punctuation fixes.

Clarifications and minor modifications.

inspired by comments from Matthew Green

Header name markup nit.

No need for <sys/types.h>.

add manual page describing ELF - executable and linking format

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Typo, whitespace and punctuation fixes.

use Dq as appropriate

- provide an obvious description of the line syntax.
- highlight that the second argument may be an IP address (which often
makes sense on machines that have different MAC addresses for
different interfaces; the whole world ain't a Sun...)

More and more .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 bad .Xr references

macroize BSD, NetBSD, FreeBSD and misc cleanup

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

ethers(5) man page by Roland McGrath <roland@frob.com>

Fix a few file system paths to use Pa macro.

branches: 1.3.2; 1.3.4; 1.3.10;
Sort sections.

Fix typo (.Ed -> .El).

For completenesses sake, note, in 2011, /etc/floppytab.

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

branches: 1.2.6; 1.2.12;
Use @NetBSD.org example addresses.

forward.5 from FreeBSD
resolves pr#20179

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

u_intN_t -> uintN_t

Fix a typo and replace a comma with an 'and'.

Sync with sys/ufs/ffs/fs.h.

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

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

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

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

Whitespace/punctuation fixes.

update "struct fs" description to reflect reality

More and more .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.

commit a revised version of the suggested change in pr7105.
delete reference to (no longer used) NBPI parameter.
instead, insert crossref to newfs(8)

fix bad .Xr references

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

sys/inode.h -> ufs/ufs/inode.h, as noted by bgrayson@ece.utexas.edu in PR 5245.

sync to current layout of includes

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

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

fstab.5: note the first field is a placeholder for some FSes

Addresses PR misc/52607. (I suppose something about this could also be
added to the man pages for the mount commands for each applicable file
system, but I think this should suffice.)

remove mount_smbfs(8)/nsmb(4) references

fstab.5: add mention of zfs

branches: 1.44.2;
If fs_spec starts with the special string "ROOT.", replace it with a device
path derived from the value of the kern.root_device sysctl.

branches: 1.43.14; 1.43.16;
Add .Pp for easy distinction between examples.

Add examples for NAME, both with gpt and without.

cross reference getfsspecname(3)

document NAME=label

Update dangling references to quotactl(2), mostly now libquota(3), and to
quotactl(8), mostly now quotarestore(8). ok riz@

branches: 1.38.4;
Bump date for new quota.
Split "file system" like customary.

merge the bouyer-quota2 branch. This adds a new on-disk format
to store disk quota usage and limits, integrated with ffs
metadata. Usage is checked by fsck_ffs (no more quotacheck)
and is covered by the WAPBL journal. Enabled with kernel
option QUOTA2 (added where QUOTA was enabled in kernel config files),
turned on with tunefs(8) on a per-filesystem
basis. mount_mfs(8) can also turn quotas on.

See http://mail-index.netbsd.org/tech-kern/2011/02/19/msg010025.html
for details.

branches: 1.36.4;
New sentence, new line.

document -o rump

Bump date for previous.

lfs filesystems work with fstab(5), sync man page.

branches: 1.32.6;
getfsent(3) does not contain any information about the (nonexisting)
function getfstype(), so don't MLINK it. Remove getfstype from other
places that reference it too.

Noted by jmc@openbsd.

Make the file system names column wide enough to suit all names.
Terminate all entries with a dot (for consistency with the ones that were
like this before).
Few minor markup fixes.

Mention tmpfs; noted by martti@. While here, also mention smbfs and ptyfs.

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

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

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

"Utilize" has exactly the same meaning as "use," but it is more
difficult to read and understand. Most manuals of English style
therefore say that you should use "use".

FSTAB_RQ was missing.

Add pointer to /usr/share/examples/fstab/ to FILES section.
Remove mount_*(8) xrefs, leave just mount(8).

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

Whitespace/punctuation fixes.

Add references for mount(8), mount_filecore(8), mount_ntfs(8), and
mount_overlay(8).

make entries in example line match field names used elsewhere

slight clarification

provide obvious example of line syntax

remove extra period in SEE ALL section

Replace "nullfs" by "null". Fixes PR misc/8481 by Feico Dillema.

More and more .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.

add a new fstab type "dp" for the user-specified dump device.
change swapctl -A to see this and add it via swapctl(2). also
add a new swapctl -D <device> to change the dump device on the
fly.

s/IT/It/

Note that #lines are comments.

add about 7 missing filesystems from the large list, and add a lot of man page xrefs

fix bad .Xr references

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

swapon -> swapctl

fs_passno comment dump->fsck, fixes 3150 from Andrew Wheadon

document the (no)auto option.

ufs -> ffs & two more filesystem types (from Mike Long; PR#1766).

branches: 1.5.2;
Changed isofs to cd9660.
Bug was reported by Carsten Hammer in PR #779.

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

If you're going to have a list of file systems, it might as well be complete.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Remove workaround for ancient HTML generation code.

branches: 1.12.38;
Move Matthias Pfaller's files to 2-clause license. OK matthias@.

genassym.sh(8) -> genassym(1). From YOMURA Masanori in private mail.

/sys is no longer available, change it to /usr/src/sys.

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

Typo, whitespace and punctuation fixes.

Fix Nd and some whitespace.

remove extra period in SEE ALL section

More and more .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.

Document "config" and all other undocumented genassym.sh commands.

Correct spelling and xrefs.

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

Add scripts and documentation for a new method to create assym.h files.
With the kern/genassym.sh script HOSTED_CC is no longer used to create
assym.h files. This should make crosscompilation easier.

Like /etc/rc.d/network, add the ability to put a '!' character as the
first character in /etc/gpio.conf and have the rest evaluated in a
shell. It is useful to be able to do actions after setting up gpio
pins or attaching gpioiic(4).

Simplify example.

Document recent gpio(4) changes and introduce a new config file for GPIO.
Integrate with the startup scripts in /etc/rc.d. Introduce new variable
"gpio" for /etc/rc.conf.

Sort SEE ALSO.

Add newgrp(1) cross-reference.

Explain that groups can be defined using multiple lines due to the fixed
line length used to parse the file. Closes PR misc/34664.

Move Jason Downs's code from a 4-clause to a 3-clause licence by
removing the advertising clause. Diffs provided in PR 22410 by Joel
Baker, confirmed to the board by Jason Downs.

With additional thanks to Jason Thorpe.

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

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

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Whitespace and formatting fixes.

use Dq as appropriate

use Em instead of Ar (we're not describing command line arguments here...)

use Ar instead Sy (be consistent with other files)

improve description of line syntax, and separate the description of
each field out into separate paragraphs (for readability).

Fix .Bl/.El imbalance.

reference nsswitch.conf(5) as necessary
change references from YP to NIS.

update reference for su(1) special group to read `group wheel' instead
of `group 0'

Document the meaning of gid 0 to the su command.

Improvements to YP support from Jason Downs.

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

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Whitespace/punctuation fixes.

mdoc'ify.

after discussion with greg hudson, change default classes back to "in,hs"

add hesiod.conf(5)

Retire the paragraph from 1983 that says this file can be "created
from the official host data base maintained at the Network Information
Control Center (NIC)". Suggested by Henry Bent.

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

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

Whitespace/punctuation fixes.

use Dq as appropriate

use Em instead of Ar (we're not describing command line arguments here...)

use Ar instead Sy (be consistent with other files)

- improve description of a configuration line
- fix a line that got accidently moved to the wrong place when i added
the nsswitch description 2 years ago.

branches: 1.7.2;
IPv6 numeric addresses are permitted.

branches: 1.6.8;
More and more .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.

reference nsswitch.conf(5) as necessary
change references from YP to NIS.

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

correct specification of a hosts line

Add RCS indentifiers.

branches: 1.1.1;
Initial revision

Sort sections. From Henning Petersen in PR 49222.

Convert TNF licenses to new 2 clause variant

branches: 1.7.26; 1.7.28;
Mark up paths with .Pa.

New sentence, new line.

Drop superfluous .Re.

use Dq as appropriate

Remove my copyright and leave only the TNF assignment.

branches: 1.2.2;
More and more .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.

branches: 1.1.2;
A hosts.equiv/.rhosts manual page, written from scratch

remove clause #3 from my license where there are no other
copyright holders involved.

branches: 1.13.32; 1.13.34; 1.13.36;
Fix some typos. From Igor Sobrado in PR pkg/19907.

While I'm here, new sentence, new line.

Whitespace/punctuation fixes.

use Em instead of Ar (we're not describing command line arguments here...)

does not support non-IPv4.

minor consistency cleanup

Rototillage: Update the date; addition => additional; netstart => rc.d/network;
line format to .Ar syntax; .Em => .Ar; Clarify the meaning of netmask omission;
Resort FILES; Remove NOTES.

the format without netmask is supported for compatibility only and not
specifying it is discouradged, actually
also add comments about this fact to etc/rc.d/network, for people who
don't read manpages :)

aliases => alias's
apostrophe rule verification from the New York Times Manual of Style and Usage

/etc/netstart is gone, we have /etc/rc.d/network now
also note netmask is optional

branches: 1.4.10;
More and more .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.

remove advertising clause from all my licenses.

Correction: ifaliases appeared in 1.2

add man pages for mostly new and some old configuration files.

Bump date

Make "rtsol" functional again.

Update date

Add an "rtsol" keyword to ifconfig.if for enabling IPv6 RS/RA

branches: 1.18.8; 1.18.16; 1.18.18;
Add comma in Dd. From Henning Petersen in PR 49515.

Remove redundant configuration snippet for dhclient and rtsol as dhcpcd will happily supply both needs.

Discourage the use of ifconfig_bge0=dhcp and prefer setting dhcpcd=YES
in rc.conf(5) instead.

branches: 1.15.4; 1.15.6; 1.15.8; 1.15.10;
Be more precise on the chars accepted for xxN in /etc/ifconfig.xxN
filenames, and ifconfig_xxN variables inside rc.conf(5).

Should fix PR misc/39376.

Collapse <abckslash><newline> sequences in /etc/ifconfig.xxx files read
by /etc/rc.d/network. Fixes PR 41662 by Christoph Badura, which was
also reported independently by Jeremy C. Reed.

Move explanatory text above the "dynamically-created" example,
to match other examples.

Move the 'dhcp' example so it doesn't disrput flow
into the note about use of 'create'.
bump date.

branches: 1.11.2;
* Allow multiple commands in $ifconfig_xxN variables in rc.conf(5).
This may be done either by embedding newlines in the value,
or by using semicolons to represent line breaks (but not both at once).
* Allow shell quoting insode $ifconfig_xxN variables or /etc/ifconfig.xxN
files. This allows something like ifconfig_wi0="ssid 'my network'; dhcp"

Allow per-interface DHCP configuration using dhcpcd via
ifconfig_xxN=dhcp or a dhcp line in /etc/ifconfig.xxN.

remove clause #3 from my license where there are no other
copyright holders involved.

branches: 1.8.20; 1.8.22; 1.8.24;
RFC 3879 deprecated the IPv6 site-local prefix (fec0::/10):
* remove all references to $ip6sitelocal and output a warning
message if the variable is defined.
* introduce $ip6uniquelocal (defaults to 'NO') that will control the
behaviour of the system when $ip6mode is ``router'' (i.e. fc00::/7
will not be routed if the variable is ``NO'') as per RFC 4193.

Thanks to Jonathan A. Kollasch for pointing this out in PR 32152.

Bump date for automatic create; new sentence fixes.

Automatically create and destroy cloning interfaces and sync IP Filter
immediately afterwards before bringing the interface up. This avoids
a small security gap existing in the previous scheme where IP Filter
was synced after all cloning interfaces were created and brought up.

branches: 1.5.2;
Add two keywords "netmask" in examples. Fixes PR #14930.

Quote .Sq argument, and give correct argument to .Bd -offset (_not_ xxxx).
Second part fixes misc/14692.

Whitespace/punctuation fixes.

branches: 1.2.2;
mention that the file is like /etc/ifconfig.fxp0. wording.

extend /etc/ifconfig.xxN, for comment lines (#) and shell script
fragment (!). inspired by openbsd /etc/hostname.xxN.

Fix preamble

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

branches: 1.3.34; 1.3.36;
Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Fix a typo noticed by maximum entropy <entropy@zippy.bernstein.com>

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

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Typo, whitespace and punctuation fixes.

branches: 1.1.2;
I found etc/rc.d/ipsec reads this, so add some documentation.
OK'd by Itojun.

Remove workaround for ancient HTML generation code.

branches: 1.20.38;
New sentence, new line. Use Sq for quoting single characters. Quote <> for
HTML. Whitespace fix.

Use shorter variable names to fit tty width. Use .Bd for samples.

branches: 1.18.4;
remove clause #3 from my license where there are no other
copyright holders involved.

branches: 1.17.26; 1.17.28; 1.17.30;
Uncomment xrefs to elf(5) and ld.elf_so(1) now that we have the man pages.

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

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Whitespace/punctuation fixes.

PR/9031: Scott Ellis: update example to include full sysctl variables.

Mention what happens when we fail to find a library.

Document the new hardware library line format.

branches: 1.10.4;
mention elf, clarify a.out

More and more .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.

remove advertising clause from all my licenses.

Document syntax supported by internal processing in ld.so, from
Jim Bernard <jbernard@tater.mines.edu>, PR #4031.

Move Xref to ldconfig(8) into the right section; from NAKAJIMA Yoshihiro
<nakayosh@kcn.or.jp> in PR/3715.

close enami tsugutomo's pr-3346 -- silly mistake in description of page

Fix another minor nit pointed out by Klaus Klein <kleink@layla.inka.de>

PR 3085: typo. Fix from frueauf@ira.uka.de.

fix minor nit.

add man pages for mostly new and some old configuration files.

link.5: fix some spelling and grammar

Remove workaround for ancient HTML generation code.

branches: 1.23.38;
Use .In instead of .Aq Pa for header files.

Convert TNF licenses to new 2 clause variant

branches: 1.21.10; 1.21.12;
running in emulated wizd mode, convert caddr_t to void *.

Removed accidental repetitious words.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Fix some typos. From Igor Sobrado in PR pkg/19907.

While I'm here, new sentence, new line.

file system, not filesystem.

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

No point in using __P in prototype declarations in man pages.

You can build libraries with more than just cc(1) now you know.

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Use standard section headers.

Typo, whitespace and punctuation fixes.

Remove blank lines.

Assign my copyrights to TNF.

fix bad .Xr references

macroize BSD, NetBSD, FreeBSD and misc cleanup

fix the the typos

Document hint file v.2

Update (incl. PR#1547).

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

reflect some changes over the last 6 months.

First draft of a link(5) manual page.
Needs more structuring. Feel free to assist on this ;-)

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

Proposed on tech-kern@.

remove clause #3 from my license where there are no other
copyright holders involved.

branches: 1.7.32; 1.7.34; 1.7.36;
file system, not filesystem.

Fix Nd, sort SEE ALSO, and improve formatting slightly. Remove some trailing
whitespace, and one grammar fix.

minor consistency work

More and more .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.

remove advertising clause from all my licenses.

Document the new "when" field.

add man pages for mostly new and some old configuration files.

Remove workaround for ancient HTML generation code.

branches: 1.2.84;
New sentence, new line; use more markup; next release
will be 3.0; sort sections; use \*[Lt]\*[Gt] instead of <> for HTML output.

add locale.alias(5) manpage.

More path markup. Ref wizd(8).

Use more markup.

Document the "database" configuration option.

Allow quoting of embedded shell metacharacters in locate.conf(5).

The shell_quote function here is identical to that in postinstall
and etcupdate.

This should fix PR 45130 from Greg Woods.

Cleanup my copyright notice.

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

branches: 1.6.20; 1.6.22;
Add locate.updatedb(8).
Discovered missing while sorting things out for BSDcertification.org.
Ran through wizd(8).

Use Fl instead of Ic; remove duplicate Pp;
filesystem -> file system.

"ignorefs type" now _appends_ to the existing (default) list. If the default
list isn't wanted, use "ignorefs none" before other "ignorefs ..." entries.
This makes "ignorefs ..." much more useful.

Tweak the wording.

Note that 'ignorefs type' is used as an argument to 'find -fstype'
and that "sysctl vfs.generic.fstypes" will list the available fstypes.

Grammar fixes; uppercase start of sentence.

File format description of /etc/locate.conf

small corrections and improvements

- mention sshd in addition to rexecd as the former is more widely used.
- only one backslash is used to escape whitespace and commas in lists.
- number can have an optional sign. see strtoq(3).
- clarify when a ~ character is expanded in path name list.

branches: 1.31.28;
Clean-up documentation of login.conf(5)

Remove redundant word "limit" from sentences "Maximum ...".
Note that vmemoryuse might specify both maximum and current limits.
Remove redundant 'in bytes' from the description of vmemoryuse, it's noted
in the next section describing the argument type 'size'.

Changes inspired by <riastradh> in PR xsrc/49912

Bump date for previous.

Clean-up resources (sys/sys/resource.h) usage

Add vmemoryuse to login_cap(3)
Document vmemoryuse in login.conf(5)
Document proc.pid.rlimit.vmemoryuse and proc.pid.rlimit.maxlwp in sysctl(7)
Document SBSIZE, AS, VMEM and NTHR in share/doc/psd/05.sysman/1.6.t

Reviewed by <riastradh>
Approved by <pgoyette>

Tested by Dominik Bialy

Closes PR xsrc/49912

branches: 1.28.6;
Improve wording.

add "maxthread" tunable to login.conf to adjust RLIMIT_NTHR.
PR/47626
ok'ed by christos

branches: 1.26.2;
Adjust xref for capability database file format.

branches: 1.25.2; 1.25.4;
fix a couple typos

branches: 1.24.2;
New sentence, new line.

Fix and improve markup.

Add more details for copyright and welcome.

Describe 'bool'. Update 'list'.
Inspired by FreeBSD.

Note: we could seek more inspiration from FreeBSD WRT login.conf(5)
and login_cap(3)'s implementation.

branches: 1.20.8; 1.20.14;
mention that we can now escape ,'s and whitespace using a double \\

Fix typo or mispelling.

branches: 1.18.2;
We don't fall back to the "default" login class if a login class was
given in the password file but not defined in login.conf. Just for
"no class is given". The former is an error and leads to rejection.

Add missing blank line between items.

Document 'sbsize' and 'tc'.

In `openfiles' attribute, clarify that it's the number of open file
descriptors (which could include sockets, etc.).
From jmc@openbsd.

Quote question and exclamation marks.

Document sshd(8)'s use of "host.allow" and "host.deny".
Based on [bin/12269] from Jim Bernard <jbernard@mines.edu>, tweaked by me.

Sort SEE ALSO correctly; trade empty lines for .Pp; drop superfluous .Pp's;
correct oder of sections; even comment in some .Xr's in one case.

Whitespace/punctuation fixes.

Fix the example to include leading ':'.
Fixes bin/12396 by Jim Bernard.

login(1), not (8).

- move the class explanation to the DESCRIPTION section, where it's more obvious
- format capabilitities with .Sy
- provide an example entry

use .Xr

xref login(1), not login(8)
fixes bin/10598 by Wolfgang Helbig

branches: 1.5.2;
Xref cap_mkdb(1) and add a FILES section mentioning /etc/login.conf.db.

branches: 1.4.2;
Add login_getpwclass to libutil as convenience function for
programs originally for FreeBSD.
Add parsing of "setenv" parameter which can be used to set
up an initial environment on login.

Minor formatting nits.

Update for added capabilities in login(1).

Add necessary support routines for login.conf.

Remove workaround for ancient HTML generation code.

branches: 1.6.90;
Document mixerctl behaviour during startup better.
Based on PR 21023 by Quentin Garnier.

The correct capitalisation of 'NetBSD.org' is (you
guessed it) 'NetBSD.org'.

some mdoc fixes.

The next release will be 2.0, not 1.7.

Improve mdoc, and correct the example of how to create mixerctl.conf.

Remove clause #3 (forgot to remove it before the original commit)

mixerctl.conf(5) documentation.

Import BSD-licensed diff from FreeBSD to replace GNU diffutils

Ported to NetBSD, compiler warnings fixed, and some unnecessary
features (for the purpose of replacing our GPLv2 diff) have been
stripped out.

Non-default at the moment, requires building with MKBSDDIFF=yes.

PR bin/59798 We are still using GNU diffutils

mk.conf.5: note MKCOMPAT is defaulted to "yes" for earm* too

mk.conf.5: drop duplicated "this" in sentence

Grammar fix for INSTALLBOOT_BOARDS.

Note limited platform availability for KERNEL_DIR.

man: use https URLs for www.NetBSD.org

mk.conf.5: update link to the pkgsrc documentation

branches: 1.109.2;
New make(1) variable NETBSD_REVISIONID in the NetBSD build.

This is intended to be a tree-wide revision identifier, like a commit
hash or similar. This way, in builds from non-CVS trees where
per-file $NetBSD$ revision ids aren't incremented, we can still track
some version provenance of files with ident(1).

If defined, bsd.own.mk adds a macro _NETBSD_REVISIONID to CPPFLAGS
with the stringified text of NETBSD_REVISIONID.

In turn, if _NETBSD_REVISIONID is defined in sys/cdefs.h, then
__RCSID will put the concatenation of:
- `$NetBSD: '
- the file name
- ` '
- _NETBSD_REVISIONID
- ` $'
alongside the per-file revision id passed as an argument to __RCSID.

Since this is passed through command-line arguments, it doesn't cause
make to consider any dependencies to change when the revision id
changes -- so incremental builds remain incremental. And if you
don't set it, nothing changes from the __RCSID we had before.

Currently nothing sets NETBSD_REVISIONID automatically yet -- subject
to experimentation. Could just be verbatim commit hash, or could be
longer `hg identify' output -- or, in git, with the help of tags,
could be `git describe --dirty' output like

10.99.10-2924-gd01834fb75de

(or `10.99.10-2924-gd01834fb75de-dirty' if the working tree is dirty)
for the commit at
https://mail-index.netbsd.org/source-changes/2024/05/24/msg151526.html
which is 2924 linear commits after the commit bumping sys/param.h to
10.99.10 and (in the current git conversion) had commit hash starting
with d01834fb75de. This may require some discipline around branching
and tagging but it's worth a shot -- we'll see.

Based on a patch from joerg@ a while ago.

bsd.own.mk: force MKSTRIPSYM=no if MKDEBUG=yes

Local symbols are desirable with MKDEBUG=yes, so don't strip them.
Per request from mrg@

mk.conf(5): tweak BUILDID and option. sort MKKDEBUG

Clarify BUILDID behaviour with OBJMACHINE, and remove unnecessary sentence.
Use option not flag; option may include a flag with an argument.
Sort MKKDEBUG before MKKERBEROS4.

mk.conf(5): document rump variables

Update mk.conf(5) with the rump variables from
- lib/librumpuser/README.compileopts
- sys/rump/README.compileopts

Add cross-references back to mk.conf(5) in those files.

Ensure that the Default: is listed last in a description,
for consistency with the convention in this file.

Fix previous. Patch mistakenly applied somehow...

Cite src/sys/rump/README.compileopts as a reference for MKRUMP.

mk.conf(5): more variables from BUILDING and build.sh

Add more variables from build.sh, BUILDING, and various
Makefile's documentation:
CDEXTRA CONFIGOPTS KERNARCHDIR KERNCONFDIR
KERNOBJDIR KERNSRCDIR LOCALTIME

Default sentences now consistently end with ".".
Consistency tweaks in "otherwise".
Editorial tweaks.

mk.conf(5): add remaining vars from BUILDING

Add more variables from BUILDING:
INSTALLBOOT_BOARDS INSTALLWORLDDIR NOCLEANDIR
NODISTRIBDIRS NOINCLUDES.

Add build.sh related notes (from BUILDING).

Clarify "target" as "target architecture" where appropriate
(versus a make target where that's obvious from context.)

Move all obsolete and deprecated variables to
new "OBSOLETE VARIABLES" section at the end.

Add some per-variable editorial improvements from BUILDING.

Change sub headings to headings; it's easier to read.
(I don't know why mdoc doesn't allow blank lines around .Ss)

mk.conf(5): editorial

MKDTB and MKPIE are .YorN.
MKX11=yes wants MKINET6=yes.
MKLINKLIB deserves a dash list (like bsd.README).

Expand per bsd.README: MKSTATICPIC, MKUNPRIVED,
MKX11, MKZFS, USE_LIBCSANITIZER, USE_SSP

Change the width of the variable lists to 14n (from 15n)
so that when the lists are rendered and then left aligned,
the column is 16 characters (aka 2 tabs) which makes
copypasta to bsd.README easier.

mk.conf(5): add more from BUILDING and bsd.README

Add from BUILDING or bsd.README:
BUILDINFO, BUILDSEED, EXTERNAL_TOOLCHAIN, MKCROSSGDB,
MKREPRO_TIMESTAMP, TOOLCHAIN_MISSING, X11SRCDIR

Clarify BUILDID.
Improve MKDEBUG, MKOBJ, MKX11, NETBSDSRCDIR, USETOOLS,
Consistent Note: formatting.

mk.conf: fix the year

mk.conf(5): update to reality

- Document:
MKAMDGPUFIRMWARE, MKARGON2, MKARZERO, MKBSDGREP,
MKCOMPATMODULES, MKCOMPATTESTS, MKCOMPATX11, MKCXX,
MKDEPINCLUDES, MKDTB, MKDTC, MKFIRMWARE, MKGROFF,
MKGROFFHTMLDOC, MKLIBCSANITIZER, MKLIBCXX, MKLIBSTDCXX,
MKLLVM, MKLLVMRT, MKMAKEMANDB, MKMANDOC, MKNSD,
MKRADEONFIRMWARE, MKRELRO, MKSANITIZER, MKSLJIT,
MKSTATICPIE, MKTEGRAFIRMWARE, MKTPM, MKUNBOUND,
MKXORG_SERVER, NETBSD_OFFICIAL_RELEASE,
USE_LIBCSANITIZER, USE_PIGZGZIP, USE_SANITIZER,
USE_XZ_SETS, X11MOTIFPATH
- Document obsolete/deprecated:
EXTSRCSRCDIR, MKBFD, MKCRYPTO, MKEXTSRC, MKKDEBUG,
MKKERBEROS4, MKLLD, MKLLDB, MKMCLINKER, MKPERFUSE,
MKTOOLSDEBUG, SHAREDSTRINGS, USE_COMBINE
- Fix defaults: MKLINT=no MKPICINSTALL=no USE_SKEY=no
- Expand upon defaults that are platform specific.
- Sort variable entries.
- If a NOxxx variable disables a variable, describe it.
- Layout of each variable: supported values, description,
any other variables that change this variable, optional note,
default value.
- Consistent double quotes around default strings (even paths).
- Consistent "will be" instead of "is" or "are".
- Sort order of internal macro definitions.
- Add NODEF and NOVAR macros.
- Oxford comma and semi-colons where appropriate.
- Fix mandoc -Tlint.

branches: 1.97.2;
mk.conf(5): we default to USE_SSP=yes these days.

build system: Revert all the recent additions of MK[...] knobs that
allow conditionally disabling the building of certain user space
programs in the 'base' set.

There is not enough consensus that this is the right way and a few
people had strong objections, see source-changes-d@.

mk: Add MKTIMED and MKMOUSED flags for compiling NetBSD without timed
and moused

Document MKPPP

mk: Add MKFINGER, MKTALK flags for not building
talk, talkd, finger, fingerd.

mk: Add MKNTP, MKTCPDUMP knobs.

Document MKLFS

mk.conf(5): Don't make "experimental" comment stand out.

Document some more build options. Delint.

mk: Rename the MKMBONE option to MKMROUTING for greater accuracy and
to match the related kernel config option.

mk: Allow setting MKDHCPD=no to build base without the ISC DHCP server,
useful for embedded images that don't need to act as one.

mk: Allow building base without the MBONE applications by setting
MKMBONE=no in mk.conf