Chapter 4. The Print Stylesheet

Table of Contents
Documentation
Change Log

Documentation

Writing better documentation for these stylesheets is a background task. If you have any questions that aren't answered here, please feel free to contact me.

Print Parameters

A brief description of each of the user-configurable settings in the print stylesheet.

Library Functions

Reference pages for the library functions in dblib.sgm. (FYI: this is programmer's documentation, not user documentation.)

Change Log

1999-01-13  Norman Walsh  <ndw@nwalsh.com>

	* docbook.dsl: Fixed country codes, added db31.dsl

	* dbsect.dsl: Removed call to section-hlevel

	* dbbibl.dsl: Changed section-hlevel call to SECTLEVEL

	* db31.dsl: New file.

	* dbl1da.dsl, dbl1de.dsl, dbl1en.dsl, dbl1no.dsl, dbl1sv.dsl:
	Fixed country codes.

1999-01-01  Norman Walsh  <ndw@nwalsh.com>

	* dbl1da.dsl: Fixed incorrect ID on style-specification.

1998-12-29  Norman Walsh  <ndw@nwalsh.com>

	* dbinline.dsl: Moved processing of FIRSTTERM to dbgloss.dsl

	* dbgloss.dsl: Added support for LINKEND on GLOSSTERM and FIRSTTERM

	* dbparam.dsl: Added firstterm-bold to make FIRSTTERM entries bold.

1998-12-22  Norman Walsh  <ndw@nwalsh.com>

	* dbparam.dsl: Added %label-preface-sections%. If true, sections in the
	preface are numbered, otherwise they aren't.

	* dbcompon.dsl: Removed extranous call to (normalize).

1998-12-16  Norman Walsh  <ndw@nwalsh.com>

	* dbttlpg.dsl: Improved formatting of RevHistory.

1998-12-14  Norman Walsh  <ndw@nwalsh.com>

	* dblink.dsl: Use (data-of) instead of (data).

	* docbook.dsl, version.dsl:
	Added VERSION to version message (which isn't actually used
	in the print stylesheets...)

1998-12-13  Norman Walsh  <ndw@nwalsh.com>

	* docbook.dsl: Added flow object classes for TeX support

	* dblists.dsl:
	Reset first-line-start-indent so that nested VARIABLELISTs are
	formatted correctly.

	* dblink.dsl: Added support for XREF to LISTITEM of an ORDEREDLIST.

	* dbblock.dsl:
	Added support for BOP footnotes and floating formal objects if the
	TeX backend is being used.

	* dbparam.dsl:
	Added tex-backend, mif-backend, rtf-backend, and default-backend.
	Added (print-backend).

	Added formal-object-float: if #t, formal objects "float" when
	the TeX backend is used.

	Added bop-footnotes: if #t, footnotes appear at the bottom of
	each page instead of collected at the end of a section. This is
	only supported in the TeX backend.

1998-12-04  Norman Walsh  <ndw@nwalsh.com>

	* dbbibl.dsl:
	Complete rewrite of bibliograpy handling.  Almost all elements
	are now output.  See contrib/*/short-biblioentry.dsl for an
	example of how to restrict the output.

	* dbsect.dsl: Moved $section-hlevel$ to dbcommon

1998-12-02  Norman Walsh  <ndw@nwalsh.com>

	* dblink.dsl: Fixed badly broken LINK semantics

1998-11-30  Norman Walsh  <ndw@nwalsh.com>

	* dbparam.dsl: Changed default min-leading to allow graphics that are
	taller than the current leading to be rendered.

	* dbttlpg.dsl: More work on titlepages.  Removed use of (default) rule
	so now nested elements should format properly.

	* dbcallou.dsl: AreaSpec, Area, and AreaSet should be empty

	* dbblock.dsl: Move formatting for Abstract off of (abstract para) and
	onto abstract proper.

	* dbparam.dsl: Added %article-title-quadding% and
	%article-subtitle-quadding%

	* docbook.dsl: Added Finnish

	* dbl1fi.dsl: New file.

	* dbinline.dsl: Added TM to Trademark; made Option monocase

1998-11-25  Norman Walsh  <ndw@nwalsh.com>

	* dbparam.dsl: Fixed typo in ID

	* dbparam.dsl: Added %show-ulinks% and %show-comments%

	* dbttlpg.dsl: Completely reworked.  Again.  Now there should be
	*some* output for every element that can occur
	in an "info" node.

	* dbrfntry.dsl:
	Create new simple-page-sequence if RefEntry is the root node

	* dbmath.dsl: Added (incomplete) support for equation autolabelling.

	* dblink.dsl: Support %show-ulinks%

	* dbverb.dsl: Don't force quadding in literal layout environments, let
	it be inherited

	* dbinline.dsl: Comment is now a block, not an inline

	* dbdivis.dsl: Handle Footnotes in PartIntro

	* dbblock.dsl: Suppress footnotes in suppressed comments.
	Support %show-comments%

1998-11-19  Norman Walsh  <ndw@nwalsh.com>

	* dbblock.dsl: Added support for footnoted ulinks

	* dblink.dsl: Added support for footnoted ULINKs

	* dbparam.dsl: Added %footnote-ulinks%

	* version.dsl: Removed version number; see ChangeLog for lib/dblib.dsl

	* dbindex.dsl: Added support for an index. See the docs.

	* dbparam.dsl: Added image-library and image-library-filename.
	The image library is an external XML document which
	contains additional information about images. It's
	used mainly in the HTML backend.

	Added %page-column-sep% and %page-balance-columns?%
	to control the default parameters when doing multiple
	columns.

	* docbook.dsl: Added declare-characteristics for page-column-sep and
	page-balance-columns? Added all-element-number.

	* dbttlpg.dsl: Added a small hack (an empty paragraph with line spacing
	of 1pt) to make graphics print correctly if they're the
	first thing on the page.  (Is there a better way?)

	* dbsynop.dsl: The SEPCHAR wasn't handled correctly when the synopsis
	contained a mixture of ARGs and GROUPs.

1998-11-05  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.23 released.

	* dbprint.dsl: Added support for setting a different starting indent
	for the first line of paragraphs.  The first paragraph
	in a section gets %para-indent-firstpara% extra space
	on the first line, other paras get %para-indent% extra
	space.

	A paragraph is the first paragraph if it is preceded by a title
	(or bridgehead) and the only elements that intervene between the
	title and the paragraph are *info elements, indexterms, and
	beginpage.

	* dbrfntry.dsl:
	A REFSYNOPSISDIV is like a section, not a verbatim paragraph.
	(I thought I fixed this a long time ago.  Must have been only
	in the HTML stylesheet.)

	* dbsect.dsl: For the purpose of calculating the start-indent for
	a section title, a REFSYNOPSISDIV is like a REFSECT1.

	* dbsynop.dsl:
	Calculation of the inter-ARGument/inter-GROUP SEPCHAR was all
	wrong, but no one noticed because it's usually a space.

	Multiple COMMANDs in the same CMDSYNOPSIS are separated by
	a newline.

	* dbparam.dsl:
	Added %para-indent% and %para-indent-firstpara%.  Used for
	the indentation of the first line of a paragraph.

	* dbadmon.dsl: Caution and Warning had repeated titles. Fixed.

1998-11-03  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.22 released.

	* dbblock.dsl: Fixed spacing around titles that appear after a formal
	object.

1998-11-02  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.21 created (not for release, just
	to checkpoint another project).

	* docbook.dsl: Refer to dblib.dsl by public ID instead of system ID

1998-11-01  Norman Walsh  <ndw@nwalsh.com>

	* dbblock.dsl: Added support for ($object-titles-after$).
	Fixed bug in table footnotes where a footnote in the
	header appeared bold in the footnote list.

	* dbparam.dsl: Added ($object-titles-after$). Returns a list of
	elements. The titles of elements in that list
	appear below the objects instead of above them.

	* dbtable.dsl: Fixed bugs in handling of cell and row borders.

	* dblink.dsl: Support XREF to CO

	* dbbibl.dsl: Include 'bookbiblio' in the list of elements that
	should be ignored in 'biblioentry'.

	* dbautoc.dsl: Made TOC/LOT titles into links

1998-10-31  Norman Walsh  <ndw@nwalsh.com>

	* dbtable.dsl: Removed debug message accidentally left in place

	* dbblock.dsl: Improved formating of epigraphs

1998-10-30  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.20 released.

	* dbadmon.dsl: Removed position-point-y.  Why was I doing that?  The
	TeX backend now handles it, so suddenly it turned up
	as a bug.

	* dbtable.dsl:
	Improved handling of COLSPECs (that is to say, handle them
	correctly ;-)

	* docbook.dsl: Added Swedish and Danish

	* dbl1dk.dsl, dbl1svse.dsl: New file.

	* dbl1ru.dsl: Updates by Ilia Kouznetsov

1998-10-22  Norman Walsh  <ndw@nwalsh.com>

	* dbblock.dsl: Changed formatting of Sidebars.  They now get a box.

1998-10-19  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.19 is released.

	* docbook.dsl: Added Spanish, Italian, Dutch, and Portuguese.

	* dbttlpg.dsl: Made a number of spaces non breaking.

	Changed use: para-style to use: default-text-style.

	Removed "by" in front of CORPAUTHORs in AUTHORGROUPs.
	(The AUTHORGROUP generates the "by".)

	* dbsynop.dsl: Made several spaces non breaking.

	* dbsect.dsl: See changes for dbcompon.dsl

	* dbrfntry.dsl: Removed use: para-style.

	Made spaces non breakable.

	Fixed a bug in the formatting of the REFENTRY title.
	The stylesheet was erroneously looking for REFENTRYTITLE
	among the descendants of the REFENTRY.  The search needed
	to be more limited than that.

	* dbprocdr.dsl: Removed use: para-style.

	* dbprint.dsl:
	Removed para-style (renamed it default-text-style for use
	on simple-page-sequences).

	Added nop-style which does nothing (for use in an else)

	* dbparam.dsl: Made admon-graphics #f by default.

	Made a few spaces non breaking.

	* dblists.dsl: Made several spaces non breaking.

	Added support for continued ordered lists.

	Removed use: para-style.

	Added keep-with-next to prevent VARLISTENTRY TERMs from
	becoming separated from their LISTITEMs.

	* dbinline.dsl: Added support for SEQ and SIMUL values of the ACTION
	attribute on KEYCOMBO.

	* dbindex.dsl, dbdivis.dsl: See changes for dbcompon.dsl

	* dbcompon.dsl: Removed use: para-style

	Added use: default-txt-style to the simple-page-sequences.
	default-text-style has the same characteristics that
	para-style used to have.

	* dbcallou.dsl: Made generated spaces non-breaking.

	* dbblock.dsl: Removed use: para-style.

	Added a rule for (para blockquote) so that a
	first-line-start-indent on the outer para
	isn't inherited by the para in the blockquote.

	* dbbibl.dsl:
	Replaced " " with "\no-break-space;" in a number of places.

	* dbautoc.dsl: Removed use: para-style.

	Everything in para-style should be inherited from a higher-level
	wrapper. Otherwise, for example, PARAs a LIST get para-style
	even if the list is in an admonition.

	* dbadmon.dsl: Moved a number of characteristics up from the
	paragraphs in an admonition to the wrapper
	around the paragraphs.  This makes lists and
	other non-PARA elements in an admonition
	work properly.

	* dbl1bmno.dsl, dbl1es.dsl, dbl1fr.dsl, dbl1it.dsl, dbl1nl.dsl, dbl1pl.dsl, dbl1pt.dsl, dbl1ru.dsl:
	Reworked localizations; added support for Spanish, Italian, Dutch, and Portuguese.

1998-09-18  Norman Walsh  <ndw@nwalsh.com>

	* dbparam.dsl: Fixed typo

	* dbblock.dsl: Change some insignificant linebreaks

	* version.dsl: Version 1.18 released (really!).

	* dbblock.dsl: Change some insignificant linebreaks

	* dbl1usen.dsl: Removed some test code.

	* dbparam.dsl: Added %author-othername-in-middle%

	* dbl1dege.dsl, dbl1usen.dsl:
	Added support for translation entity file.

1998-09-17  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.17 released.

	* dbautoc.dsl: Changed 'start quadding on TOC and LOT titles
	to %component-title-quadding%.

1998-09-16  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.16 released

	* dbttlpg.dsl: Fixed bug in printing of REFERENCE titlepage

	* version.dsl: Version 1.15 released

	* OldChangelog.sgm: New file.

	* version.dsl: Removed SGML change log.

	* dbttlpg.dsl: Fixed REFERENCE numbering

	* dbparam.dsl: Added %admon-graphics%, %admongraphics-path%,
	$admon-graphic$, and $admon-graphic-width$ to
	support graphics in admonitions.

	* dbadmon.dsl: Added support for %admon-graphics%

1998-09-14  Norman Walsh  <ndw@nwalsh.com>

	* dbtable.dsl: Changed method for selecting rows. New method is
	more robust for the case where the table code
	is used with another DTD that allows more
	elements than just ROW in the TBODY.

1998-09-10  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.14 released

	* dbttlpg.dsl: Added COPYRIGHT to SET and BOOK titlepage versos.
	Added ABSTRACT to BOOK titlepage verso.
	Improved formatting of AUTHOR AFFILIATIONs.
	Added a number of elements to REFERENCE titlepages.

	* dbparam.dsl: Documentation fixes

	* dblink.dsl: Improvements to OLink support. Report errors
	with (error) instead of (literal).

1998-09-08  Norman Walsh  <ndw@nwalsh.com>

	* dbparam.dsl: Added OLink parameters

	* dblink.dsl: Added support for OLink.  Documented at
	http://nwalsh.com/cgi-bin/olink?pubid=-//Norman Walsh//DOCUMENT OLink Support V1.0//EN

1998-09-04  Norman Walsh  <ndw@nwalsh.com>

	* dblink.dsl: Added rudimentary suppor for OLINKs

	* dblink.dsl: Fixed typo; removed extra space in numbered biblio xref

	* dblink.dsl: Support for bibliography numbering

	* dbbibl.dsl: Added support for enumerated bibliographies.
	N.B. no attempt is made to change citation
	text into numbers.

	* dbparam.dsl: Added biblio-number

1998-09-03  Norman Walsh  <ndw@nwalsh.com>

	* dbtitle.dsl: Check for title ending punctuation in $runinhead$

	* dbparam.dsl:
	Added %default-title-end-punct% and %content-title-end-punct%

	* docbook.dsl: Added support for Polish

	* dbparam.dsl: Added biblio-citation-check and biblio-filter-used

	* dblink.dsl: Handle xref to bibliography entries

	* dbgraph.dsl: Use include-file instead of $include$

	* dbl1pl.dsl: New file.

	* dbinline.dsl:
	Added support for citation reference checking and citation linking.

	* dbgraph.dsl: Moved $include$ to dblib.dsl

	* dbbibl.dsl:
	Added support for bibliography filtering.  Added use of XREFLABEL
	as citation string if ABBREV isn't present.

1998-09-02  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.13 released

	* docbook.dsl:
	Added external-procedure declaration for read-entity; used by dbgraph.dsl

	* dbgraph.dsl:
	Reorganized code. Added support for sourcing of external text documents.
	If FORMAT is LINESPECIFIC, the content of the named file is inserted
	literally into the document (via read-entity and literal)

	* dbcallou.dsl:
	Fixed bug in $callout-mark$.  Return #f, not 0, if there's no co.

	* dbbibl.dsl:
	Handle BIBLIOGRAPHYs that occur inside ARTICLEs or other places below
	BOOK.  Do not create a simple-page-sequence in these cases.

1998-08-31  Norman Walsh  <ndw@nwalsh.com>

	* dblists.dsl: Fixed bug in processing of verbatim environments as
	the first child of a varlistentry listitem.

1998-08-28  Norman Walsh  <ndw@nwalsh.com>

	* version.dsl: Version 1.12 released

	* dbadmon.dsl, dbblock.dsl, dbprint.dsl, dbsynop.dsl:
	Changed process-children
	into process-children-trim in paragraph
	contexts

	* dbtable.dsl: Changed process-children into
	process-children-trim in paragraph contexts