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.

2 files changed, 5 insertions, 8 deletions

diff --git a/trek/Makefile b/trek/Makefile
index c9371b2b..b0cb2996 100644
--- a/trek/Makefile
+++ b/trek/Makefile
@@ -1,4 +1,4 @@
-#	$NetBSD: Makefile,v 1.14 2011/08/16 11:28:18 christos Exp $
+#	$NetBSD: Makefile,v 1.15 2014/07/05 19:22:03 dholland Exp $
 #	@(#)Makefile	8.1 (Berkeley) 5/31/93
 
 PROG=	trek
@@ -15,9 +15,7 @@ DPADD=	${LIBM}
 LDADD=	-lm
 HIDEGAME=hidegame
 
-.if make(install)
 SUBDIR+=USD.doc
-.endif
 
 COPTS.getpar.c += -Wno-format-nonliteral
 
diff --git a/trek/USD.doc/Makefile b/trek/USD.doc/Makefile
index f191202c..ce926434 100644
--- a/trek/USD.doc/Makefile
+++ b/trek/USD.doc/Makefile
@@ -1,11 +1,10 @@
-#	$NetBSD: Makefile,v 1.4 2003/07/10 10:34:20 lukem Exp $
+#	$NetBSD: Makefile,v 1.5 2014/07/05 19:22:03 dholland Exp $
 #	@(#)Makefile	8.1 (Berkeley) 6/8/93
 
-DIR=	usd/31.trek
+SECTION=usd
+ARTICLE=trek
 SRCS=	trek.me
 MACROS=	-me
-
-paper.ps: ${SRCS}
-	${TOOL_TBL} ${SRCS} | ${TOOL_ROFF_PS} ${MACROS} > ${.TARGET}
+ROFF_TBL=yes
 
 .include <bsd.doc.mk>