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.
