Michael Smith [Sat, 23 Jun 2007 09:08:06 +0000 (09:08 +0000)]
Added check to have the manpages stylesheet log/emit an error
message if it is given a namespaced DocBook document, with
instructions to instead either use the docbook5-xsl stylesheets to
directly process the document, or to use the stripns.xsl
stylesheet to pre-process it.
Michael Smith [Sat, 23 Jun 2007 01:38:26 +0000 (01:38 +0000)]
Refined mechanism for generating NEWS and RELEASENOTES.* files such that those
generated files for the xsl release will now also track changes to files in
the gentext module (e.g., new locales added or changed). This adds a
"Gentext" section to the docbook-xsl release notes.
Michael Smith [Fri, 22 Jun 2007 10:35:45 +0000 (10:35 +0000)]
Removed all "Do not edit this file" admonitions that get output in
generated stylesheets; such admonitions have in the past been
judged by the free-software police to be at-risk of
interpretation as license restrictions.
Also, made various updates to work around some funkiness is
xsltproc output.
Michael Smith [Fri, 22 Jun 2007 10:31:37 +0000 (10:31 +0000)]
Updated manpages string-substitute map to reflect fact that
because of another recent change to suppress bold markup in .SH
output, we no longer need to add a workaround for the accidental
uppercasing of roff escapes that occurred previously.
Michael Smith [Fri, 22 Jun 2007 10:27:30 +0000 (10:27 +0000)]
Added an echo to master makefile to let DocBook Project developers
know they can use xsltproc to build.
Also, added targets to copy extensions and gentext dirs over to
use in the build.
Michael Smith [Fri, 22 Jun 2007 03:06:54 +0000 (03:06 +0000)]
Removed xsl/extensions subdir; the DocBook XSLT 1.0 extensions are
now a top-level module, xsl-java (that change was made several
months ago in order to better facilitate requests from downstream
packagers.
Michael Smith [Fri, 22 Jun 2007 02:25:31 +0000 (02:25 +0000)]
Refined logging output of refentry metadata-gathering template;
for some cases of "missing" elements (refmiscinfo stuff, etc.),
the log messages now include URL to corresponding page in the
Definitive Guide (TDG).
Michael Smith [Wed, 20 Jun 2007 12:21:13 +0000 (12:21 +0000)]
Changed handling of bold and italic/underline output in manpages
output. Should be transparent to users, but...
This touches handling of all bold and italic/underline output. The
exact change is that the mode="bold" and mode="italic" utility
templates were changed to named templates. (I think maybe I've
changed it back and forth from mode to named before, so this is
maybe re-reverting it yet again).
Anyway, the reason for the change is that the templates are
sometimes call on dynamically node-sets, and using modes to format
those doesn't allow passing info about the current/real context
node from the source (not the node-set created by the stylesheet)
to that formatting stage.
The named templates allow the context to be passed in as a
parameter, so that the bold/ital formatting template can use
context-aware condition checking.
This was basically necessary in order to suppress bold formatting
in titles, which otherwise gets screwed up because of the numbnut
way that roff handles nested bold/ital.
Closes #1674534). Much thanks to Daniel Leidert, whose in his
docbook-xsl bug-finding kung-fu has achieved Grand Master status.
Michael Smith [Tue, 19 Jun 2007 18:17:51 +0000 (18:17 +0000)]
Fixed handling of example instances by adding the example element
to the same template we use for processing figure. Closes
#1674538. Thanks to Daniel Leidert.
Michael Smith [Tue, 19 Jun 2007 16:52:48 +0000 (16:52 +0000)]
In manpages output, emit warnings for notesources (footnote, etc.)
that have something other than para as a child.
The numbered-with-hanging-indent formatting that's used for
rendering endnotes in the NOTES section of man pages places some
limits/assumptions on how the DocBook source is marked up; namely,
for notesources (footnote, annotation, etc.) that can contain
block-level children, if the they have a block-level child such as
a table or itemizedlist or orderedlist that is the first child of
a footnote, we have no way of rendering/indenting its content
properly in the endnotes list.
Thus, the manpages stylesheet not emits a warning message for that
case, and suggests the "fix" (which is to wrap the table or
itemizedlist or whatever in a para that has some preferatory text.
Added normalize-space() around titles and index entries to work around whitespace problems.
Added support for glossary and bibliography in toc and map files.
David Cramer [Wed, 25 Apr 2007 23:05:24 +0000 (23:05 +0000)]
Added normalize-space around to avoid leading whitespace from appearing in the output if there's extra leading whitespace (e.g. <title> Foo</title>) in the source
Bob Stayton [Sat, 31 Mar 2007 22:38:02 +0000 (22:38 +0000)]
Refactored the big book template into smaller pieces.
Used the "page.sequence" utility template in
component.xsl to shorten the toc piece.
Added placeholder templates for front.cover and back.cover.
Michael Smith [Fri, 23 Mar 2007 21:57:22 +0000 (21:57 +0000)]
Updated Makefile.docParam to handle current db5-namespaced param
source. Also added support for it to copy xsl:attribute-set along
with xsl:param (neglected to have it doing that previously...)
Note that the Makefile.docParam makefile generates copies of the
html/param.xsl, fo/param.xsl, etc. files with the documentation
embedded. It was originally intended for use with oXygen XML
Editor (because oXygen has the capability to parse out that
embedded doc and display it in the oXygen UI) but could be useful
for other purposes.