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.

Checkpointing. Still have a way to go on reworking this.

Added support for *info gathering all the way up to root element.
Problem:: Existing stylesheets only gathered the *info child of
each Refentry, plus *info child of its parent.
Change:: For each Refentry, the stylesheets now contstruct a node
set that contains the entire contents of *info children of all
ancestors of that Refentry, as well as its own *info child.

Closes #1243035. Thanks to Joe Orton for the feature request.

Use XSLT to check if a DocBook source file contains a Refentry
(instead of using hacky "cat" check).

Fixed man->text/pdf output.

Removed hack of keeping "master" manifest file for keeping track
of what man pages we have output. We can just generate the list
in memory using the power of GNU make..

Refined support for generating and cleaning up chunked output.
Also added support for controlling the set default make targets
(output formats) from the environment, using the
DOCBOOK_OUTPUT_FORMATS environment variable.

Added option for turning off bold formatting in Funcsynopsis.
Boldface formatting in function synopsis is mandated in the man(7)
man page and is used almost universally in existing man pages.
Despite that, it really does look like crap to have an entire
Funcsynopsis output in bold, so I added params for turning off the
bold formatting and/or replacing it with a different roff special
font (e.g., "RI" for alternating roman/italic instead of the
default "BI" for alternating bold/italic). The new params are
"man.funcprototype.font" and "man.funcsynopsisinfo.font". To be
documented later.

Closes #1452247. Thanks to Joe Orton for the feature request.

Took some templates for matching inline instances of come
"computer" markup and moved them out of synop.xsl file and into
the inline.xsl file.

Someday I'll get around to learning basic XPath. And/or common
sense.

Use AUTHORS instead of AUTHOR if we have multiple people to
attribute. Also, fixed checking such that we generate author
section even if we don't have an author (as long as there is at
least one other person/entity we can put in the section). Also
adjusted assembly of content for Author metainfo field such that
we now not only use author, but try to find a "best match" if we
can't find an author name to put there.

Closes #1233592. Thanks to Sam Steingold for the request.

Changes for request #1243027, "Impove handling of AUTHOR section."
This adds support for Collab, Corpauthor, Corpcredt, Orgname,
Publishername, and Publisher. Also adds support for output of
Affiliation and its children, and support for using gentext
strings for auto-attributing roles (Author, Editor, Publisher,
Translator, etc.). Also did a lot of code cleanup and
modularization of all the AUTHOR handling code. And fixed a bug
that was causing Author info to not be picked up correctly for
metainfo comment we embed in man-page source.

Provide support for adjusting default indent.  Problem:: By
default, man pages are output with a indent of 8 characters.
That's a lot of wasted space that might better be used --
especially in cases where the content verbatim stuff that has long
lines. Change:: Added support for customizing the roff "default
indentation value" (value of IN register)
man.indentation.default.adjust (boolean) and
man.indentation.default.value params (number, 3n by default).
Also made some adjustments to get better formatting of
sub-subsection titles even without adjusting default indentation.

Formalpara, output with "run in" head.
Closes #1448905.

Added a couple of roff-cleanup string replacements to the
substitution map.

Support bold output for "emphasis remap='B'". (because Eric
Raymond's doclifter(1) tool converts groff source marked up with
".B" request or "\fB" escapes to DocBook "emphasis remap='B'".)

Doh! If I only had a nickel for every time I made the mistake of
checking for plain following-sibling instead of *first* following
sibling, I would have enough money to buy... something.

Added "Miscellaneous Technical" block to default subset. This
basically just means that the LEFT- and RIGHT-POINTING ANGLE
BRACKET characters (&#x2329; and &#x232a;, "rang" and "lang"
named entities) get converted correctly.

Disappearing whitespace in Para content, fixed.
Problem:: For a Para, in output of content of two child elements
separated by whitespace, the space gets eaten. Also, for adjacent
text nodes separated by whitespace plus a comment. Cause:: I
didn't realize that running normalize-space() on a node that only
contains space returns an empty string :) Also, did not have the
code checking for comment or PI nodes correctly. Fix:: Added code
to correctly catch whitespacespace-only nodes, comments, and PIs.

Closes #1448860 and #1448856.

Make filename be "tbl.ms" instead of just "tbl".

Use "wget -O" to prevent wget from avoiding overwrite of existing
file and creating new one with same name and auto-number suffix.

