Michael Smith [Wed, 27 Jun 2007 20:05:26 +0000 (20:05 +0000)]
Added -E0 switch to default xjparse options, in order to suppress
"Parse succeeded... with no errors and no warnings." messages.
Thanks Norm for letting me know which flag to set.
Michael Smith [Wed, 27 Jun 2007 11:53:39 +0000 (11:53 +0000)]
Set doc.collab.show to 0 when building release-notes PDF with
dblatex (to get rid of the butt-ugly "Collaborators" table that
dblatex generates by default. Thanks Benoit Guillon for adding the
option to dblatex.
Michael Smith [Tue, 26 Jun 2007 17:20:18 +0000 (17:20 +0000)]
Output copyright and legalnotice in man-page output in whatever
place they are in in document order. Closes #1690539. Thanks to
Daniel Leidert for reporting.
Michael Smith [Tue, 26 Jun 2007 13:05:06 +0000 (13:05 +0000)]
Moved logging template and related templates to separate
utility.xsl file so that can be imported without importing the
whole common.xsl file (which is necessary for the build and for
using the logging template in standalone namespace-stripping
because the common.xsl file assumes it will be imported along with
all the params, which it can't be when building lib.xsl).
Michael Smith [Tue, 26 Jun 2007 03:10:55 +0000 (03:10 +0000)]
Switch to dblatex as default formatter for release notes (because
dblatex 0.2.6 fixes the problem we were having with it choking on
certain Unicode characters).
Michael Smith [Tue, 26 Jun 2007 01:52:09 +0000 (01:52 +0000)]
Added options to the build script for controlling which XSLT
engine and PDF formatter are used, and for handling of untarring
of additional packages (e.g., docbook-xsl-ns).
Michael Smith [Mon, 25 Jun 2007 05:03:22 +0000 (05:03 +0000)]
docbook5-xsl => docbook-xsl-ns, etc.
To ease hassles for downstream packagers, we are going to be
better of naming the namespaced stylesheets "docbook-xsl-ns"
instead of tying them to a specific version of DocBook (i.e.,
DocBook 5). Anyway, the real distinction is in fact that they are
namespaced, not they they are for DocBook 5.
Michael Smith [Mon, 25 Jun 2007 04:36:37 +0000 (04:36 +0000)]
Updated stylesheets to use common logging template to log messages
emitted during namespace-stripping.
Also, moved pad-string template from lib to common because
it's needed in order to use logging template in the profiling
stylesheets, and the lib build relies on the profiling apparatus
(so the profiling apparatus can't rely on lib being built first...)
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.