Checkpointing before coding and committing final character-map changes.

This change fully implements character-map support. I'll write up
a longer description of that in a later commit. But the brief
description is: The old Unicode character replacement mechanism
(replace-entities template) has been removed; a completely
different character-replacement mechanism is now used instead.

By default, it does replacement of all Latin-1 symbols, along with
most special spaces, dashes, and quotes (about 75 characters by
default, compared to the less than 20 special characters that were
handled previously). And the "full" character map provides support
for converting about 800 characters. The mechanism use a
"character map" (in a format compliant with the XSLT 2.0 spec and
therefore completely "forward compatible" with XSLT 2.0.

Other changes made for this commit:

  - Changed default output encoding to UTF-8.

    THIS DOES NOT MEAN THAT MAN PAGES ARE OUTPUT IN RAW UTF-8,
    because the character-map is applied before final output,
    causing all UTF-8 characters covered in the map to be
    converted to roff equivalents.

  - Removed code for adding backslashes before periods/dots and
    before hyphens (-); here's why:

    * Backslashes in front of periods/dots are needed only in the
      very rare case where a period is the very first character in
      a line, without any space in front of it. A better way to
      deal with that rare case is for authors to add a zero-width
      space in front of the offending dot(s) in their source

    * Backslashes in front of (-/-) are needed... when?
      Myself, I don't know, so the current stylesheet does not add
      backslashes in front of them, ever. If there is a specific
      case where they are necessary or desirable, then we need to
      add code for that case, not just do a blanket conversion.

      And, anyway, my understanding from reading the groff docs is
      that \- is, specifically, a _minus sign_. So if you have a
      place where you want a minus sign to be output instead of
      (-), then you should use (−/−) in your
      source instead. And if you have a place where you want an
      en dash, (–/–). Or if there are places where
      the stylesheets are internally generating (-) where they
      should be generating − or –, then we need to fix
      those, not just do blanket conversion.

  - Consolidated all bold and italic formatting so that it is done
    by applying the mode="bold" and mode="italic" templates.

  - Consolidated handling of all instances where we want to
    prevent line breaking; they are all now processed using the
    prevent.line.breaking template.

  - Removed "quote" template. In output, this was causing anything
    marked up with the <quote> element to be preceded by two
    backticks and followed by two apostrophes  -- that is, that
    old-school hack for generating "curly" quotes in Emacs and in
    X-Windows fonts. While Emacs still seems to support that,
    I don't think X-Windows has for a long time now. And, anyway,
    it looks (and has always looked) like complete crap when
    viewed on a normal tty/console

Reworked default value to make reworked character map.

Switched to "block" and "class" attributes and back to using real
backslashes instead of @esc@ hack.

Documentation changes

Documentation improvements

Changed prefix for annotations namespace

Added doc: structured comments

Added initial, EXPERIMENTAL support for generating content for
HTML "title" attributes from content of the Alt element.

This change adds support for generating HTML "title" attributes
for the following inline elements only (all inlines -- support for
block elements will need to wait for later).

  abbrev accel acronym action application authorinitials beginpage
  citation citerefentry citetitle city classname code command
  comment computeroutput constant country database email envar
  errorcode errorname errortext errortype exceptionname fax
  filename firstname firstterm foreignphrase function glossterm
  guibutton guiicon guilabel guimenu guimenuitem guisubmenu
  hardware honorific interface interfacedefinition interfacename
  keycap keycode keysym lineage lineannotation literal markup
  medialabel methodname mousebutton option optional otheraddr
  othername package parameter personname phone pob postcode
  productname productnumber prompt property quote refentrytitle
  remark replaceable returnvalue sgmltag shortcut state street
  structfield structname subscript superscript surname symbol
  systemitem tag termdef token trademark type uri userinput
  varname wordasword

Implemented by creating a new named template, generate.html.title.
That is is currently called in eleven places only, in the
inline.xsl file. But it's called by all the inline.* templates
(e.g., inline.boldseq), which in turn are called by other
(element) templates, so it results, currently, in supporting
generation of the HTML "title" attribute for a total of about 93
elements (the list above).

Added support for chunking revhistory into separate file (similar
to the support for doing same with legalnotice). Patch from Thomas
Schraitle (closes #1096574). Controlled through new
generate.revhistory.link parameter.

Added doc.

Applied patch from Anatoly Techtonik to correct problem of
multiple name attributes generated for output of Reference element
(closes #1226390)

Fixed markup error.

Doc tweaks

Changed default for man.output.encoding to UTF-8. Because
character-map processing depends on it. Also added note saying
that changing the value to another encoding my break character-map
processing, so set man.charmap.enabled to 0 in that case.

Added links to Zvon character search form.

Added several parameters for manpages output.

I have chosen to use a man.* naming strategy for all man-only
params (which these all are), even though in some cases the params
are basically the same as existing params (man.alignment and
man.hyphenate are basically same as the corresponding FO params,
man.output.encoding is same thing as chunker.output.encoding,
man.output.quietly is same as chunk.quietly).

One reason I went with create new params instead of reusing
existing ones is that this allows default values to be used for
manpages output that are different than the ones for whatever
other output format. For example, I set default for man.alignment
to "left" and man.hyphenation to "false". The corresponding FO
params have defaults of "justify" and "true".

And, as far as the man.* naming strategy, yeah, I guess it it
redundant. If, for example, all the HTML-only params started with
html.*, I guess it might not be so great idea. Or maybe it would
be. Anyway, I don't think there will probably ever be more than 30
man.* params total (god help us). And for developers at least, I
think it is helpful to be able to sort params by prefix if they
want to. Because, well, we now have 434 separate files in the
params/ directory. Going through those to find, say, just the
ones that relate to manpages output is a whole lot easier if they
all start with the same prefix.

Finalized read-character-map() and apply-character-map() functions.

Added letters localization from Vitaly Ostanin

Added support for keyboard navigation in Opera. It was not very hard given fact that Opera tries to be as compatible with IE as possible ;-)

Fixed bug #1223236. Mode attribute was removed from named templates.

Added "class" attribute on all characters, value of which is the
name of the Unicode block the character is from.

This replaces the use of the ad-hoc "class='default'" scheme.

Make xsl subdir.

ignore param.xml and param.xsl

Slides title should also be centered to maintain compatibility with previous versions.

Added initial versions of replace-chars-with-strings() and
apply-character-map() functions. These are intended mainly for use
in the manpages stylesheets but may be useful elsewhere too.

I need to fix the logic in the manpages stylesheet so that the
character-map file is read only once per document. The way it is
now, the character map is read each time a refentry is found,
which is a big waste.

Incorporated slides and website stylesheets into the build.

Note: This currently only affects the "distrib" (doc) build. So if
you don't need to build distrib/doc, you won't be affected by this
change. If you DO need to build distrib/doc, it will break unless
you use the xsl/Makefile from the "build" branch instead of from
the head.

This build alters the distrib build such that:

  - an xsl/slides directory is created by copying over the
    contents of the slides/xsl

  - an xsl/website directory is created by copying over the
    contents of the website/xsl directory

  - the reference.html part of the doc build now adds the slides
    and website param reference doc

This is an experiment. If we decide to go ahead with it in the
release build, and everything is found to be OK when it gets out
to users and they test it, then the next step would be to ask SF
admin to move the website/xsl and slides/xsl CVS directory into
xsl/ to create xsl/slides and xsl/website, and they would be
maintained in the xsl/ CVS going forward.

Switch to "real" params build (i.e., same as docbook-xsl params).

initial add

And yet more clarifications...

Further clarifications.

Added clarification that current params are for HTML output only.

Refined doc build.

  - Changed makefiles in docsrc/fo, docsrc/html, and
    docsrc/manpages dirs to depend on corresponding params.xsl
    instead of on param.xweb. Rationale is that param.xsl gets
    rebuilt any time param.xweb changes. In addition, param.xsl
    gets rebuild any time any included params/*.xml file is
    changed. So making docsrc/* builds depend on param.xsl
    effectively makes them depend on both the param.xweb changes
    on on the actual param changes.

  - Changed doc/Makefile so that reference.html is rebuilt only
    when docsrc/reference.xml changes, not when any of its
    included files change. Rationale is that, because we chunk
    output for the doc build, reference.html is simply a sort of
    TOC page that doesn't need to get remade if the included files
    change. Because output of those included files goes to
    separate fo, html, and manpages subdirs, and that output gets
    generated by seperate make targets.

initial add

Escape angle brackets and square brackets in doctype
declaration/subset.

Switched to using PIs instead of comments, because osx and
sgml2xml don't preserve comments by default.

initial add

Clarified the use of this parameter with FOP.

Removed. No longer used by build. html/xref.xsl is used "as is"

Created an other.xsl file and moved some templates into it.

More charmap reorganization.

  - Removed unicodetrans.xsl file (function moved to lib/lib.xsl).

  - Removed charmap.groff.xml & charmap.roff.min.xml and created a
    single charmap.groff.xsl file that incorporates both (using a
    class="default" attribute/value to mark those mappings that
    are in the default/minimal set).

  - Made charmap.groff.xsl into a "real" (valid) XSLT 2.0 character
    map so it can be used as-is for XSLT 2.0-aware processing (e.g.,
    it can imported or included into another XSLT 2.0 stylesheet).

Trademark symbol handling made consistent with handling of same in
HTML stylesheets. (closes #1218286; thanks to Mauritz Jeanson for
reporting the problem)

Prior to this change, if you processed a doc that contained no
value for the Class attribute on the Trademark element, the HTML
stylesheets would default to rendering a superscript TM symbol
after the Trademark contents, but the FO stylesheets would render
nothing. This change alters the FO handing of Trademark such that
it is now identical to the HTML handling.

Reverted some recent build changes.

Reverted build of xref.xsl. Will no longer need it after Unicode
char handling change is made.

Reverted build of single-pass profiling stylesheet (for now). It
doesn't appear to work with manpages, and figuring if and how I
can get it work is a very low priority, especially given that
single-pass profiling doesn't work with documents that contain
xref instances. If you want to profile content before converting
to man-page output, please just do a separate profiling pass first.

Made further changes for Unicode character translation.

Renamed roff.charmap.xml to charmap.groff.xml.
Added charmap.roff.min.xml (minimal subset of around 40 "safe"
mappings appropriate for nroff as opposed to groff).

Removed $charmap.file param from unicodetrans.xsl in preparation
for adding it as a real param to param.xweb

Corrected stray comment.

Added initial backend support for more complete and robust
translation of Unicode special characters/symbols into
corresponding roff escape sequences.

(devel-only issue) replace-string() -> string.subst()

Removed the used-in-manpages-stylesheet-only replace-string()
function and replaced all instances where it had been called with
calls to the same string-substitution function used by the HTML
and FO stylesheets: string.subst() from ../lib/lib.xsl

Reworked *info gathering and rethought Refclass handling.

For each Refentry found, we now cache its *info and its parent's
*info as node-sets; we then do all further matches against those
node-sets (rather than re-selecting the original *info nodes each
time we need to check them).

Also, reverted the special handling of Refclass that was added
recently. We eventually need to make Refclass handling consistent
with that of the HTML and FO stylesheets.

Don't render NAME heading for secondary Refnamedivs (closes #1216292)

If a document has multiple Refnamedivs, a NAME heading was getting
rendered for each. But we only need one NAME heading. This change
causes it to be rendered just once. This makes behavior in this
respect consistent with how the HTML and FO stylesheets handle the
generated NAME heading for Refnamediv.

Fixed typo.

Added some Notes section with info contributed by Barry Rountree.

Original changelog from the docbook/contrib/xsl/db2man days.
Adding so that we at least have access to a record of the change
descriptions here (if not the whole CVS history).

Removed unnecessary trailing comma after final term/glossterm
(closes #1215890; thanks to Sam Steingold for reporting the
problem).

::PROBLEM::
If a varlistentry or glossentry contains multiple term or
glossterm elements, a comma is rendered after the final term or
glossterm. A comma should instead be rendered only after every
term or glossterm _except_ the last.

::FIX::
Reworked template logic for term/glossterm. They are now handled
with an xsl:for-each in the varlistentry/glossentry template,
rather than as separate templates.

HTML and FO stylesheets appear to have the same problem, so we
probably need to port this change to those as well.

Added Tagalog locale file contributed by Ramil Sagum.

Uppercase titles in x-ref to Refentry children (closes #1215547;
thanks to Jens Granseuer for reporting the problem).

::PROBLEM::
Titles of all first-level sections in man pages are always
rendered in uppercase. But cross-references to those titles are
not uppercase.

::FIX::
Cross-references to titles of all first-level sections of Refentry
output are now rendered in uppercase; that is, titles in x-refs to
Refnamediv, Refsynopsisdiv, Refsect1, and any Refsection that is a
direct child of Refentry.

Also, x-ref to Refnamediv now uses the localized "NAME" title
instead of the using the first Refname child. This makes the
output inconsistent with HTML and FO output, but for man-page
output, it seems to make better sense to have the "NAME". (It may
actually make better sense to do it that way in HTML and FO output
as well.) That said, I guess it's not likely that most people
would put in an x-ref to a Refnamediv section, so maybe it's kind
of a moot point...

Added tl.xml

Added Amharic locale file contributed by the The Ge'ez Frontier
Foundation.

Fixed bug [ 1212159 ] Missing navigational links with XHTML chunking
which was caused by the following:

1.  When chunk.hierarchy is created, it is a collection of
div elements in a variable, and then that is converted to a
node-set by exlt.

2.  In HTML, there is no namespace, so the div elements are in
no namespace and they work.

3.  In XHTML, the div elements are in the xhtml namespace because
it is the default namespace.  So they cannot be addressed as
just "div", they must have a namespace prefix.

4.  I added an explicit chunkfast namespace to avoid conflict
with the default namespace.

Added support for processing funcparams (closes #1213166; thanks
to Barry Rountree for reporting).

::PROBLEM::
The funcparams element was not being processed as expected.

::CAUSE::
No logic existed in manpages stylesheets for handling funcparams.

::FIX::
Fixed by taking old code for handling of funcprototype and
children, and replacing it with code ported over from HTML
templates for ANSI-style output.

::AFFECTS::
This change affects handling of all funcprototype output. Along
with adding support for funcparams, the following changes were
also made:

  - removed the space that was being output between funcdef and
    paramdef; example:

      was: float rand (void);
      now: float rand(void);

  - turned off bold formatting for the <type> element when it
    occurs within a funcdef or paramdef

  - moved space -> nobreak-space replacement logic into a separate
    template (for potential re-use elsewhere if we need it)

::TODO::
We need to add an option for K&R style funcprototypes.
See #1213277.

  http://sourceforge.net/tracker/index.php?func=detail&aid=1213277&group_id=21935&atid=516914

Backed out patch for #1211477 because it breaks table processing in Saxon.

Applied patch from David Green for #1211477, to prevent
StackOverflowError encountered when processing tables with ~700
rows with Xalan. Smoke-tested and didn't see any obvious problems
with the fix, so going ahead and committing it so others can test
with snapshot.

Align refnamediv title correctly when refentry.generate.title
is non-zero (closes #1212641).

::Problem:
When refentry.generate.title is non-zero, the title output for
Refnamediv is not aligned flush left.

::Cause:
No code for setting start-indent="" was included in
refentry.title.properties. It should be in order to make the
Refnamediv title output be flush left, as are titles for all other
sectioning children of Refentry

::Fix:
Added code for setting start-indent="" in
refentry.title.properties.

Generate XEP bookmarks for Refentry children. (closes #1212491)

Titled child sections of Refentry (Refsynosisdiv, Refsection, and
Refsect1 to Refsect3) were not included in the match statement
used for generating XEP bookmarks. Don't know whether that was
intentional for some reason or whether it was just an oversight.
But given that both AXF and Passivetex bookmarks are generated for
those same Refentry children, it seems like XEP ones ought to also
be generated, for the sake of consistency if for no other reason.

Corrected formatting of generated "Name" title in refentry output
(closes #1212396; thanks to Andreas Lalloo for reporting the
problem).

:Problem::
The "Name" title generated for FO output of Refnamediv in Refentry
is not aligned flush left, as all the other subheadings of
Refentry are, and as the generated Name subheading for Refentry is
in HTML output. Also, the Name title is in a larger font size than
the titles of the other first-level children of Refentry.

:Fix::
The "Name" title generated for FO output of Refnamediv in Refentry
is now handled using the same formatting as that used for all
other first-level children of Refentry.

::Affects:
Along with affecting processing for generated titles for
Refnamediv in FO output, it is possible that this change may have
unanticipated side effects on processing of titles for
Refsynopsisdiv, Refsection, and Refsect1 to Refsect3. The reason
is that part of this change takes the template contents formerly
used only for processing Refsynopsisdiv, Refsection, and Refsect1
to Refsect3, and "repurposes" those template contents for use in
processing the generated title for Refnamediv.

Fixed bug #1202971, chunktoc doesn't handle the chunk.tocs.and.lots=1
parameter.

The table.width template can now sum column specs if none use % or *.

Add support for HTML markup table border attribute, applied to each table cell.

Re-worked construction of .TH title line (closes #1210488).
Also, made comment generated at top of page include version info
(closes #1211254).

Here are the details about the refinements made to the
construction of the .TH title line:

  - "extra1" (which shows up in the center footer of each page):
    If a date cannot be found in the source, we now automatically
    generate a localized "long format" date

  - "extra2" (which shows up in the left footer):
    We now first search for "product version" info; then, if we
    can't find that, a "product name"; if we can't find that, we
    look for "other" info to use. And we can't find that, we leave
    it empty. The exact sequence of elements checked is this:

      1. productnumber in info or refentryinfo
      2. productnumber in info or referenceinfo of parent reference
      3. any refmeta/refmiscinfo that has class = 'version'
      4. productname in info or refentryinfo
      5. productname in info or referenceinfo of parent reference
      6. refmeta/refmiscinfo (first one)
      7. refnamediv/refclass (first one)

  - "extra3" (which shows up in the center header):
    The exact sequence of elements checked is now this:

      1. title in info or referenceinfo of parent reference
      2. refnamediv/refclass (first one)
      3. refmeta/refmiscinfo (first one)

Fixed typo in comment.

Standalone stylesheet for stripping namespaces from DocBook 5/NG
docs. You currently need to do two-pass processing to use this:
First, transform your DocBook 5/NG source doc using this, then
transform the result as usual with the manpages/docbook.xsl
stylesheet. Of course you can always run the process using a pipe
if you want. Example:

  xsltproc ./manpages/stripns.xsl myRefEntry.xml \
    | xsltproc ./manpages/docbook.xsl

It may be that there is actually some way to set it up as a
single-pass XSLT process, as is done with the HTML stylesheets.
But I've not yet figured out how to get that to work...

Added support for processing refsection down to any arbitrary
level of nesting (closes #1210482).

Added support for refsect3 and formalpara processing (closes
#1210478 and #1210479).

Also did some further templates re-organizing, including to the
logic for gathering and processing metadata.

Previous change (adding text-align="left") caused article titles to be displayed left aligned instead centered. This was backward incompatible change in presentation. Now attribute set is conditional and outputs text-align="center" for titles of standalone articles.

Probably in the future more general fix should be done -- either creating separate article.title.properties, or refactoring FO properties settings between titlepage templates and attribute sets.

Context node must be stored/restored in order to get correct language code. (Note that for-each changes current node.)

Added lib directory to the list of directories for which separate Makefile is called

Made path to chunker.xsl stylesheet relative.

Portability tweaks for the build.

  - pull in cvstools/Makefile.incl, mainly so that we can use
    cvstools/runtrang

  - "trang" -> $(RUNTRANG) so that cvstools/runtrang is used; if
    users don't have trang binary installed, that will find
    trang.jar and run it. Also allows users to manually specify
    what trang they want (e.g., "make RUNTRANG=trang")

  - "clean" target now also removes dbforms* files

  - "clean" target now also does "make -C build clean"

  - "xsltproc" -> $(XSLTPROC)

Added references to newly added parameter l10n.gentext.use.xref.language

Added header (with RCS keywords and copyright info) to all files
that lacked it.

Removed. This file has never been included by docbook.xsl, so it
serves no purpose at all...

Modularized a bit further.

Make build more portable.

Added include for $DOCBOOK_CVS/cvstools dir and:

  - replaced hard-coded "saxon" with $(XSLT)
  - replaced hard-coded "trang" with $(RUNTRANG)
  - added PERL=perl variable and replaced hard-coded "perl" with
    $(PERL)
  - replaced hard-coded rm with $(RM)

Modularized main "refentry" template a bit.

Make language codes RFC compliant (closes #1208931; thanks to
Bernd Groh for reporting).

::PROBLEM:
  Stylesheets output two-part language codes in the form "zh_CN".
  But underscores in language codes are actually neither RFC
  compliant nor compliant with the HTML 4.0 rec. The separator
  should be a hyphen. To quote the specs:

    Section 8.1.1, "Language Codes"[1], in the HTML 4.0 Rec.
    states that:

    [RFC1766] defines and explains the language codes that MUST be
    used in HTML documents.

    Briefly, language codes consist of a primary code and a
    possibly empty series of subcodes:

      language-code = primary-code ( "-" subcode )*

    And in RFC 1766, "Tags for the Identification of
    Languages"[2], the EBNF for "language tag" is given as:

      Language-Tag = Primary-tag *( "-" Subtag )
      Primary-tag = 1*8ALPHA
      Subtag = 1*8ALPHA

    [1] http://www.w3.org/TR/REC-html40/struct/dirlang.html#h-8.1.1
    [2] http://www.ietf.org/rfc/rfc1766.txt

::CAUSE:
  Stylesheets simply pass through language codes unaltered. So if
  users put "zh_CN" in their source, they will get "zh_CN" in
  their HTML output.

::FIX:
  Added a new boolean config parameter, "l10n.lang.value.rfc.compliant",
  set to 1 by default. If it is non-zero, any underscore in a
  language code will be converted to a hyphen in HTML output. If
  it is zero, the language code will be left as-is.

::AFFECTS:
  This change affects any HTML output that contains two-part
  language codes.

Fixed typo.

minor formatting change

Replaced leftover instances of "Website"

Fixed bug #851598 links to legalnotice in html are broken.

Set start-indent and end-indent for fo:table-body used to format lists to
zero so that they do not inherit any start-indent from their container, which
would indent relative to the cell boundary.

Cause "clean" target to remove xref.xsl

Make xrefs and olinks work, and prevent instances of &#8220; and
&#8221; entities in output (closes #741578 and #956072; thanks to
Jens Granseuer and Sam Steingold for reporting the problems)

::Problem:
  If you include an xref in a source document, instead of getting
  the xref text you would expect in the output, you just get
  "[xref to refsect1]", where "refsect" is the name of the target
  element for the xref.  If you include an olink, it works as
  expected -- except that the output text has &#8220; and &#8221;
  entities (double "curly" quotation marks).

::Cause:
  The manpages/docbook.xsl driver imports the html/docbook.xsl
  stylesheet, which in turn imports the html/xref.xsl file.

  The manpages/docbook.xsl file then imports the manpages/xref.xsl
  file. That file contains a "xref" template that overrides the
  the one in html/xref.xsl and that, by design, does nothing
  except to generate the "[xref to refsect1]" text instead of the
  expected xref output.

  On the other hand, the manpages stylesheets don't override the
  "olink" template; therefore, the "olink" template from the
  html/xref.xsl file is used "as is". And being that it is
  intended for HTML output, that template uses the &#8220; and
  &#8221; to wrap titles in xref output.

::Fix:
  The original manpages/xref.xsl file has now been removed. The
  build for the manpages distribution now makes that file, using
  the textify.xsl stylesheet to automatically generate it from the
  html/xref.xsl file. It is built in such a away that it basically
  just contains special copies of the "xref" and "olink" templates
  that cause &#8220; and &#8221; instances to be transformed into
  "\(lq" and "\(rq" (groff "left quote" and "right quote").

  It might seem odd that templates from the html/xref.xsl are
  used, since those templates a designed to generate hyperlinks of
  the form <a href="#foo">the section called "Bar"</a>. But it
  works because the manpages stylesheets end up using the text
  value of the output of the above. Thus, the <a href="#foo"> and
  </a> parts are stripped out, leaving just the text between
  ('the section called "Bar"').

::Affects
  Only affects output of xref and olink elements. The fix may not
  be complete and/or may cause other problems. Please test.

  In particular, while it may fix the &#8220; and &#8221; problem
  that English lang/locales users have run into, it doesn't fix
  the corresponding problem for output of xrefs and olinks in many
  non-English locales, which use quoting characters other than
  &#8220; and &#8221;

  To give just one example of many: in Japanese, the quoting
  characters are &#12300; and &#12301; ("left corner bracket" and
  "right corner bracket"). It is possible to "fix" the problem for
  all locales; but it is just a question of whether there is
  enough of a demand for it that it is worth doing.

Classical HTML index is suppressed in a cleaner way as suggested by David Cramer

Whitespace-only change. Expanded all tabs

Added replace-ldqou and replace-rdquo templates, for translating
&#8220; to \(lq and  &#8221; to \(rq

Prevent "sticky" fonts changes. (closes #956070; thanks to Sam
Steingold for reporting the problem, and for his patience...)

::Problem:
  Sometimes a bold or italic font change inadvertently ends up
  becoming "sticky" such that a following chunk of text that
  should just be rendered as plain text instead gets
  boldfaced/italicized.

::Cause:
  Font changes were simply being nested, as they are in HTML.
  While that works for HTML, it doesn't work for roff, where
  font-change instructions aren't actually intended to nest.

::Fix:
  Attempted to un-nest bold/italic font changes. When the manpages
  stylesheets encounter node sets that need to be boldfaced or
  italicized, they now put the \fBfoo\fR \fIbar\fR groff
  bold/italic instructions separately around each node in the set.

  This may not be a complete fix for the problem. In fact, it may
  cause other problems. Please test :^)

Support generation of choice separator in inline simplelist
(closes #1207532)

This ehancement enables auto-generation of an appropriate
localized "choice separator" (for example, "and" or
"or") before the final item in an inline simplelist.

To indicate that you want a choice separator generated
for a particular list, you need to put a processing
instruction (PI) of the form <?dbchoice choice="foo"?>
as a child a of the list. For example:

  <para>This release adds localiation support for the
  following Indic languages:
    <simplelist type="inline">
      <?dbchoice choice="and" ?>
      <member>Hindi</member>
      <member>Punjabi</member>
      <member>Tamil</member>
      <member>Oriya</member>
      <member>Gujarati</member>
    </simplelist>.
  </para>

Output (for English):

  This release adds localiation support for the
  following Indic languages: Hindi, Punjabi, Tamil,
  Oriya, and Gujarati.

Or if the logical relationship between the items in the
list is an "or" relationship, then use choice="or":

  <para>Choose from ONE and ONLY ONE of the following:
    <simplelist type="inline">
      <?dbchoice choice="or" ?>
      <member>A</member>
      <member>B</member>
      <member>C</member>.
    </simplelist>
  </para>

Output (for English):

  Choose from ONE and only ONE of the
  following choices: A, B, or C.

As a temporary workaround for the fact that most of the
DocBook non-English locale files don't have a
localization for the word "or", you can put in a
literal string to be used; example for French:

  <para>Choose from ONE and ONLY ONE of the following:
    <simplelist type="inline">
      <?dbchoice choice="ou" ?>
      <member>A</member>
      <member>B</member>
      <member>C</member>.
    </simplelist>
  </para>

That is, use "ou" instead of "or".

Rolled back some over-aggressive line-break cleanup, and removed
space-normalizing call in group|arg template because it causes
<sbr/> to be handled incorrectly.

Minor update to date/time handling.

Make handling of date format strings more robust (closes #1206837).

::Problem:
  If the "dbtimestamp" PI has words in it that contain any of the
  single-letter characters used as date/time formatting
  instructions, the output is not what would be expected.

  For example, Spanish "long" dates look like this:

    23 de mayo de 2005

  So you would expect that you could generate a date of that form
  using the dbtimestamp PI with a format string like the following:

    <?dbtimestamp format="d de B de Y"?>

  But if you try that, you get the following output:

    23 23e mayo 23e 2005

  That is, the "d" in "de" is replaced with the day of the month.

::Cause::
  The format-string parsing logic works by walking through the
  format string character-by-character. So when it gets to the "d"
  in "de", it has no way of discerning that it is not the "d"
  formatting instruction but is instead part of a word intended to
  be included in the output as a literal string.

::Fix::
  The format-string parsing logic now splits format strings into
  tokens and delimiters and evaluates them token-by-token instead
  of character-by-character.

  For example, it splits the Spanish "long" date format like this:

    <token>d</token> <token>de</token> <token>B</token> ...

  Thus, in looking for the "d" formatting instruction, the "d"
  token matches but the "de" token does not.

  As delimiters, it recognizes the following characters:

    <space> <tab> <CR> <LF> , . / - ( ) [ ]

::Affects:
  This change affects output of the "dbtimestamp" PI as well as
  output from any customization layers that call the
  "datetime.format" template. It affect all formats (HTML, FO, etc.).

Grand Unification: Epilogue (2): If "neighboring" text nodes in
mixed content are whitespace-only, apply the special sauce just
before serving; that is, at the end, not both at the beginning and
at the end.

Repaired line-breaking in list output. Thanks to Hendrik Sattler
for reporting the problem.

The cause of this is was a change that was made a while back to
reduce excessive blank lines in output. Looks like in this case it
cut it back a bit too aggressively. There may yet be some other
cases that will need more fine-tuning.