Michael Smith [Sun, 1 Jul 2007 09:34:16 +0000 (09:34 +0000)]
Renamed the legalnotice.xml file to license.xml, because that's
what it is...
Note that til now, the build isn't actually doing anything with
the legalnotice.xml file -- it had content identical to the
copyright.xml file (which /is/ used by the build) -- though the
copyright.xml file now really does just have copyright stuff, so
made other changes to get everything matched up correctly.
Michael Smith [Sun, 1 Jul 2007 09:30:40 +0000 (09:30 +0000)]
Made some changes to the docsrc in order to streamline the doc
build a bit. Added a new authors.xml file, and changed the content
of the copyright.xml file into a real copyright content (the
license information is already in the legalnotice.xml and
warranty.xml files...)
Michael Smith [Sun, 1 Jul 2007 09:23:03 +0000 (09:23 +0000)]
For docbook-xsl builds, feed xjparse the -EO and -w switches.
-E0
suppresses the "Parse succeeded... with no errors and no warnings"
messages that xjparse (actually, the XML Commons resolver)
otherwise emits.
-w
cause xjparse/resolver to only do a well-formedness check,
instead of trying to do validation; the reason for adding this
is that xjparse gets run against what are now doctype-less,
namespaced DocBook instances (after recent changes to the
build) and fails to validate those (because they don't have a
doctype)
What we really need to do long-term is replace xjparse with a
better, RELAXNG-aware validation mechanism, so that we can have
the build properly validate stuff that it should be checking.
That maybe amounts to making an "xslt" wrapper tool that either
calls jing or rnv (depending on what the builder wants to use).
But for now we'll need to tolerate that fact that xjparse isn't
doing anything more for us than just simply WF checking...
Michael Smith [Sun, 1 Jul 2007 09:01:40 +0000 (09:01 +0000)]
Added a mechanism for "building" a copy of the current docbook.rng
schema in the releasetools directory. All that this "build" does
is to first make the docbook/relaxng/docbook/docbook.rng file, and
then copy over to the releasetools directory, prepending to that
docbook.rng copy a comment warning that it might not be up-to-date
and that if you really want to make sure you have an up-to-date
copy, you need to build it from the docbook/relaxng/docbook/
sources.
As a result, also checking in a static copy of the generated copy
of the docbook.rng file, and updating the docbook-xsl doc build to
use that instead of using the docbook/relaxng/docbook/docbook.rng
source version.
The sole reason for this change is to make it easier for other
developers to do docbook-xsl release builds -- because the
docbook-xsl release build needs to the docbook.rng file in order
to automatically generate TDG hyperlinks of DocBook element names
encountered in the doc source and in commit messages (which end up
in the generated NEWS.* files and in the release notes.
So this change prevents developers from needing to build the
docbook/relaxng/docbook.
Making builds easier to do is a Good Thing...
Michael Smith [Sun, 1 Jul 2007 08:40:59 +0000 (08:40 +0000)]
Added an ID on mediaobject that illustrates FO page regions, so
that the ID can get picked up and used as the filename for the
"long description" chunk for that mediaobject in HTML output.
Michael Smith [Sun, 1 Jul 2007 08:35:54 +0000 (08:35 +0000)]
Added new param abstract.notitle.enabled.
If non-zero, in output of the abstract element on titlepages,
display of the abstract title is suppressed.
Because sometimes you really don't want or need that title
there...
Michael Smith [Sun, 1 Jul 2007 08:31:52 +0000 (08:31 +0000)]
When we are chunking long descriptions for mediaobject instances
into separate HTML output files, and use.id.as.filename is
non-zero, if a mediaobject has an ID, use that ID as the basename
for the long-description file (otherwise, we generate an ID for it
and use that ID as the basename for the file).
The parallels the recent change made to cause IDs for legalnotice
instances to be used as basenames for legalnotice chunks.
Also, made some minor refinements to the recent changes for
legalnotice chunk handling.
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.