From 03270070d6dcf506ba1a1f8dc4ec596e5a45f344 Mon Sep 17 00:00:00 2001 From: dholland Date: Sat, 5 Jul 2014 19:22:02 +0000 Subject: Rework /usr/share/doc. Update the 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. --- rogue/USD.doc/Makefile | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) (limited to 'rogue/USD.doc/Makefile') diff --git a/rogue/USD.doc/Makefile b/rogue/USD.doc/Makefile index 38881ba9..f1b5995b 100644 --- a/rogue/USD.doc/Makefile +++ b/rogue/USD.doc/Makefile @@ -1,11 +1,10 @@ -# $NetBSD: Makefile,v 1.5 2013/02/17 12:17:40 jmcneill Exp $ +# $NetBSD: Makefile,v 1.6 2014/07/05 19:22:03 dholland Exp $ # @(#)Makefile 8.1 (Berkeley) 6/8/93 -DIR= usd/30.rogue +SECTION=usd +ARTICLE=rogue SRCS= rogue.me MACROS= -me - -paper.ps: ${SRCS} - ${TOOL_TBL} ${SRCS} | ${TOOL_ROFF_PS} ${MACROS} > ${.TARGET} +ROFF_TBL=yes .include -- cgit v1.2.3-56-ge451