Home | History | Annotate | only in /src/share/doc
History log of /src/share/doc
RevisionDateAuthorComments
 1.11 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.10 19-Jan-2009  jmmv branches: 1.10.14; 1.10.24;
The atf subdirectory is gone, so do not descend into it.
 1.9 12-Nov-2007  jmmv Add the ATF documentation

This change adds the ATF manual pages that are not tied to any specific
tool nor library. It also adds some distribution documentation to the
system, as this is linked to by the manual pages (plus we have to install
the license text to comply with its terms).
 1.8 09-Jan-1998  perry branches: 1.8.34;
RCS Id Police.
 1.7 01-Jun-1997  veego Only install the SUBDIRS, like we do it with src/bin/csh/USD.doc and the
other subdirectories under /usr/share/doc.
 1.6 09-May-1997  mycroft Eliminate bogus redefinitions of standard targets.
 1.5 04-Apr-1996  jtc Provide null "includes" target so that make won't recurse into the doc
subdirectory. There aren't any header files down there and bsd.doc.mk
doesn't grok "includes"...
 1.4 19-Jun-1994  cgd clean up import
 1.3 31-Jul-1993  mycroft Add RCS indentifiers.
 1.2 09-Jun-1993  cgd make documentation build into ps files. this works, mostly...
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.8.34.1 09-Jan-2008  matt sync with HEAD
 1.10.24.1 10-Aug-2014  tls Rebase.
 1.10.14.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1 05-Jul-2014  dholland branches: 1.1.2; 1.1.6;
Add a file to help keep track of what's where and what we never
actually had.
 1.1.6.2 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.6.1 05-Jul-2014  tls file README.docdirs was added on branch tls-maxphys on 2014-08-20 00:02:28 +0000
 1.1.2.2 10-Aug-2014  tls Rebase.
 1.1.2.1 05-Jul-2014  tls file README.docdirs was added on branch tls-earlyentropy on 2014-08-10 06:53:13 +0000
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.6 01-Jan-2022  msaitoh s/sytem/system/
 1.5 24-Nov-2006  christos fix spelling of accommodate; from Zapher.
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 04-Feb-2003  perry utilizing->particular
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.2 05-Feb-2003  perry "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".
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.2 05-Feb-2003  perry "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".
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.6 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.5 06-Mar-2002  thorpej Make sure to pass $MACROS to the roff command.
 1.4 15-Jul-1998  drochner allow to build in ${.OBJDIR}
 1.3 15-Jul-1998  thorpej Make sure the .pic files get installed.
 1.2 15-Jul-1998  thorpej Make this work w/ the docinstall target.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.4 14-Dec-2007  pavel Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.
 1.3 26-Jul-2003  salo branches: 1.3.16; 1.3.18; 1.3.22;
netbsd.org->NetBSD.org
 1.2 14-Jun-2000  cgd fix up NetBSD RCS Ids to match the standard, and the leading comment as
