Home | History | Annotate | only in /src/share/doc/smm/01.setup
History log of /src/share/doc/smm/01.setup
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 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

RSS XML Feed