Michael Smith [Fri, 14 Apr 2006 00:17:15 +0000 (00:17 +0000)]
Removed include statement that was pulling in VERSION file. The
current standalone slides FO stylesheets don't do anything with
the VERSION data anyway, and after they're officially integrated,
will always be pulling in the docbook-xsl VERSION data anyway.
Michael Smith [Mon, 10 Apr 2006 14:15:28 +0000 (14:15 +0000)]
Added message-prolog and message-epilog and
suppress-context-node-name local params to the write.chunk and
write.text.chunk templates. They enable additional info to be
emitted before/after the "Writing..." message, and enable they
context-node name to be suppressed in output. The reason for
these additions is that the write.text.chunk template is
"repurposed" in manpages output for writing the names of soelim
stub files as well as "real" man pages, and also is used for
writing the manifest file, and it is useful to emit details about
the type of file it is writing each time.
Michael Smith [Mon, 10 Apr 2006 01:55:16 +0000 (01:55 +0000)]
Added support for copyright and legalnotice.
The manpages stylesheets now output a COPYRIGHT section, after the
AUTHORS section, if a copyright or legalnotice is found in the
source. The section contains the copyright contents followed by
the legalnotice contents. Closes #1450209.
Michael Smith [Sat, 8 Apr 2006 16:54:41 +0000 (16:54 +0000)]
Added support for "software" and "sectdesc" class values on
refmiscinfo; "software" is treated identically to "source", and
"setdesc" is treated identically to "manual".
Michael Smith [Fri, 7 Apr 2006 18:36:06 +0000 (18:36 +0000)]
Made further refinements to the code for doing Refentry metadata
gathering; "normalized" the formatting of notification/warning
messages emitted during metadata gathering.
Michael Smith [Fri, 7 Apr 2006 12:21:25 +0000 (12:21 +0000)]
Drastically reworked all of the XPath expressions used in refentry
metadata gathering -- completely removed $parentinfo and turned
$info into a set of nodes that includes the *info contents of the
Refentry plus the *info contents all all of its ancestor
elements. The basic XPath expression now used throughout is (using
the example of checking for a date):
(($info[//date])[last()]/date)[1].
That selects the "last" *info/date date in document order -- that
is, the one eitther on the Refentry itself or on the closest
ancestor to the Refentry.
It's likely this change may break some things; may need to pick
up some pieces later.
Also, changed the default value for the man.th.extra2.max.length
from 40 to 30.
Michael Smith [Fri, 7 Apr 2006 00:13:08 +0000 (00:13 +0000)]
Changed test expression used for determining whether a term in a
variablelist is the final term. Was using "position() = last()",
but that caused a fatal XPath error in xsltproc (though not in
Saxon); changed to "not(following-sibling::term)", which is
probably a better way of doing it anyway.
Michael Smith [Thu, 6 Apr 2006 14:39:59 +0000 (14:39 +0000)]
Adjusted spacing around K&R-formatted Funcdef and Paramdef output
such that it can more easily be discerned where one ends and the
other begins. Closes #1213264.
Michael Smith [Thu, 6 Apr 2006 14:06:45 +0000 (14:06 +0000)]
Made handling of Refnamediv consistent with formatting in HTML and
manpages output; specifically, changed so that Refname
(comma-separated list of multiple instances found) is used
(instead of Refentrytitle as previously), then em-dash, then the
Refpurpose. Closes #1212562.
Michael Smith [Thu, 6 Apr 2006 06:23:15 +0000 (06:23 +0000)]
Ripped out parts of the doc source that we are no longer building
(because the info in those parts is out of date, no longer
maintained, and now obviated by existence of Bob Stayton's book.
Michael Smith [Thu, 6 Apr 2006 06:02:08 +0000 (06:02 +0000)]
Updated doc build to eliminate how-to portion of doc and retain
only the generated reference documention. (The how-to part was way
out of date, no longer maintained, and obviated by the existence
of Bob Stayton's book). The index.html file is now generated just
by making an exact copy of the reference.html file.
Michael Smith [Thu, 6 Apr 2006 02:56:36 +0000 (02:56 +0000)]
Moved param.xsl build up, out of html subdir. Rationale is too
allow better integration with DocBook XSL stylesheets build (if
we decide to move slides under xsl in source repository), and to
enable inclusion of potential fo params and params for other
slides output formats (svg, etc.) -- without needing to deal with
additional complexity of having a separate params.xsl file for
each slides output format.
Michael Smith [Thu, 6 Apr 2006 02:19:55 +0000 (02:19 +0000)]
Reworked doc build to depend on params.xsl file in slides/
instead of in slides/html. This makes xsl/slides build consistent
with other output formats. With this setup we avoid needing to
deal with potentially having a separate params.xsl file for each
separate subdir of the slides dir -- instead, if when params for
other than HTML output from slides are added, they just all go in
the single slides/param.xsl file.
Michael Smith [Wed, 5 Apr 2006 16:11:01 +0000 (16:11 +0000)]
Slides stylesheets import the DocBook XSL stylesheets, and Slides
xhtml stylesheets are auto-generated from Slide html ones, which
import the DocBook html stylesheets. So, need to transform the
"/html/" in the xsl:import to "/xhtml/".
Michael Smith [Wed, 5 Apr 2006 11:16:32 +0000 (11:16 +0000)]
Added root-element template match to slides fo/plain.xsl
stylesheet. The lack of it was causing the root match from the
VERSIOn file to get picked up, which in turn prevented any output
from being generated at all.
Michael Smith [Wed, 5 Apr 2006 10:51:35 +0000 (10:51 +0000)]
Added output of Releaseinfo to recto titlepage ("copyright" page)
for Book in FO output. This makes it consistent with HTML output.
Closes #1327034. Thanks to Paul DuBois for reporting.
Michael Smith [Wed, 5 Apr 2006 09:26:34 +0000 (09:26 +0000)]
Added newline before .sp request in template that matches
verbatims, because in some cases the .sp was appearing as a
literal in output, because it was getting output inline without a
break before it.
Michael Smith [Wed, 5 Apr 2006 09:03:34 +0000 (09:03 +0000)]
Added template for matching Span; noticed problems with span
instances appearing as-is output, possibly as a side-effect of
failed Olink processing -- so we need to catch it before it
sneaks through.
Michael Smith [Wed, 5 Apr 2006 05:55:07 +0000 (05:55 +0000)]
Moved table-footnote handling to links.xsl file. Added initial
support for converting Thead to a "running header". Changed
column-separator from hard-coded tab character (default in tb(1))
to user-configurable character (colon by default). Changed prefix
on several params from "man.*" to "tbl.*".
Michael Smith [Wed, 5 Apr 2006 05:47:08 +0000 (05:47 +0000)]
Adjusted .cvsignore and master (build-branch) makefile to align
with recent releasetools changes. Removed docsrc/make-xsl-params.pl
from list of executables because it has been removed from source
control and no longer needs to be packaged.
Michael Smith [Wed, 5 Apr 2006 05:18:29 +0000 (05:18 +0000)]
Added mechanism for dynamically generating docbook-elements.xsl
file (current list of DocBook elements, generated from current
DocBook 5 .rng file in source repository). So removed static
docbook-elements.xsl file from source control. Also removed
make-xsl-params.pl Perl script and replaced it with
make-elements.xsl, an XSL stylesheet that does the same thing the
Perl script did (dymanically generate a list of DocBook XSL
stylesheet params).
Michael Smith [Wed, 5 Apr 2006 05:07:05 +0000 (05:07 +0000)]
Changed "markup" mechanism to rely on two separate files (one for
element names, one for param names -- both located in xsl/docsrc)
instead of one. Also added "stopwords" mechanism for suppressing
markup of certain common words (set, code, parameter, etc.). And
changed handling of commiter names such that commiter names and
filename/revision info are now put into an Alt child (which
causes them to be output as the content of "title" attributes in
HTML output, so the info is accessible as "tooltip text".
Michael Smith [Wed, 5 Apr 2006 05:01:01 +0000 (05:01 +0000)]
Re-reworked the mechanism for identifying DocBook element names
and DocBook XSL param names in commit messages. It now relies on
the same files in xsl/docsrc that are used in generating the TDG
links and links to the DocBook XSL stylesheet param docs.
Michael Smith [Wed, 5 Apr 2006 04:56:19 +0000 (04:56 +0000)]
Fixed problem that was causing case to be preserved in element
names in TDG links. All element names are now lowercased before
the TDG link URL is assembled.
Michael Smith [Wed, 5 Apr 2006 03:19:10 +0000 (03:19 +0000)]
Problem:
When source has width="" (empty width) on imagedata, it ends up
getting converted to width="px" ("px" units with empty value) in
output.
Cause:
Stylesheets were not checking to see if width was non-empty.
Fix:
Stylesheets now check to see if value of width in source is
non-empty.
Affects:
This change affects FO output only. It causes width="auto"
output for width="" instances in source (instead of width="px").
Michael Smith [Wed, 5 Apr 2006 03:14:16 +0000 (03:14 +0000)]
Added condition for setting block-progression-dimension.minimum on
table-row, instead of height, when fop1.extensions is non-zero.
For an explanation of the reason for the change, see:
http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages
Michael Smith [Thu, 30 Mar 2006 01:26:52 +0000 (01:26 +0000)]
Added new refclass.suppress param for suppressing display of
Refclass in HTML and FO output. Did not add it to manpages because
manpages stylesheet is currently just silently ignoring Refclass
anyway. Closes request #1461065. Thanks to Davor Ocelic (docelic)
for reporting.
Michael Smith [Tue, 28 Mar 2006 13:18:35 +0000 (13:18 +0000)]
Process Refpurpose/Inlinemediaobject correctly in generated ToC.
Problem:
Contents of Refpurpose/Inlinemediaobject do not show up ToC in
HTML output. DocBook 5 says that Refpurpose/Inlinemediaobject
is valid, so we need to handle it correctly.
Cause:
HTML stylesheets were doing an xsl:value-of on Refpurpose when
generating the ToC.
Fix:
Changed to xsl:apply-templates call instead. Also, removed
generation of hyphen character in ToC between Refname contents
and Refpurpose. The Refpurpose template generates an em dash
already, so now that apply-templates is run, that em dash gets
rendered in the TOC, just as it is in the main text flow.
Affects:
This change only affects HTML output. I did not touch the FO
stylesheets because they are not currently rendering a TOC for
Refentry in the page contents anyway. And as far as the PDF
bookmarks, they appear to be generated with value-select for all
elements, regardless. I imagine that the reason might be that
images are not allowed in PDF bookmark labels.
As far as other effects, not the explanation above about the
change from generating a hypen in the TOC to generating an em
dash.
Closes bug #1459977. Thanks to Davor Ocelic (docelic) for the bug
report.
Jirka Kosek [Mon, 27 Mar 2006 08:36:02 +0000 (08:36 +0000)]
Emit namespace declaration for prefixes db and ng that are used inside XPath. Can we get rid of this f*#@ing QNames in attribute problem someday? (Sorry for not being polite.)