os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add two new options to our documentation infrastructure.

Browse source 
TWO_SIDE    - If defined, two sided output will be created.  This
                  means that new chapters will only start on odd
                  numbered (aka right side, aka recto) pages and the
                  headers and footers will be aligned appropriately
                  for double sided paper.  Blank pages may be added as
                  needed.

    BOOK_OUTPUT - If defined, this will set all of the other
                  print-output options that can significantly increase
                  the build time, but make for much nicer looking
                  output.

To implement the two sided output, we need to override a TeX variable
to control the behavior of the JadeTeX macro package.  So this also
introduces a TEXCMDS variable that can be set with additional TeX
commands that should be run before processing the input TeX document.
In the TWO_SIDE case, we simply set it to \def\PageTwoSide{1}
This commit is contained in:
Murray Stokely 2001-09-07 10:21:41 +00:00
parent cc2871ef38
commit a36b0de6c7
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=10614
1 changed files with 28 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

32
share/mk/doc.docbook.mk
View file

@ -1,5 +1,5 @@
#
# $FreeBSD: doc/share/mk/doc.docbook.mk,v 1.44 2001/08/22 22:30:26 nik Exp $
# $FreeBSD: doc/share/mk/doc.docbook.mk,v 1.45 2001/08/23 07:59:06 murray Exp $
#
# This include file <doc.docbook.mk> handles building and installing of
# DocBook documentation in the FreeBSD Documentation Project.
@ -65,6 +65,19 @@
# and 5th level section titles. This would change
# "N.N.N.N Section title" into "Section Title" while
# higher level sections are still printed with numbers.
#
# TWO_SIDE If defined, two sided output will be created. This
# means that new chapters will only start on odd
# numbered (aka right side, aka recto) pages and the
# headers and footers will be aligned appropriately
# for double sided paper. Blank pages may be added as
# needed.
#
# BOOK_OUTPUT A collection of options are set suitable for printing
# a book. This option may be an order of magnitude more
# CPU intensive than the default build.
#
#
# Documents should use the += format to access these.
#
@ -107,6 +120,17 @@ CSS_SHEET?= ${DOC_PREFIX}/share/misc/docbook.css
PRINTOPTS?= -ioutput.print
.if defined(BOOK_OUTPUT)
NICE_HEADERS=1
MIN_SECT_LABELS=1
TWO_SIDE=1
#WITH_FOOTNOTES=1
#GEN_INDEX=1
.endif
.if defined(TWO_SIDE)
PRINTOPTS+= -V %two-side%
TEXCMDS+= \def\PageTwoSide{1}
.endif
.if defined(NICE_HEADERS)
PRINTOPTS+= -ioutput.print.niceheaders
.endif
@ -311,11 +335,11 @@ ${DOC}.tex-pdf: ${SRCS} ${IMAGES_PDF} ${INDEX_SGML} ${PRINT_INDEX}
${DOC}.dvi: ${DOC}.tex-ps
@echo "==> TeX pass 1/3"
-tex "&jadetex" '\nonstopmode\input{${.ALLSRC}}'
-tex "&jadetex" '${TEXCMDS} \nonstopmode\input{${.ALLSRC}}'
@echo "==> TeX pass 2/3"
-tex "&jadetex" '\nonstopmode\input{${.ALLSRC}}'
-tex "&jadetex" '${TEXCMDS} \nonstopmode\input{${.ALLSRC}}'
@echo "==> TeX pass 3/3"
-tex "&jadetex" '\nonstopmode\input{${.ALLSRC}}'
-tex "&jadetex" '${TEXCMDS} \nonstopmode\input{${.ALLSRC}}'
${DOC}.pdf: ${DOC}.tex-pdf
@echo "==> PDFTeX pass 1/3"