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.
Michael Smith [Mon, 5 Mar 2007 17:03:39 +0000 (17:03 +0000)]
Don't make the RELEASE-NOTES build a standard part of
all packages. Instead just include it where needed and
don't include it where not needed (for example, include
it in the docbook-xsl package but not in the
docbook-xsl-java package).
Michael Smith [Mon, 5 Mar 2007 17:01:58 +0000 (17:01 +0000)]
Copied xsl/extensions up a level to create a top-level
xsl-java module. Rationale is that we need to do a
separate docbook-xsl-java release in order to get the
XSL Java extensions packaged for Debian, and having it
as a top-level module allows the release build and
packaging to be done using the common build files in
releasetools/ and so makes it a lot easier to set up
and maintain the build and do the packaging and upload, etc.
After OK, would be best to next remove the
xsl/extensions directory from version control and
instead update the docbook-xsl build to simply copy
over the built jars from the xsl-java dir.
Michael Smith [Mon, 5 Mar 2007 11:12:59 +0000 (11:12 +0000)]
Made the paramchk script use the value of DOCBOOK_SVN
to find the params dir (instead of relying on relative
paths). This hard-codes paramchk to work only with
docbook-xsl -- but anyway, no other builds currently
use paramchk.
Michael Smith [Mon, 5 Mar 2007 10:23:21 +0000 (10:23 +0000)]
Made changes to cause build of separate
slides/fo/param.xsl and slides/html/param.xsl files,
and updated doc build to handle that split. Also
updated build of ChangeLog.xml, NEWS file and
RELEASE-NOTES.{html,txt,pdf} builds to include slides
and website changes.
Closes bug #1671745. Thanks to Justus Piater.
Michael Smith [Mon, 5 Mar 2007 06:28:18 +0000 (06:28 +0000)]
Made some minor updates to param docs and comments in
manpages stylesheet. Also, removed some params for
manpages doc that are already doc'ed as HTML params.
Michael Smith [Thu, 1 Mar 2007 11:09:31 +0000 (11:09 +0000)]
Turned off xalan2.jar build. This removes DocBook XSL
Java extensions support for versions of Xalan prior to
Xalan 2.7. If you are currently using the extensions
with an earlier version of Xalan, you need to upgrade
to Xalan 2.7.