CVS commit: src

["David A. Holland" <dholland%netbsd.org@localhost>]

Module Name:    src
Committed By:   dholland
Date:           Sat Jul  5 19:22:05 UTC 2014

Modified Files:
        src/bin/csh/USD.doc: Makefile
        src/bin/sh/USD.doc: Makefile
        src/external/bsd/nvi/docs/USD.doc/edit: Makefile
        src/external/bsd/nvi/docs/USD.doc/exref: Makefile
        src/external/bsd/nvi/docs/USD.doc/vi.ref: Makefile
        src/external/bsd/nvi/docs/USD.doc/vitut: Makefile
        src/games/rogue: Makefile
        src/games/rogue/USD.doc: Makefile
        src/games/trek: Makefile
        src/games/trek/USD.doc: Makefile
        src/lib/libcurses/PSD.doc: Makefile
        src/sbin/fsck_ffs: Makefile
        src/sbin/fsck_ffs/SMM.doc: Makefile
        src/share/doc: Makefile
        src/share/doc/psd: Makefile
        src/share/doc/psd/05.sysman: Makefile
        src/share/doc/psd/20.ipctut: Makefile
        src/share/doc/psd/21.ipc: Makefile
        src/share/doc/smm: Makefile
        src/share/doc/smm/01.setup: Makefile
        src/share/doc/smm/04.quotas: Makefile
        src/share/doc/smm/05.fastfs: Makefile
        src/share/doc/smm/06.nfs: Makefile
        src/share/doc/smm/17.password: Makefile
        src/share/doc/smm/18.net: Makefile
        src/share/doc/smm/config: Makefile
        src/share/doc/usd: Makefile
        src/share/doc/usd/01.begin: Makefile
        src/share/doc/usd/17.msmacros: Makefile
        src/share/doc/usd/18.msdiffs: Makefile
        src/share/doc/usd/19.memacros: Makefile
        src/share/doc/usd/20.meref: Makefile
        src/share/mk: bsd.doc.mk bsd.own.mk
        src/usr.bin/gprof: Makefile
        src/usr.bin/gprof/PSD.doc: Makefile
        src/usr.bin/m4/PSD.doc: Makefile
        src/usr.bin/mail: Makefile
        src/usr.bin/mail/USD.doc: Makefile
        src/usr.bin/make: Makefile
        src/usr.bin/make/PSD.doc: Makefile
        src/usr.sbin/lpr: Makefile
        src/usr.sbin/lpr/SMM.doc: Makefile
        src/usr.sbin/timed: Makefile
        src/usr.sbin/timed/SMM.doc/timed: Makefile
        src/usr.sbin/timed/SMM.doc/timedop: Makefile
Added Files:
        src/bin/sh/USD.doc: referargs

Log Message:
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.


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/bin/csh/USD.doc/Makefile
cvs rdiff -u -r1.1 -r1.2 src/bin/sh/USD.doc/Makefile
cvs rdiff -u -r0 -r1.1 src/bin/sh/USD.doc/referargs
cvs rdiff -u -r1.1 -r1.2 src/external/bsd/nvi/docs/USD.doc/edit/Makefile
cvs rdiff -u -r1.1 -r1.2 src/external/bsd/nvi/docs/USD.doc/exref/Makefile
cvs rdiff -u -r1.1 -r1.2 src/external/bsd/nvi/docs/USD.doc/vi.ref/Makefile
cvs rdiff -u -r1.1 -r1.2 src/external/bsd/nvi/docs/USD.doc/vitut/Makefile
cvs rdiff -u -r1.18 -r1.19 src/games/rogue/Makefile
cvs rdiff -u -r1.5 -r1.6 src/games/rogue/USD.doc/Makefile
cvs rdiff -u -r1.14 -r1.15 src/games/trek/Makefile
cvs rdiff -u -r1.4 -r1.5 src/games/trek/USD.doc/Makefile
cvs rdiff -u -r1.10 -r1.11 src/lib/libcurses/PSD.doc/Makefile
cvs rdiff -u -r1.44 -r1.45 src/sbin/fsck_ffs/Makefile
cvs rdiff -u -r1.3 -r1.4 src/sbin/fsck_ffs/SMM.doc/Makefile
cvs rdiff -u -r1.10 -r1.11 src/share/doc/Makefile
cvs rdiff -u -r1.13 -r1.14 src/share/doc/psd/Makefile
cvs rdiff -u -r1.8 -r1.9 src/share/doc/psd/05.sysman/Makefile
cvs rdiff -u -r1.5 -r1.6 src/share/doc/psd/20.ipctut/Makefile
cvs rdiff -u -r1.5 -r1.6 src/share/doc/psd/21.ipc/Makefile
cvs rdiff -u -r1.20 -r1.21 src/share/doc/smm/Makefile
cvs rdiff -u -r1.12 -r1.13 src/share/doc/smm/01.setup/Makefile
cvs rdiff -u -r1.7 -r1.8 src/share/doc/smm/04.quotas/Makefile
cvs rdiff -u -r1.5 -r1.6 src/share/doc/smm/05.fastfs/Makefile
cvs rdiff -u -r1.2 -r1.3 src/share/doc/smm/06.nfs/Makefile
cvs rdiff -u -r1.1 -r1.2 src/share/doc/smm/17.password/Makefile
cvs rdiff -u -r1.5 -r1.6 src/share/doc/smm/18.net/Makefile
cvs rdiff -u -r1.1 -r1.2 src/share/doc/smm/config/Makefile
cvs rdiff -u -r1.24 -r1.25 src/share/doc/usd/Makefile
cvs rdiff -u -r1.1 -r1.2 src/share/doc/usd/01.begin/Makefile
cvs rdiff -u -r1.1 -r1.2 src/share/doc/usd/17.msmacros/Makefile
cvs rdiff -u -r1.3 -r1.4 src/share/doc/usd/18.msdiffs/Makefile
cvs rdiff -u -r1.2 -r1.3 src/share/doc/usd/19.memacros/Makefile
cvs rdiff -u -r1.2 -r1.3 src/share/doc/usd/20.meref/Makefile
cvs rdiff -u -r1.64 -r1.65 src/share/mk/bsd.doc.mk
cvs rdiff -u -r1.817 -r1.818 src/share/mk/bsd.own.mk
cvs rdiff -u -r1.27 -r1.28 src/usr.bin/gprof/Makefile
cvs rdiff -u -r1.6 -r1.7 src/usr.bin/gprof/PSD.doc/Makefile
cvs rdiff -u -r1.3 -r1.4 src/usr.bin/m4/PSD.doc/Makefile
cvs rdiff -u -r1.35 -r1.36 src/usr.bin/mail/Makefile
cvs rdiff -u -r1.5 -r1.6 src/usr.bin/mail/USD.doc/Makefile
cvs rdiff -u -r1.56 -r1.57 src/usr.bin/make/Makefile
cvs rdiff -u -r1.2 -r1.3 src/usr.bin/make/PSD.doc/Makefile
cvs rdiff -u -r1.10 -r1.11 src/usr.sbin/lpr/Makefile
cvs rdiff -u -r1.5 -r1.6 src/usr.sbin/lpr/SMM.doc/Makefile
cvs rdiff -u -r1.4 -r1.5 src/usr.sbin/timed/Makefile
cvs rdiff -u -r1.5 -r1.6 src/usr.sbin/timed/SMM.doc/timed/Makefile
cvs rdiff -u -r1.2 -r1.3 src/usr.sbin/timed/SMM.doc/timedop/Makefile

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.