to match as well. No functional changes.
 1.1 15-Jul-1998  thorpej branches: 1.1.8;
Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1.8.1 22-Jun-2000  minoura Sync w/ netbsd-1-5-base.
 1.3.22.1 09-Jan-2008  matt sync with HEAD
 1.3.18.1 06-Jan-2008  wrstuden Catch up to netbsd-4.0 release.
 1.3.16.1 15-Dec-2007  bouyer Pull up following revision(s) (requested by pavel in ticket #1018):
doc/README.files: revision 1.4
distrib/notes/sparc/install: revision 1.53
share/man/man8/afterboot.8: revision 1.34
share/doc/papers/bus_dma/about.me: revision 1.4
share/man/man8/man8.macppc/ofwboot.8: revision 1.8
share/man/man8/man8.macppc/boot.8: revision 1.5
share/man/man8/compat_hpux.8: revision 1.5
Update URLs after website reorganization. patch by OKANO Takayoshi, from
PR 37070.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.1 15-Jul-1998  thorpej Add by bus_dma paper, which was published at the 1998 USENIX conference
in the FREENIX track.
 1.4 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.3 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry branches: 1.2.12;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.12.1 05-Jun-2002  lukem Pull up revision 1.3 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 13-Mar-2000  soren Fix doubled 'the's.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 10-Nov-2021  msaitoh s/ba/be/
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 13-Mar-2000  soren Fix doubled 'the's.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 19-Aug-2020  msaitoh s/ be be / be /
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 13-Mar-2000  soren Fix doubled 'the's.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.3 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry branches: 1.2.12;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.12.1 05-Jun-2002  lukem Pull up revision 1.3 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.7 04-May-2025  andvar s/guarrentees/guarantees/.
 1.6 17-Feb-2025  andvar s/bye/byte/ in comments.
 1.5 07-Aug-2003  agc branches: 1.5.108;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.4 04-Feb-2003  perry utilizing->particular
 1.3 13-Mar-2000  soren Fix doubled 'the's.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5.108.1 02-Aug-2025  perseant Sync with HEAD
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 13-Mar-2000  soren Fix doubled 'the's.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.3 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry branches: 1.2.12;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.12.1 05-Jun-2002  lukem Pull up revision 1.3 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.3 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry branches: 1.2.12;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.12.1 05-Jun-2002  lukem Pull up revision 1.3 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 27-Mar-1995  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 19-Aug-2020  msaitoh s/ be be / be /
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.3 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry branches: 1.2.12;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.12.1 05-Jun-2002  lukem Pull up revision 1.3 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.5 13-Feb-2004  wiz Uppercase CPU, plural is CPUs.
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 13-Mar-2000  soren Fix doubled 'the's.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.3 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry branches: 1.2.12;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.12.1 05-Jun-2002  lukem Pull up revision 1.3 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2 08-Feb-2024  andvar fix misplaced or missing "e" in words with "ment" ending (argument, implement,
increment, decrement, alignment), in comments, documentation, log messages.
 1.1 04-Jul-2001  itojun add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.2 23-Apr-2004  simonb s/the the/the/ (only in sources that aren't regularly imported from
elsewhere).
 1.1 04-Jul-2001  itojun add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.1 04-Jul-2001  itojun add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.1 04-Jul-2001  itojun add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.1 04-Jul-2001  itojun add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.1 04-Jul-2001  itojun add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.4 30-Jun-2004  jmc Add missing NetBSD ID tags
 1.3 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.2 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.1 04-Jul-2001  itojun branches: 1.1.2;
add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.1.2.1 05-Jun-2002  lukem Pull up revision 1.2 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 08-Mar-2012  wiz Use %U for URLs.
 1.1 04-Jul-2001  itojun branches: 1.1.56;
add Freenix 2000 paper on m_pulldown(9), by itojun.
 1.1.56.1 17-Apr-2012  yamt sync with head
 1.7 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.6 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.5 11-Mar-2001  hubertf branches: 1.5.2;
make this format without warning
 1.4 09-Jan-1998  perry branches: 1.4.10;
RCS Id Police.
 1.3 17-Oct-1997  mrg merge lite-2.
 1.2 16-Sep-1994  mycroft Fix bugs.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 27-Apr-1995  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.10.3 11-Jun-2001  he Pull up revision 1.5 (requested by hubertf):
Fixes to documents and build procedure so that ``make paper.ps''
works without errors or warnings.
(Lost commit part of earlier commit set.)
 1.4.10.2 11-Mar-2001  hubertf committed on wrong branch
 1.4.10.1 11-Mar-2001  hubertf make this format without warning
 1.5.2.1 05-Jun-2002  lukem Pull up revision 1.6 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.4 09-Jan-1998  perry RCS Id Police.
 1.3 17-Oct-1997  mrg merge lite-2.
 1.2 16-Sep-1994  mycroft Fix bugs.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 27-Apr-1995  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.4 09-Jan-1998  perry RCS Id Police.
 1.3 17-Oct-1997  mrg merge lite-2.
 1.2 16-Sep-1994  mycroft Fix bugs.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 27-Apr-1995  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.4 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 09-Jan-1998  perry branches: 1.3.12;
RCS Id Police.
 1.2 16-Sep-1994  mycroft Remove hard-coded path.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.12.1 05-Jun-2002  lukem Pull up revision 1.4 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 13-Feb-2004  wiz Uppercase CPU, plural is CPUs.
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 03-May-2003  wiz DMA, not dma nor Dma.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 13-Feb-2004  wiz Uppercase CPU, plural is CPUs.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 13-Feb-2004  wiz Uppercase CPU, plural is CPUs.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 19-Oct-2008  apb Use ${TOOL_AWK} instead of ${AWK} or plain "awk" in make commands.
Pass AWK=${TOOL_AWK:Q} to shell scripts that use awk.
 1.4 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.3 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.2 09-Jan-1998  perry branches: 1.2.12;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.12.1 05-Jun-2002  lukem Pull up revision 1.3 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.14 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.13 11-Jan-2004  lukem branches: 1.13.60; 1.13.72;
check MKDOC instead of MKSHARE
 1.12 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.11 25-Jan-2002  uwe Add missing -ms to format 'Title'.
 1.10 14-Feb-1999  lukem YAbsd.own.mk
 1.9 13-Feb-1999  lukem convert from NOxxx= to MKxxx=no.
include <bsd.own.mk> if testing a MKxxx variable.
 1.8 27-Sep-1998  lukem don't install in /usr/share if NOSHARE is defined
 1.7 22-Oct-1997  enami Make `make install' work with `obj' directory.
 1.6 17-Oct-1997  mrg branches: 1.6.2;
merge lite-2.
 1.5 24-Mar-1997  christos - Makefile cleanups
 1.4 18-Oct-1996  thorpej Use ${INSTALL}.
 1.3 25-Jun-1994  cgd slight mod to the way in-source docs are handled
 1.2 19-Jun-1994  cgd make it work
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.6.2.1 23-Oct-1997  mellon Pull up rev 1.7 from trunk
 1.13.72.1 10-Aug-2014  tls Rebase.
 1.13.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.7 08-Sep-2024  rillig fix a/an grammar in obvious cases
 1.6 01-Oct-2014  christos branches: 1.6.28;
remove extra space I accidentally added.
 1.5 01-Oct-2014  christos Don't use ".af % i" to print page numbers with roman numerals, define a
different register instead so that macros that depend on % being numeric
don't break. From uwe
 1.4 01-Oct-2014  christos explain what's going on with all the spurious errors.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 08-Aug-1994  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.6.28.1 02-Aug-2025  perseant Sync with HEAD
 1.6 30-Sep-2014  christos remove extra tab that broke the table.
 1.5 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.4 26-Dec-2005  perry branches: 1.4.42; 1.4.48;
u_intN_t -> uintN_t

Someone really should update this whole document to reflect current
reality. It is valuable but very, very old.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.48.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4.42.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.5 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.4 13-Feb-2004  wiz branches: 1.4.54; 1.4.60;
Uppercase CPU, plural is CPUs.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.6 11-Jul-2015  kamil 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
 1.5 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.4 07-Aug-2003  agc branches: 1.4.54; 1.4.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 05-Feb-2003  perry "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".
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.6 09-Dec-2021  andvar s/refernce/reference/
 1.5 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.4 07-Aug-2003  agc branches: 1.4.54; 1.4.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 12-Feb-1999  kleink <sys/fcntl.h> -> <fcntl.h>
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.5 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.4 28-Jan-2010  mbalmer branches: 1.4.6; 1.4.12;
Fix language.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.12.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4.6.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.4 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.3 07-Aug-2003  agc branches: 1.3.54; 1.3.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.10 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.9 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.8 06-Oct-2013  dholland branches: 1.8.2;
I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.7 10-Jul-2003  lukem branches: 1.7.54; 1.7.60;
Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.6 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.5 11-Mar-2001  hubertf branches: 1.5.2;
make "make paper.ps" work
 1.4 04-Feb-1998  christos branches: 1.4.10;
Use a variable for soelim, and don't include bsd.obj.mk
 1.3 09-Jan-1998  perry RCS Id Police.
 1.2 21-Dec-1997  christos Make this work with obj dirs.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.10.3 11-Jun-2001  he Pull up revision 1.5 (requested by hubertf):
Fixes to documents and build procedure so that ``make paper.ps''
works without errors or warnings.
(Lost part of earlier commit set.)
 1.4.10.2 11-Mar-2001  hubertf back out rev. 1.4.10.1, committed to wrong branch
 1.4.10.1 11-Mar-2001  hubertf make "make paper.ps" work
 1.5.2.1 05-Jun-2002  lukem Pull up revision 1.6 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.7.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.7.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.8.2.1 10-Aug-2014  tls Rebase.
 1.5 06-Oct-2013  dholland I'm a document, Jim, not a shell script.

Fix this to not use .sy to generate portions of the document.
Instead, generate the necessary bits with sed beforehand.

Apparently -ms is too feeble to be able to generate tables of contents
with automatically generated page numbers, so add the expected page
numbers into the document and make it possible to turn on a
rudimentary mechanism for crosschecking them. (This mechanism still
requires .sy though. Improvements welcome.)

This makes it unnecessary to build the document twice, or to use
groff in unsafe mode.
 1.4 07-Aug-2003  agc branches: 1.4.54; 1.4.60;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 09-Jan-1998  perry RCS Id Police.
 1.2 21-Dec-1997  christos Use 'so instead of .so to prevent soelim expansion.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4.54.1 22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.8 05-Jul-2014  dholland Reorg docs, part 2:
Rename the following reference documents to match their programs:
shell -> sh
viref -> vi

and rename the following to match their topic better:
ipctut -> sockets
ipc -> sockets-advanced

Also, the old "timed" and "timedop" docs are now ref5/timed and
ref8/timed respectively, as the first of these documented the
protocol.
 1.7 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.6 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.5 10-Jul-2003  lukem branches: 1.5.60; 1.5.72;
Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.4 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 09-Jan-1998  perry branches: 1.3.12;
RCS Id Police.
 1.2 21-Dec-1997  christos Make this work with obj directories.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.12.1 05-Jun-2002  lukem Pull up revision 1.4 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.5.72.1 10-Aug-2014  tls Rebase.
 1.5.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 13-Aug-2003  itojun fix bad example of select() - first arg shouldn't be FD_SETSIZE. from openbsd
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 05-Feb-2003  perry "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".
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.8 05-Jul-2014  dholland Reorg docs, part 2:
Rename the following reference documents to match their programs:
shell -> sh
viref -> vi

and rename the following to match their topic better:
ipctut -> sockets
ipc -> sockets-advanced

Also, the old "timed" and "timedop" docs are now ref5/timed and
ref8/timed respectively, as the first of these documented the
protocol.
 1.7 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.6 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.5 10-Jul-2003  lukem branches: 1.5.60; 1.5.72;
Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.4 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 09-Jan-1998  perry branches: 1.3.12;
RCS Id Police.
 1.2 21-Dec-1997  christos Work with obj directories.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.12.1 05-Jun-2002  lukem Pull up revision 1.4 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.5.72.1 10-Aug-2014  tls Rebase.
 1.5.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.21 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.20 29-Nov-2007  mjf branches: 1.20.34; 1.20.46;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.19 11-Jan-2004  lukem branches: 1.19.22;
check MKDOC instead of MKSHARE
 1.18 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.17 14-Feb-1999  lukem yet *more* bsd.own.mk stuff i missed... :(
 1.16 13-Feb-1999  lukem convert from NOxxx= to MKxxx=no.
include <bsd.own.mk> if testing a MKxxx variable.
 1.15 27-Sep-1998  lukem don't install in /usr/share if NOSHARE is defined
 1.14 21-Dec-1997  christos Timed and timedops are in /usr/src/usr.sbin/timed/SMM.doc, not missing.
 1.13 17-Oct-1997  mrg merge lite-2.
 1.12 13-Oct-1997  lukem rcsid fascism
 1.11 24-Mar-1997  christos - Makefile cleanups
 1.10 18-Oct-1996  thorpej Use ${INSTALL}.
 1.9 05-Apr-1996  cgd SMM '03.fsck' has been renamed '03.fsck_ffs'
 1.8 25-Jun-1994  cgd slight mod to the way in-source docs are handled
 1.7 19-Jun-1994  cgd make it work
 1.6 19-Jun-1994  cgd clean up import
 1.5 10-Feb-1994  cgd kill bogus install -d's, and clean slightly
 1.4 30-Sep-1993  jtc Always use `install -d' to make sure destination directory exists & has
correct ownership and permissions.
 1.3 31-Jul-1993  mycroft Add RCS indentifiers.
 1.2 09-Apr-1993  cgd make sure directory to install stuff exists before installing
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.3 28-Apr-1995  mrg 4.4BSD-Lite2
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.19.22.1 09-Jan-2008  matt sync with HEAD
 1.20.46.1 10-Aug-2014  tls Rebase.
 1.20.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4 01-Oct-2014  christos apply the roman numeral page number fix from psd/Title
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.3 08-Aug-1994  mrg 4.4BSD-Lite2
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 13-Feb-2004  wiz Uppercase CPU, plural is CPUs.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 16-Dec-2010  wiz Observe the following spelling:
- wide character (noun)
- wide-character (adjective)

Inspired by jmc@OpenBSD.
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 10-Jan-1998  perry get rid of secretmail residue -- suggested in pr-4568 from Carl Shapiro
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.8 13-Feb-2004  wiz Uppercase CPU, plural is CPUs.
 1.7 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.6 11-Mar-2001  hubertf fix typo
 1.5 10-Jan-1998  perry branches: 1.5.10;
get rid of secretmail residue -- suggested in pr-4568 from Carl Shapiro
 1.4 09-Jan-1998  perry RCS Id Police.
 1.3 17-Oct-1997  mrg merge lite-2.
 1.2 23-Sep-1994  mycroft Use POSIX form of kill(1).
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 28-Apr-1995  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5.10.3 13-Mar-2001  he Pull up revision 1.6 (requested by hubertf):
Fixes to documents and build procedure so that ``make paper.ps''
works without errors or warnings.
 1.5.10.2 11-Mar-2001  hubertf revert rev. 1.5.10.1, committed to wrong branch
 1.5.10.1 11-Mar-2001  hubertf fix typo
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 13-Feb-2004  wiz Uppercase CPU, plural is CPUs.
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 03-May-2003  wiz DMA, not dma nor Dma.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.13 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.12 10-Jul-2003  lukem branches: 1.12.60; 1.12.72;
Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.11 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.10 09-Jan-1998  perry branches: 1.10.12;
RCS Id Police.
 1.9 21-Dec-1997  christos Make them use objdirs.
 1.8 24-Mar-1997  christos - Makefile cleanups
 1.7 18-Oct-1996  thorpej Use ${INSTALL}.
 1.6 19-Jun-1994  cgd some more things not in Lite
 1.5 24-Jan-1994  cgd PRINTER -> PRINTER_TYPE
 1.4 31-Jul-1993  mycroft Add RCS indentifiers.
 1.3 04-Jul-1993  cgd allow docs to make an obj dir and build properly with it.
 1.2 09-Jun-1993  cgd make documentation build into ps files. this works, mostly...
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.10.12.1 05-Jun-2002  lukem Pull up revision 1.11 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.12.72.1 10-Aug-2014  tls Rebase.
 1.12.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.2 10-Jan-1998  perry get rid of secretmail residue -- suggested in pr-4568 from Carl Shapiro
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.9 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.8 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.7 09-Jan-1998  perry branches: 1.7.72; 1.7.84;
RCS Id Police.
 1.6 19-Jun-1994  cgd clean up import
 1.5 24-Jan-1994  cgd PRINTER -> PRINTER_TYPE
 1.4 31-Jul-1993  mycroft Add RCS indentifiers.
 1.3 04-Jul-1993  cgd allow docs to make an obj dir and build properly with it.
 1.2 09-Jun-1993  cgd make documentation build into ps files. this works, mostly...
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.7.84.1 10-Aug-2014  tls Rebase.
 1.7.72.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.7 14-Aug-2012  dholland Some edits, prompted by suggestions from Edgar Fuss.
 1.6 21-May-2012  wiz Typos, capitalization, and file systems.
(Not reviewed at the content level.)
 1.5 21-May-2012  dholland Update. comments/suggestions/edits please.

This should be pulled up to netbsd-6 once the dust (if any) settles.
 1.4 13-Feb-2004  wiz branches: 1.4.54; 1.4.56;
Uppercase CPU, plural is CPUs.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.4.56.1 15-Aug-2012  riz Pull up following revision(s) (requested by dholland in ticket #499):
share/doc/smm/04.quotas/quotas.ms: revision 1.5
share/doc/smm/04.quotas/quotas.ms: revision 1.6
share/doc/smm/04.quotas/quotas.ms: revision 1.7
Update. comments/suggestions/edits please.
This should be pulled up to netbsd-6 once the dust (if any) settles.
Typos, capitalization, and file systems.
(Not reviewed at the content level.)
Some edits, prompted by suggestions from Edgar Fuss.
 1.4.54.2 30-Oct-2012  yamt sync with head
 1.4.54.1 23-May-2012  yamt sync with head.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 29-Apr-1995  mrg 4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.7 05-Jul-2014  dholland Reorg docs, part 3:
Move the documents that are papers to /usr/share/doc/papers.
Give them suitable names (including the author and year).

The key property of papers that distinguishes them from documentation
is that they're historical: they're published at a particular time and
aren't updated or maintained. (Except cosmetically.)

We should only ship papers that are of interest to users, either for
historical perspective or because they're the original research
writeup of stuff that went into the system and is still pertinent.

The ffs papers clearly meet this standard; the other one here (about
passwords, in 1978) is probably past its sell-by date.
 1.6 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.5 10-Jul-2003  lukem branches: 1.5.60; 1.5.72;
Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.4 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 09-Jan-1998  perry branches: 1.3.12;
RCS Id Police.
 1.2 21-Dec-1997  christos Make them use objdirs.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.12.1 05-Jun-2002  lukem Pull up revision 1.4 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.5.72.1 10-Aug-2014  tls Rebase.
 1.5.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.3 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.2 09-Jan-1998  perry branches: 1.2.72; 1.2.84;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.84.1 10-Aug-2014  tls Rebase.
 1.2.72.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 05-Jul-2014  dholland Reorg docs, part 3:
Move the documents that are papers to /usr/share/doc/papers.
Give them suitable names (including the author and year).

The key property of papers that distinguishes them from documentation
is that they're historical: they're published at a particular time and
aren't updated or maintained. (Except cosmetically.)

We should only ship papers that are of interest to users, either for
historical perspective or because they're the original research
writeup of stuff that went into the system and is still pertinent.

The ffs papers clearly meet this standard; the other one here (about
passwords, in 1978) is probably past its sell-by date.
 1.2 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.1 29-Nov-2007  mjf branches: 1.1.4; 1.1.36; 1.1.48;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.48.1 10-Aug-2014  tls Rebase.
 1.1.36.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file Makefile was added on branch matt-armv6 on 2008-01-09 01:38:47 +0000
 1.2 02-Jun-2024  andvar Fix triple l typos in warning message and documentation.
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file password.ms was added on branch matt-armv6 on 2008-01-09 01:38:47 +0000
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 05-Feb-2003  perry "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".
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 05-Feb-2003  perry "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".
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.6 05-Feb-2019  christos comment out the IFF_TRAILERS stuff that is no longer relevant and add
the missing flags.
 1.5 07-Aug-2003  agc branches: 1.5.96;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.4 03-May-2003  wiz DMA, not dma nor Dma.
 1.3 05-Feb-2003  perry "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".
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5.96.1 10-Jun-2019  christos Sync with HEAD
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.7 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.6 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.5 10-Jul-2003  lukem branches: 1.5.60; 1.5.72;
Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.4 02-Jun-2002  pooka Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.3 09-Jan-1998  perry branches: 1.3.12;
RCS Id Police.
 1.2 21-Dec-1997  christos Make them use objdirs.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.12.1 05-Jun-2002  lukem Pull up revision 1.4 (requested by pooka in ticket #143):
Reflect bsd.doc.mk rev 1.52 here, and make sure that ROFF uses MACROS.
This has the effect of the postscript output actually being readable.
 1.5.72.1 10-Aug-2014  tls Rebase.
 1.5.60.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 05-Feb-2003  perry "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".
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3 06-Jul-2014  dholland New sentence, new line.
 1.2 06-Jul-2014  dholland Minor updates - I've attempted to catch the most glaringly outdated
statements but haven't made any effort yet to rewrite the main content.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file 0.t was added on branch matt-armv6 on 2008-01-09 01:38:48 +0000
 1.3 06-Jul-2014  dholland New sentence, new line.
 1.2 06-Jul-2014  dholland Minor updates - I've attempted to catch the most glaringly outdated
statements but haven't made any effort yet to rewrite the main content.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file 1.t was added on branch matt-armv6 on 2008-01-09 01:38:48 +0000
 1.3 06-Jul-2014  dholland New sentence, new line.
 1.2 06-Jul-2014  dholland Minor updates - I've attempted to catch the most glaringly outdated
statements but haven't made any effort yet to rewrite the main content.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file 2.t was added on branch matt-armv6 on 2008-01-09 01:38:48 +0000
 1.3 06-Jul-2014  dholland New sentence, new line.
 1.2 06-Jul-2014  dholland Minor updates - I've attempted to catch the most glaringly outdated
statements but haven't made any effort yet to rewrite the main content.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file 3.t was added on branch matt-armv6 on 2008-01-09 01:38:49 +0000
 1.3 06-Jul-2014  dholland New sentence, new line.
 1.2 06-Jul-2014  dholland Minor updates - I've attempted to catch the most glaringly outdated
statements but haven't made any effort yet to rewrite the main content.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file 4.t was added on branch matt-armv6 on 2008-01-09 01:38:49 +0000
 1.2 06-Jul-2014  dholland New sentence, new line.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file 5.t was added on branch matt-armv6 on 2008-01-09 01:38:50 +0000
 1.3 06-Jul-2014  dholland New sentence, new line.
 1.2 06-Jul-2014  dholland Minor updates - I've attempted to catch the most glaringly outdated
statements but haven't made any effort yet to rewrite the main content.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file 6.t was added on branch matt-armv6 on 2008-01-09 01:38:50 +0000
 1.3 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.2 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file Makefile was added on branch matt-armv6 on 2008-01-09 01:38:50 +0000
 1.2 06-Jul-2014  dholland New sentence, new line.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file a.t was added on branch matt-armv6 on 2008-01-09 01:38:51 +0000
 1.2 06-Jul-2014  dholland New sentence, new line.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file b.t was added on branch matt-armv6 on 2008-01-09 01:38:51 +0000
 1.1 18-Dec-2007  garbled branches: 1.1.2;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file c.t was added on branch matt-armv6 on 2008-01-09 01:38:51 +0000
 1.2 06-Jul-2014  dholland New sentence, new line.
 1.1 18-Dec-2007  garbled branches: 1.1.2; 1.1.34; 1.1.46;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.46.1 10-Aug-2014  tls Rebase.
 1.1.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file d.t was added on branch matt-armv6 on 2008-01-09 01:38:52 +0000
 1.1 18-Dec-2007  garbled branches: 1.1.2;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file e.t was added on branch matt-armv6 on 2008-01-09 01:38:52 +0000
 1.1 18-Dec-2007  garbled branches: 1.1.2;
Import the config documentation from FreeBSD into the smm. Rather than
name the directory "02.config" as it historically was, name it config, so
that if we ever want to update this book for the modern age, we can move
chapters around, delete them, etc, without mass confusion.
 1.1.2.2 09-Jan-2008  matt sync with HEAD
 1.1.2.1 18-Dec-2007  matt file spell.ok was added on branch matt-armv6 on 2008-01-09 01:38:52 +0000
 1.6 05-Apr-2024  christos spacify the paper size for PostScript
 1.5 01-Aug-2003  lukem Rework how dependency generation is performed:

* DPSRCS contains extra dependencies, but is _NOT_ added to CLEANFILES.
This is a change of behaviour. If a Makefile wants the clean semantics
it must specifically append to CLEANFILES.
Resolves PR toolchain/5204.

* To recap: .d (depend) files are generated for all files in SRCS and DPSRCS
that have a suffix of: .c .m .s .S .C .cc .cpp .cxx

* If YHEADER is set, automatically add the .y->.h to DPSRCS & CLEANFILES

* Ensure that ${OBJS} ${POBJS} ${LOBJS} ${SOBJS} *.d depend upon ${DPSRCS}

* Deprecate the (short lived) DEPENDSRCS


Update the various Makefiles to these new semantics; generally either
adding to CLEANFILES (because DPSRCS doesn't do that anymore), or replacing
specific .o dependencies with DPSRCS entries.

Tested with "make -j 8 distribution" and "make distribution".
 1.4 28-Jul-2003  lukem Use ${DEPENDSRCS} as a target instead of .depend, now that
<bsd.dep.mk> builds .depend from .dep files.
 1.3 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.2 01-Jun-1999  ross Make this work with obj dirs.
 1.1 01-Jun-1999  jwise Add a Makefile, as suggested by hubertf. The Makefile cribs brazenly from^W^W^W
is heavily influenced by src/distrib/notes/Makefile.inc, from Ross Harvey.

While here, fix a typo and nuke some trailing spaces, to make mdoc more comfortable.
 1.9 30-Jan-2002  jwise Change wording of note explaining that SCCS (part of the xcu5 DEVELOPER option)
is not provided by NetBSD.

Note that CSSC is in pkgsrc, and that CVS, as with RCS is now part of the base
system, not of pkgsrc.
 1.8 07-Jul-2000  tv Remove the text that GNU ar assumes files are object files. GNU ar is
perfectly happy with non-object files (they are of type "binary" and are
not scanned for ranlib symbols).

Also add some entries for false, true, bg, fg. More to come....
 1.7 09-Jul-1999  jwise Minor change to at(1) description. Time to get back to work on this.
 1.6 01-Jun-1999  jwise Add stub entries for all remaining commands and utilities. Now back to
the real work!
 1.5 01-Jun-1999  ross Remove .Tn from lower case name. `.Tn X/Open' will DTWT.
 1.4 01-Jun-1999  jwise Add a Makefile, as suggested by hubertf. The Makefile cribs brazenly from^W^W^W
is heavily influenced by src/distrib/notes/Makefile.inc, from Ross Harvey.

While here, fix a typo and nuke some trailing spaces, to make mdoc more comfortable.
 1.3 01-Jun-1999  jwise Add an appropriate copyright statement. This will be assigned to TNF
shortly.
 1.2 01-Jun-1999  jwise Add stub entries for a bunch more utilities.
 1.1 01-Jun-1999  jwise branches: 1.1.1;
Initial revision
 1.1.1.1 01-Jun-1999  jwise Initial import of a document detailing NetBSD's compliance with the
X/Open Commands and Utilities, Issue 5 (XCU5) standard, as well as a
directory structure in which documents detailing NetBSD's compliance
with other standards from X/Open and other bodies can be imported.

The XCU5 documentation presented here is _far_ from finished, but I wanted
to get something in tree for people to review and comment upon.
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.25 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.24 29-Nov-2007  mjf branches: 1.24.34; 1.24.46;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.23 06-Aug-2004  mycroft branches: 1.23.16;
Allow docs elsewhere in tree to be built with "make" after installation.
 1.22 06-Aug-2004  mycroft Update the list of missing stuff.
 1.21 11-Jan-2004  lukem check MKDOC instead of MKSHARE
 1.20 10-Jul-2003  lukem Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO". The new variables are:
TOOL_ASN1_COMPILE TOOL_CAP_MKDB TOOL_CAT TOOL_CKSUM TOOL_COMPILE_ET
TOOL_CONFIG TOOL_CRUNCHGEN TOOL_CTAGS TOOL_DB TOOL_EQN TOOL_FGEN
TOOL_GENCAT TOOL_GROFF TOOL_HEXDUMP TOOL_INDXBIB TOOL_INSTALLBOOT
TOOL_INSTALL_INFO TOOL_M4 TOOL_MAKEFS TOOL_MAKEINFO TOOL_MAKEWHATIS
TOOL_MDSETIMAGE TOOL_MENUC TOOL_MKCSMAPPER TOOL_MKESDB
TOOL_MKLOCALE TOOL_MKMAGIC TOOL_MKTEMP TOOL_MSGC TOOL_MTREE
TOOL_PAX TOOL_PIC TOOL_PREPMKBOOTIMAGE TOOL_PWD_MKDB TOOL_REFER
TOOL_ROFF_ASCII TOOL_ROFF_DVI TOOL_ROFF_HTML TOOL_ROFF_PS
TOOL_ROFF_RAW TOOL_RPCGEN TOOL_SOELIM TOOL_SUNLABEL TOOL_TBL
TOOL_UUDECODE TOOL_VGRIND TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
TOOL_FOO?= foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
TOOL_FOO= ${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.
 1.19 14-Feb-1999  lukem yet *more* bsd.own.mk stuff i missed... :(
 1.18 13-Feb-1999  lukem convert from NOxxx= to MKxxx=no.
include <bsd.own.mk> if testing a MKxxx variable.
 1.17 27-Sep-1998  lukem don't install in /usr/share if NOSHARE is defined
 1.16 09-Jan-1998  perry RCS Id Police.
 1.15 17-Oct-1997  mrg merge lite-2.
 1.14 24-Mar-1997  christos - Makefile cleanups
 1.13 18-Oct-1996  thorpej Use ${INSTALL}.
 1.12 30-Sep-1996  christos Fix PR/2538: Remove the 04.csh reference from the Makefile. This doc is in
USD.doc in src/bin/csh.
 1.11 26-Dec-1994  briggs Finish change to allow 04.csh to be optional.
 1.10 18-Dec-1994  cgd csh docs installed along with csh binary, and sources live with csh sources.
 1.9 25-Jun-1994  cgd slight mod to the way in-source docs are handled
 1.8 19-Jun-1994  cgd make it work
 1.7 19-Jun-1994  cgd clean up import
 1.6 10-Feb-1994  cgd kill bogus install -d's, and clean slightly
 1.5 30-Sep-1993  jtc Always use `install -d' to make sure destination directory exists & has
correct ownership and permissions.
 1.4 31-Jul-1993  mycroft Add RCS indentifiers.
 1.3 09-Jun-1993  cgd make documentation build into ps files. this works, mostly...
 1.2 09-Apr-1993  cgd make sure directory to install stuff exists before installing
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.3 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.23.16.1 09-Jan-2008  matt sync with HEAD
 1.24.46.1 10-Aug-2014  tls Rebase.
 1.24.34.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.5 08-Sep-2024  rillig fix a/an grammar in obvious cases
 1.4 01-Oct-2014  christos branches: 1.4.28;
apply the roman numeral page number fix from psd/Title
 1.3 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.3 08-Aug-1994  mrg 4.4BSD-Lite2
 1.1.1.2 19-Jun-1994  cgd new doc set from Lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.4.28.1 02-Aug-2025  perseant Sync with HEAD
 1.2 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.1 29-Nov-2007  mjf branches: 1.1.4; 1.1.36; 1.1.48;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.48.1 10-Aug-2014  tls Rebase.
 1.1.36.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file Makefile was added on branch matt-armv6 on 2008-01-09 01:38:53 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file u.mac was added on branch matt-armv6 on 2008-01-09 01:38:53 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file u0 was added on branch matt-armv6 on 2008-01-09 01:38:53 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file u1 was added on branch matt-armv6 on 2008-01-09 01:38:54 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file u2 was added on branch matt-armv6 on 2008-01-09 01:38:54 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file u3 was added on branch matt-armv6 on 2008-01-09 01:38:54 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file u4 was added on branch matt-armv6 on 2008-01-09 01:38:55 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file u5 was added on branch matt-armv6 on 2008-01-09 01:38:55 +0000
 1.3 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.2 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.1 29-Nov-2007  mjf branches: 1.1.4; 1.1.36; 1.1.48;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.48.1 10-Aug-2014  tls Rebase.
 1.1.36.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file Makefile was added on branch matt-armv6 on 2008-01-09 01:38:55 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file fig1.pic was added on branch matt-armv6 on 2008-01-09 01:38:55 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file fig1.xfig was added on branch matt-armv6 on 2008-01-09 01:38:56 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file ms was added on branch matt-armv6 on 2008-01-09 01:38:56 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file refcard was added on branch matt-armv6 on 2008-01-09 01:38:56 +0000
 1.1 29-Nov-2007  mjf branches: 1.1.4;
Commit Caldera licensed documentation from 4.4BSD. This was taken from the
OpenBSD tree.

No objections on netbsd-docs.
 1.1.4.2 09-Jan-2008  matt sync with HEAD
 1.1.4.1 29-Nov-2007  matt file refcard.bad was added on branch matt-armv6 on 2008-01-09 01:38:57 +0000
 1.6 25-Nov-2015  christos PR/50360: Thomas Klausner: Fix MKREPRO builds
 1.5 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.4 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.3 09-Jan-1998  perry branches: 1.3.72; 1.3.84;
RCS Id Police.
 1.2 30-Jun-1994  cgd use the ms macro package, rather than the msU one. from
Luke Mewburn <lm@karybdis.cs.rmit.OZ.AU>/
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.3.84.1 10-Aug-2014  tls Rebase.
 1.3.72.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.5 25-Nov-2015  christos PR/50360: Thomas Klausner: Fix MKREPRO builds
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 04-Dec-2001  wiz Replace some misuses of "then" with "than".
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.5 25-Nov-2015  christos PR/50360: Thomas Klausner: Fix MKREPRO builds
 1.4 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.3 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.2 09-Jan-1998  perry branches: 1.2.72; 1.2.84;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.84.1 10-Aug-2014  tls Rebase.
 1.2.72.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.5 25-Nov-2015  christos PR/50360: Thomas Klausner: Fix MKREPRO builds
 1.4 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.3 05-May-1998  mycroft Update -me revision number.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg branches: 1.1.1.2.2;
4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1.1.2.2.1 05-May-1998  mycroft Pull up 1.3, per request of mycroft.
 1.5 25-Nov-2015  christos PR/50360: Thomas Klausner: Fix MKREPRO builds
 1.4 05-Jul-2014  dholland Reorg docs, part 1:
Move all the reference manuals to subdirs of /usr/share/doc/reference.
We have subdirs ref1-ref9, corresponding to man page sections 1-9.

Everything that's the reference manual for a program (sections 1, 6,
8), C interface (sections 2, 3), driver or file system (section 4),
format or configuration (section 5), or kernel internal interface
(section 9) belongs in here.

Section 7 is a little less clear: some things that might go in section
7 if they were a man page aren't really reference manuals. So I'm only
putting things in reference section 7 that are (to me) clearly
reference material, rather than e.g. tutorials, guides, FAQs, etc.
This obviously leaves some room for debate, especially without first
editing the docs with this distinction in mind, but if people hate
what I've done things can always be moved again.

Note also that while roff macro man pages traditionally go in section
7, I have put all the roff documentation (macros, tools, etc.) in one
place in reference/ref1/roff. This will make it easier to find and
also easier to edit it into some kind of coherent form.
 1.3 05-Jul-2014  dholland Rework /usr/share/doc.

Update the <bsd.doc.mk> infrastructure, and update the docs to match
the new infrastructure.

- Build and install text, ps, pdf, and/or html, not roff sources.

- Don't wire the chapter numbers into the build system, or use them in
the installed pathnames. This didn't matter much when the docs were a
museum, but now that we're theoretically going to start maintaining
them again, we're going to add and remove documents periodically and
having the chapter numbers baked in creates a lot of thrashing for no
purpose.

- Specify the document name explicitly, rather than implicitly in a
path. Use this name (instead of other random strings) as the name
of the installed files.

- Specify the document section, which is the subdirectory of
/usr/share/doc to install into.

- Allow multiple subdocuments. (That is, multiple documents in one
output directory.)

- Enumerate the .png files groff emits along with html so they can be
installed.

- Remove assorted hand-rolled rules for running roff and roff widgetry
and add enough variable settings to make these unnecessary. This
includes support for
- explicit use of soelim
- refer
- tbl
- pic
- eqn

- Forcibly apply at least minimal amounts of sanity to certain
autogenerated roff files.

- Don't exclude USD.doc, SMM.doc, and PSD.doc directories from the
build, as they now actually do stuff.

Note: currently we can't generate pdf. This turns out to be a
nontrivial problem with no immediate solution forthcoming. So for now,
as a workaround, install compressed .ps as the printable form.
 1.2 09-Jan-1998  perry branches: 1.2.72; 1.2.84;
RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.2.84.1 10-Aug-2014  tls Rebase.
 1.2.72.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.10 23-Dec-2015  wiz Hardcode some dates to make this more MKREPRO safe.
 1.9 05-Dec-2015  wiz Fix a date to make this more reproducible.
 1.8 25-Nov-2015  christos PR/50360: Thomas Klausner: Fix MKREPRO builds
 1.7 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.6 05-Feb-1999  ross Make this work with groff. Regression tested on BTL (well, Solaris) troff.
 1.5 05-May-1998  mycroft Update -me revision number.
 1.4 05-May-1998  mycroft Oops; fix a couple of references to the superscript macros in the summary.
 1.3 05-May-1998  mycroft Update for changes to tmac.e to work with groff.
 1.2 09-Jan-1998  perry RCS Id Police.
 1.1 19-Jun-1994  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg branches: 1.1.1.2.2;
4.4BSD-Lite2
 1.1.1.1 19-Jun-1994  cgd new doc set from Lite
 1.1.1.2.2.1 05-May-1998  mycroft Pull up 1.3-1.5, per request of mycroft.

RSS XML Feed