Segmentedlist, fixed character formatting within seg output.
Problem:: Seg content that contained bold/ital character
formatting was getting munged. Cause:: Existing code was running
trim.text() on Seg content; trim.text() is meant to be run only
on text nodes. Fix:: Removed call to trim.text() and replaced
with "apply templates and read resulting contents into a variable,
then run normalize-space() on that variable". That should work
OK, because Seg content model does not permit verbatim content or
any other block content as its child content.

Closes #1447578. Thanks to Daniel Leidert for reporting.

Segmentedlist output, adjusted width of table cells.
Problem:: Content of table cells in segmentedlist output wraps
even when there's still plenty of room left for text on the
current line. Cause:: Behavior described is by design in tbl(1).
It effectively sets the maximum width of cells to 1/3 of the
current line length. Not sure why... Fix:: Added called to .ll
request that causes line length to temporarily be increased to
1.62 times the current line length before table output of each
segmentedlist, then restore it back to previous width after
output of the table markup. I suppose there are probably some
cases where that will produce some undesirable results. But for
now, it gives good output for all test cases I've tried.

Moved refentry.notes.txt doc to new subdirectory.

Makefile-only mechanism for grabbing a copy of the source for the
Lesk "tbl" paper and generating plain-text and PDF output from it.

Added a secondary Refname, so we can clearly see difference
between multiple Refnamediv handling (line break between) vs.
multiple-Refname-within-same-Refnamediv handling (inline separated
with commas).

If multiple Refnamediv within same Refentry, put a ".br" line
break between them, instead of a blank line. This closes up
spacing between them and also makes it clear that the break is
intentional, not a stray.

Added a funcsynopsis test case.

Funcsynopsisinfo must be handled as a verbatim.
Problem:: Existing code was not preserving breaks and whitespace
in Funcsynopsisinfo. Cause:: Lack of awareness that
Funcsynopsisinfo is a verbatim environment. Fix:: Handle in
Funcsynopsisinfo in the same way as other verbatims (that is,
wrap in .nf/.fi requests. Additional problem: According to man(7)
man page and existing man2/ pages, all parts of a funcsynopsis
that are not args must be in bold. But because Funcsynopsisinfo
is a verbatim, it needs different roff bold markup than other
stuff. So wrapped it in ".ft B"/ft pair. (Perhaps it might make
sense to wrap the whole funcsynopsis in ".ft B"/ft instead of
trying to bold/unbold at the word level, as we are doing now. Or
perhaps not.)

Closes bug #1447121. Thanks to Joe Orton for reporting.

Added string substitution for eating extra space after .RE macro.

Itemizedlist/Orderedlist with Title, fixed handling of.
Also handling of paragraph text following a list.
Problem:: No output for Title element of Itemized/Orderedlist.
Cause:: Missing logic for matching Title instances in lists. Fix::
Added handling for Title.
Also fixed problem that caused text following a list within the
same paragraph to be indented more than expected.
Closes #1447042 and #1447072.

Added some author/editor content for the refentry, and wrapped in
an Authorgroup to test fix for #1447026.

Authorgroup handling fixed. Problem:: Content of Authorgroup was
not getting output. Cause:: Oversight in XPath expression caused
Author and friends to be found only if they were direct children
of *info. Fix:: Updated XPath expression to check for all Author
etc. descendants, not just direct children.

Closes bug #1447026. Thanks to Daniel Leidert for reporting.

Put segmentedlist within a Para so that we can make sure it gets
handled correctly for the "mixed block" case.

Added support for Segmentedlist.
Details: Output is tabular, with no option for "list" type output.
Output for Segtitle elements can be supressed by setting
man.segtitle.suppress. If Segtitle content is output, it is
rendered in italic type (not bold because not all terminals
support bold and so italic ensures the stand out on those
terminals). Extra space (.sp line) at end of table code ensures
that it gets handled correctly in the case where its source is the
child of a Para.  Closes feature-request #1400097. Thanks to
Daniel Leidert for the patch and push, and to Alastair Rankine for
filing the original feature request.

Corrected oversight in handling of Productname. Problem:: No
trademark output for Productname class="trade" instances. Cause::
Oversight. Fix:: Added handling for the specified case.

Closes bug #1447004. Thanks to Daniel Leidert for reporting.

Fixed copy/paste error in default value. Closes bug #1446966.
Thanks to Daniel Leidert for reporting.

Updated for 1.2CR1

Fixed pubdate