Michael Smith [Sat, 30 Jun 2007 11:33:51 +0000 (11:33 +0000)]
When $generate.legalnotice.link is non-zero and
$use.id.as.filename is also non-zero, if a legalnotice has an ID,
then instead of assigning the "ln-<generatedID>" basename to the
output file for that legalnotice, just use its real ID as the
basename for the file -- as we do when chunking other elements
that have IDs.
Michael Smith [Sat, 30 Jun 2007 04:17:51 +0000 (04:17 +0000)]
Added copy to project source of modified version of Jeni's
markup.xsl stylesheet; source is in the contrib module but
annoying/stupid to require others to have to build it from there.
Michael Smith [Fri, 29 Jun 2007 09:15:38 +0000 (09:15 +0000)]
Took the test that the manpages stylesheet does to see if there
are any Refentry chilren in current doc, and made it
namespace-agnostic. Reason for that is because the test otherwise
won't work when it is copied over into the generated
profile-docbook.xsl stylesheet.
Michael Smith [Thu, 28 Jun 2007 23:38:27 +0000 (23:38 +0000)]
Added a manpages/profile-docbook.xsl file to enable single-pass
profiling for manpages output. KNOWN ISSUE: Single-pass namespace
stripping does not yet work in combination with the
manpages/profile-docbook.xsl stylesheet.
Michael Smith [Thu, 28 Jun 2007 19:37:43 +0000 (19:37 +0000)]
Removed all hard-coded instances of "/trunk" in the svnlog2docbook
stylesheet. Expectation now is that it is instead called with
parameters for the repository root URL and for the distro URL,
which makes it possible to identify the parent directory of the
distro. The intended result is to make the stylesheet more
portable (no longer assumes your source is under trunk).
Michael Smith [Thu, 28 Jun 2007 19:27:58 +0000 (19:27 +0000)]
Added mechanism for writing "svn info" output to a file and then
reading URLs for repository paths from that. Creates a new
.svninfo.xml target for distrib builds. This mechanism is intended
to be useful as a way of keeping the generation of the NEWS.xml
file as portable as possible (e.g., for builds from branches
instead of just from the trunk).
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.