Michael Smith [Thu, 5 Jul 2007 15:13:03 +0000 (15:13 +0000)]
Completing adding all doc for HTML PIs. Added "see also" sections
with links to related global params, plus links to DocBook XSL: TCG
Also tried out adding some additional doc to param doc for the
textinsert.extension param that back-references the PI
documentation, plus added some TCG links there too.
Michael Smith [Wed, 4 Jul 2007 12:46:32 +0000 (12:46 +0000)]
Add x-ref links from embedded PI doc to sections in Bob's book.
Also, moved dbhtml-dir template to chunk-common.xsl file, because
it doesn't really belong in the PI file.
Michael Smith [Wed, 4 Jul 2007 11:41:04 +0000 (11:41 +0000)]
Consolidated all PIs for HTML table stuff into wrapper templates
in the "master" pi list (html/pi.xsl) and added embedded doc for
all of them. May have made some flubs in copying over, so this
change may break some table handling.
Michael Smith [Wed, 4 Jul 2007 10:17:17 +0000 (10:17 +0000)]
Consolidated all PIs for HTML synopsis and verbatim stuff into
wrapper templates in the "master" pi list (html/pi.xsl) and added
embedded doc for all of them. May have made some flubs in copying
over, so this change may break some synopsis and verbatim
handling. Note: Also added refsee@role=params instances so that we
can link to the corresponding global params (if any) for each PI.
Michael Smith [Wed, 4 Jul 2007 08:41:53 +0000 (08:41 +0000)]
Consolidated all PIs for qandaset into wrapper templates in one
place (html/pi.xsl) and added embedded doc for all of them. May
have made some flubs in copying over, so this change may break
some qandaset handling.
Michael Smith [Wed, 4 Jul 2007 06:06:53 +0000 (06:06 +0000)]
Consolidated all PIs for graphics and lists into wrapper templates
in one place (html/pi.xsl) and added embedded doc for all of them.
May have made some flubs in copying over, so this change may break
some graphics and list handling.
Michael Smith [Wed, 4 Jul 2007 01:30:15 +0000 (01:30 +0000)]
Made the following changed in the mode="hyphenate.verbatim" template:
- <xsl:apply-templates select="node()|@*" mode="hyphenate.verbatim"/>
+ <xsl:copy-of select="@*"/>
+ <xsl:apply-templates mode="hyphenate.verbatim"/>
...because as was it caused xsltproc to raise a fatal "Attribute
nodes must be added before any child nodes to an element." (though
not saxon)
Michael Smith [Tue, 3 Jul 2007 11:48:38 +0000 (11:48 +0000)]
Consolidated processing of all FO PIs into wrapper templates in
one place (the fo/pi.xsl file) and added embedded documentation
for all of them. This makes it possible to now include generated
documentation for the PIs in the output docs. Next stop: HTML PIs,
then on to the common ones...
This touched a lot of files and it is likely that I made some
mistakes in moving the PI processing over. Meaning that some PIs
might quit working or not work as expected after this change. So
it will need to tested. Which is why we do dot-zero releases...
Michael Smith [Sun, 1 Jul 2007 16:30:27 +0000 (16:30 +0000)]
Changed tangle.xweb to cause support to be added to xtangle.xsl to
suppress doctypes in xtangle.xsl output; controlled through the
suppress.doctype.in.output XSLT parameter.
Michael Smith [Sun, 1 Jul 2007 09:44:15 +0000 (09:44 +0000)]
Added a mechanism for "building" copies of the w2docbook.xsl,
ldocbook.xsl, cldocbook.xsl, xtangle.xsl files. All that this
"build" really does is to to first make the litprog module, then
copy over those files to the releasetools directory, prepending to
the copies a warning that they might not be up-to-date.
And so am no also checking in those copies to source control,
and updating the docbook-xsl build to use those instead of the
source versions in the litprog module.
This removes litprog as a build target/dependency for docbook-xsl.
The sole purpose of this change is just to make it easier for
other developers to do docbook-xsl release builds.
The litprog sources change very rarely, so it won't be a big
maintenance problem to keep these static copies in releasetools up
to date, and it'll certainly make it easier for developers to do
builds...
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.