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.

Modified html/slides-common.xsl to look for param.xsl in new
location.

Moved param.xweb out of html subdir and up a level such that it
can potentially include params for fo, svg, etc. output formats.

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.

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.

Added some additional "punctuation" characters.

Support XInclude namespace

Allow XInclude inside info elements

Added parameter to the db.technical.inlines

Reorganized to avoid recursive Makefiles

Generate proper namespace declaration attributes

Reorganized to use non-recursive Makefiles

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/".

Removed RNG and RNC tags and unneeded pubdate

Reorganized to use non-recursive Makefiles

Oh bother, just ignore all the random bits at this level

Reorganized to use non-recursive Makefiles

Updated pubdate and date

Don't put EMPTY in a group; added debugging messages (currently commented out)

Fix busted table content models

You speak English, right norm?

Support inheriting linkends and xlink:hrefs in imageobjectco areas

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.

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.

Added call to normalize-space() to cause contents of Abstract to
be normalized when used as the value of the HTML "meta description".

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.

Handle additional case when extension functions were not unable to load external resource on Windows box

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.

Redirect cvs2cl output from stout to file (instead of using -f
switch).

Removed get-terms.xsl; it is no longer needed or used.

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.*".

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.

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).

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".

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.

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.

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").

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

Add Customization section.

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.

We are using HTML output method, thus escaping is not necessary anymore, it is done automatically by XSLT engine

OK, prefixes that are excluded, must be also declared, otherwise saxon complains

Add namespace prefixes db and ng into the list of excluded prefixes (their declarations are added when profiling stylesheets is generated).

Removed get-latest-tag.xsl. Was mistakenly left behind when I
moved related files to releasetools area.

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.

Also copy over XSL stylesheet customization and Makefile.in file.

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.)

Change version tag in VERSION file before building.

Created new refentry/ subdirectory under samples, and moved
refentry samples into that.

Added clean target.

Added scmxx subdirectory in samples and added a makefile in it
for getting Hendrik Sattler's scmxx docs.

Added "patchutils" subdirectory to samples/ tree, with makefile
for retrieving Tim Waugh's patchutils.xml source.

Don't try to be quite so clever.\1a

Added target for making modified markup.xsl file

Changed include to point to modified version of Jeni Tennison's
markup.xsl instead of to the original.

This makefile downloads Jeni Tennison's "Markup Utility"
stylesheet, then runs it through the modify.xsl file to alter the
value of the "punctuation" variable.

Added cvs2cl2docbook.xsl stylesheet for converting XML-formatted
ChangeLog output of the cvs2cl command into DocBook form. It uses
Jeni Tennison's "Markup Utility" stylesheet to auto-mark-up
instances of DocBook element and parameter names in commit
messages. It also preserves newlines in the messages.

Removed older version of this stylesheet from xsl/

Added to .cvsignore some additional files that are generated by
the build -- TERMS.xml and ChangeSince*.xml

Bibliography can set negative text-indent, so we must reset it for footnotes

Removed stripns.xsl from manpages/ subdirectory. manpages now use
the stripns.xsl in the common/ subdirectory.

Changed output in NEWS and release file to only use NCName'ified
version where it is needed. use the "raw" version otherwise.

Don't package LatestTag file.

Added support for auto-recognizing DocBook element names in
commit descriptions and marking them up with <tag>foo</tag>
instances.

Added a utility stylesheet that gets all of the element names from
a RELAX NG schema (in XML syntax). Needed for recognizing DocBook
element names in commit descriptions and marking them up.

Strip out dots from the release name before using it (it gets put
into ID attributes, so it must be an NCName).

Don't include LatestTag file in zip.

Adjusted a couple more spots where date preceded version in
generated build ID.

Changed assembling of version name so that it does not start with
a date. Because if it starts with a number (e.g., "2006"), it is
not a NCName. We use it in ID values, so it must be a valid NCName.

Changed handler for budiling version number of snapshots to remove
colon in time part.
For example, 2006-03-25_0921_snapshot instead of 2006-03-25_09:21_snapshot
 -- the reason being that the colon wreaks havoc with make(1)
 because it is used in a filename (RELEASE-NOTES-2006-03-25_09:21_snapshot.xml)
that is also a target name.

Fixed typo.

Updated the release-notes and NEWS build to be based on XML
output from cvs2cl and then use of an XSLT stylesheet to
dynamically auto-generated the list of changes since the last
release.

