Home | History | Annotate | only in /src/share/doc/usd
History log of /src/share/doc/usd
RevisionDateAuthorComments
 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