Michael Smith [Sun, 16 Apr 2006 04:25:29 +0000 (04:25 +0000)]
Added missing param declarations on several templates. Lack of
them was causing processing with Saxon to fail. Thanks to
Denis Bradford for reporting the problem.
Fixed bug # 1465290. Spaces are converted fo:leader only inside DocBook (non-namespaced elements). Text nodes inside different namespaces (e.g. MathML, SVG) are left untouched.
Michael Smith [Fri, 14 Apr 2006 10:22:41 +0000 (10:22 +0000)]
Created a new message-logging named template, log.message, by
generalizing the old refentry.emit.message template and moving it
out of common/refentry.xsl and into common/common.xsl
Michael Smith [Fri, 14 Apr 2006 08:41:41 +0000 (08:41 +0000)]
Added options for controlling indentation of verbatim output.
Controlled through the man.indentation.verbatims.adjust and
man.indentation.verbatims.value params. Closes #1242997
Michael Smith [Fri, 14 Apr 2006 08:25:36 +0000 (08:25 +0000)]
Added options for controlling indentation in lists and in *blurb
output in the AUTHORS section. Controlled through the
man.indentation.lists.adjust, man.indentation.lists.value,
man.indentation.authors.adjust, and man.indentation.authors.value
parameters. Default is 3 characters (instead of the roff default
of 8 characters). Closes #1449369.
Also, removed the indent that was being set on informalexample
outuput. I will instead add an option for indenting verbatims,
which I think is what the informalexample indent was intended for
originally.
Michael Smith [Fri, 14 Apr 2006 04:58:31 +0000 (04:58 +0000)]
Added support for writing man files into a specific output
directory and into appropriate subdirectories within that output
directory. Controlled through the man.base.dir parameter (similar
to the base.dir support in the HTML stylesheet) and the
man.subdirs.enabled parameter, which automatically determines the
name of an appropriate subdir (for example, man/man7, man/man1,
etc.) based on the section number/manvolnum of the source Refentry.
Closes #1255036 and #1170317. Thanks to Denis Bradford for the
original feature request, and to Costin Stroie for submitting a
patch that was very helpful in implementing the support.
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.