Set priority="-1" on match="/" template in stripns.xsl, to
suppress "Ambiguous rule match" warnings.

Switched to just using translate() in place of locale-aware
string.lower(). The dirnames are all ASCII, so using
string.lower() to convert them is overkill.

Added a new substitution to man.string.subst.map, because it is
necessary clean-up needed for dealing with a kludge for preserving
tab characters (which are used by tbl(1) as cell-separators)

Added a "string.lower" template. Does the opposite of
string.upper().. Used in the XSLT-based build process for
generating the NEWS file and release notes, where we take
the "display names" of subsections like "HTMLHelp", and change
them into the actual directory names, like "htmlhelp".

Updated such that auto-generated NEWS.xml contents are XIncluded
during build. Also changed to Sect1/Sect2 instead of
Section/Section. Maybe I'm just too old-school, but I find it
comforting to know easily where I am in the structure while I'm
editing or viewing the source.

The Makefile.param file is generated as part of the build, so
doesn't need to be in source control. I thought it wasn't,
currently, but it was showing up in my "cvs update", so I'm
(re)removing it.

Added a bunch of filenames to .cvsignore -- names of files
generated by the build, including several related to the updated
(XSLT-based and cvs2cl-based) build of the release notes and NEWS file.

Updated build to use an XSLT-based process to dynamically
auto-generate the release notes and NEWS files from output of the
cvs2cl perl script <http://www.red-bean.com/cvs2cl/>. This
potentially helps us get closer to being "release ready" at at
time, and maybe start to get releases out more quickly and more
often. On the other hand, it's also sort of a step toward making
the snapshot builds more like real releases, such that the
official releases could eventually be obviated by having easily
installable/updateable snapshots available. The "easily
installable" piece of that is what I want to work on next. A
system like perl's CPAN update/install interface, PHP's PEAR,
rubygems, etc. ...

Anyway, back to now -- this commit adds two new files in the
docscrc dir: get-latest-tag.xsl and release-notes.xsl. It also
involves some changes, committed separately, to the master
makefile used for release builds.

Make install.sh smart(er) about figuring out what directory it is
being run from. Also, don't delete release-note from build
package.

Added support for DocBook 5 namespace-stripping in manpages
stylesheet. Closes request #1210692.

Turned release notes document into a DocBook 5 instance, but added
internal DTD subset that makes it backward-compatible with DocBook
old. Also added a skeletal "snapshot" section.

Check for //refentry|//db:refentry instead of
local-name() = 'refentry'... because single quotation marks cause
problem due to fact that the stylesheet is embedded in value of a
variable

Make .html files precious.

Removed hack for two-pass namespace stripping for manpages output.
Because it's no longer needed.

Added <xsl:template match="/"> to make stripns.xsl usable as a
standalone stylesheet for stripping out DocBook 5/NG to DocBook 4.
Note that DocBook XSLT drivers that include this stylesheet all
override the match="/" template.

Fixed problems with notifications generated when date found.

Restored default indentation behavior "normal" man behavior.
Corrected handling of empty Address instances in author section.

Added support for top-alignment of cell contents.

Fixed handling of table footnotes.
With this checkin, the table support in the manpages stylesheet is
now basically feature complete. So this change closes request
#619532, "No support for tables" -- the oldest currently open
manpages feature request, submitted by Ben Secrest (blsecres) on
2002-10-07. Congratulations to me [patting myself on the back].

Added handling for table titles. Also fixed handling of nested
tables; nest tables are now "extracted" and displayed just after
their parent tables.

Added character formatting for table headings.

Added "options line" allbox/center/expand support.

Corrected handling for case where a cell with a rowspan is
preceded in the same row by a cell or cells with colspans. Added
step for calling trim-text() on roff-formatted contents of each
cell, to trim off leading/trailing whitespace from those contents.

Fixed handling for case where table is an HTML table in the
DocBook source (rather than CALS). Adjusted warning message about
nested tables.

Further table fine-tuning. Added handling for nested tables
(discard them with a warning, because tbl(1) does not support
nested tables). Also deal with cases where source table has
multiple tgroup. Only output "allbox" if border != 0.

Checkpointing. Now works correctly with the standard test table
(which contains rowspan and colspan instances. Need to test
further to make sure it will work with other rowspan/colspan
tables.

Checkpointing.

Checkpointing. Format spec now gets written correctly, including
for all instances of Rowspan. Just have an issue with generating
one less tab than should be in instances with rowspan/colspan.

Added some keys we need for AUTHORS section in man-page output.