Introduce a new handbook-specific knob ``WITH_PGPKEYS'' and add the

relevant functions to the DSSSL stylesheet.

The default behavior is for print output formats to just display PGP
fingerprints unless you use `make WITH_PGPKEYS=1 FORMATS=ps'.  This new
default behavior reduces the size of Appendix E from 52 pages to 9
pages, and that could be trimmed down more with a more efficient
layout for the fingerprints (does each entry really warrant a new
section header?)

Knob requested by: Chris Costello
Discussed on: -doc
This commit is contained in:
Murray Stokely 2001-07-12 01:40:31 +00:00
parent 9b75f32409
commit 5c47dd8654
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=9855
2 changed files with 32 additions and 2 deletions
en_US.ISO8859-1/books/handbook
share/sgml

View file

@ -1,9 +1,20 @@
#
# $FreeBSD: doc/en_US.ISO8859-1/books/handbook/Makefile,v 1.35 2001/06/30 14:46:48 nik Exp $
# $FreeBSD: doc/en_US.ISO8859-1/books/handbook/Makefile,v 1.36 2001/07/10 02:33:47 murray Exp $
#
# Build the FreeBSD Handbook.
#
# ------------------------------------------------------------------------
#
# Handbook-specific variables
#
# WITH_PGPKEYS The print version of the handbook only prints PGP
# fingerprints by default. If you would like for the
# entire key to be displayed, then set this variable.
# This option has no affect on the HTML formats.
#
# ------------------------------------------------------------------------
MAINTAINER=nik@FreeBSD.org
DOC?= book
@ -76,4 +87,12 @@ book.pdf: book.ps
ps2pdf book.ps book.pdf
DOC_PREFIX?= ${.CURDIR}/../../..
#
# Handbook-specific variables
#
.if defined(WITH_PGPKEYS)
JADEFLAGS+= -V withpgpkeys
.endif
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

View file

@ -1,4 +1,4 @@
<!-- $FreeBSD: doc/share/sgml/freebsd.dsl,v 1.33 2001/06/18 14:29:16 nik Exp $ -->
<!-- $FreeBSD: doc/share/sgml/freebsd.dsl,v 1.34 2001/06/24 02:46:40 murray Exp $ -->
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
<!ENTITY % output.html "IGNORE">
@ -195,11 +195,22 @@
<!-- Print only ................................................... -->
<![ %output.print; [
(define withpgpkeys
#f)
(define (toc-depth nd)
(if (string=? (gi nd) (normalize "book"))
3
1))
(element programlisting
(if (and (equal? (attribute-string (normalize "role")) "pgpkey")
(not withpgpkeys))
(empty-sosofo)
($verbatim-display$
%indent-programlisting-lines%
%number-programlisting-lines%)))
(define %body-start-indent%
0pi)