Add "date" namespace.

Added trademark and servicemark mappings.

DocBook NG: The Mezcal Release

Changed version name

Updated

Restore section/simplesect

Added tests: target

Added defguide module

Added local tests

Updated build tools

Checkin new build system

Support XInclude in more places

Fix totally bogus patterns for optional/required section elements at various levels

Fix content model for toplevel sections and article components

Fix content model for toplevel and recursive sections

Typos and wording tweaks (to sync up with language in the release
notes)

(internal) Added support for TDG hyperlinking with <tag> (instead
of just <sgmltag>. Also added support for ignoring <tag>s and
<sgmltag>s that have a "namespace" attribute whose value contains
"http://docbook.sf.net/" or "http://docbook.sourceforge.net/"
(that is, those don't get turned into TDG hyperlinks).

(Note: This change has no effect on the behavior of the DocBook XSL
stylesheets; it only affects the build used to create the actual)
DocBook XSL releases.)

Replaced duplicated "charmap" IDs with good ones.

Added "namespace" attributes to non-DocBook <tag>s, to prevent
them from being converted to TDG hyperlinks.

Fixed typo.

Added not about setting man.output.quietly to speed up processing
time.

Removed leftover debugging variables.

Added support for enabling users to control what appears and does
not appear in the content of the .TH title-line header/footer.
(Closes #1210492)

Use utility.xsl

Renamed general.xsl to utility.xsl.

Implemented output-independent mechanism for gathering refentry
metadata, along with a customization parameters for tuning it.
(Closes #1232541)

Implemented capability for users to customize "refentry metadata
gathering" by specifying XPath expressions to use as "info
profiles" for gathering the data, and, in some cases, to suppress
parts of the data collected.

Added params to support makin "metadata gathering" independent of
output format (initial change for #1232541, more to follow shortly).

Added man.subheading.divider.enabled flag and tweaked doc for
man.subheading.divider

Added the following substitutions:

  <!-- * non-breaking space
  <substitution oldstring="&#x00a0;" newstring="\ "/>
  <!-- * copyright sign
  <substitution oldstring="&#x00a9;" newstring="\(co"/>
  <!-- * registered sign
  <substitution oldstring="&#x00ae;" newstring="\(rg"/>
  <!-- * left double quote
  <substitution oldstring="&#x201c;" newstring="\(lq"/>
  <!-- * right double quote
  <substitution oldstring="&#x201d;" newstring="\(rq"/>
  <!-- * left single quote
  <substitution oldstring="&#x2018;" newstring="\(oq"/>
  <!-- * right single quote
  <substitution oldstring="&#x2019;" newstring="\(cq"/>

The reason is that those are all characters that the DocBook XSL
stylesheets themselves generate under certain circumstances; so
dealing with them in man.string.subst.map ensures they will always
be replaced, even if man.charmap.enabled is zero.

Did some reorganizing.

- Moved prepare.manpage.contents template out of general.xsl file
  and into other.xsl; general.xsl templates are now all templates
  that are called multiple times for each refentry, while
  templates in other.xsl are called only once per each refentry.

- Removed get.metadata template; refentry metadata gathering is
  now done by common/refentry.xsl in a way that is independent of
  the final output format; so the common/refentry.xsl templates
  can be called not just by manpages stylesheets, but by
  stylesheets for any other output format

- Added a write.man.file template. This is basically just a
  wrapper around the write.text.chunk template; it takes "name"
  and "section" params, assembles those into a filename, then
  passes that filename to write.text.chunk

Added evaluate.info.profile template.

Update header comment.

Added trademark/productname template.

This template causes true Unicode characters to be output for the
"copyright" and "registered" symbols (which be default then get
replaced by the apply-string-subst-map template). It outputs the
string "(TM)" for trademark (because roff "\(tm" output is not
good) and "(SM)" for servicemark.

suppress Abstract

Cleaned up redundancies in refnamediv and refsynopsisdiv title handling.

Added refentry metadata-gathering documentation.

Changed title.

Initial add.

This file provides templates for gathering refentry metadata. The
templates are currently only called by the manpages stylesheets,
but they are designed to be generally useful.

initial add

Add start-indent="0pt" to counteract any body.start.indent
on an index that is in an article.

Fix regex for href to prevent fragids, not require a hash!

Added Schematron to the bibliography; fixed typo

Removed

Added XInclude

Added improved letters localization from Vitaly Ostanin

Checkpointing. In the middle of tinkering with composition of the
.TH title line. Started pulling at thread and unwound things. This
works as-is now (not broken) but is not finished.

Put quotes around section in .TH title line & normalize space in
title and section in .TH title line (as we do with all other
fields in it).

Also, added and refined comments, in part based on reading of
man(7) man page.

Added "General" stuff.

First updates for 1.69.0 release.

So far, only includes descriptions of the manpages changes. Sorry,
that is all I could managed to get done so far. If anybody else
has time to add descriptions for the HTML and FO stylesheets,
please do. Otherwise, I will get back to work on them later
tonight my time.

Set LANG=C when generating RELEASE-NOTES.txt

The LANG value in my environment is EUC-JP, and running w3m with
that causes it to use some special EUC-JP characters for bullets
and such. So, need to set LANG=C to get it to use ASCII bullets
(a.k.a. asterisks)

Gave procedure its own label.markup template because it
should not count procedures without  title.

Updated for 4.5CR1

DocBook V4.5CR1 Released

Updated version number

Tweaked freshmeat changes

Updated for 5.0a1

Removed unnecessary additional linebreak that was getting added
after each varlistentry. Also, in a couple places that needed it,
added check for *info/title (instead of just title). Also, added
support of processing title or *info/title on Refsynopsisdiv
(still falls back to gentext SYNOPSIS title if no hard-coded title
found.

Deal with *info correctly & remove some kruft.

Added support for man.subheading.divider parameter.

Added man.subheading.divider param, for enabling addition of
divider around section titles in source. This doesn't show up in
rendered man page -- it is just there to help make the source more
readable.

Added support for man.justify, man.hyphenate,
man.break.after.slash, and an.th.title.max.length parameters.
Also switch to using locale-safe "string-upper" function to
uppercase the TH title. So manpages output is now
internationalized/localizable in all respects where is can be made
so at this point.

Added man.th.title.max.length param for controlling aesthetics of
TH title line.

Added man.break.after.slash parameter.
Default is zero, which disables line-breaking after slashes.
Setting a non-zero value enables line-breaking after slashes.
This option is potentially usefull for causing long URLs and/or
pathnames to be wrapped or broken-up across lines.

Support man.justify and man.hyphenate params. (closes #1229225).

Note that default for the both of those is zero (off), because
justified text looks good only when it is also hyphenated; to
quote the "Hypenation" node from the groff info page:

  Since the odds are not great for finding a set of words, for
  every output line, which fit nicely on a line without inserting
  excessive amounts of space between words, `gtroff' hyphenates
  words so that it can justify lines without inserting too much
  space between words.

The problem is that groff is not particularly smart about how it
does hyphenation; it can end up hyphenating a lot of things that
you don't want hyphenated (names of symbols, for example), and it
is difficult and tiresome work to prevent it from doing that. So,
disabling both justification and hyphenation ensures that hyphens
won't get inserted where you don't want to them, and you don't end
up with lines containing excessive amounts of space between words.

Yes, these default settings run counter to how most existing man
pages are formatted. But there are some notable exceptions, such
as the perl man pages.

Moved the fo:basic-link for page refs to the page.citation template
so it can be more easily customized.
Fixed bug in using page keyword in role used as xrefstyle.

Added support for man.output.quietly for writing of stubs.
Also, added comments regarding display of .TH contents across
platforms.

Replace hyphens with "\-".

<sigh/> Although the old-school gnomes who maintain groff
apparently don't figure it's necessary to document this anywhere,
there is apparently only one reliable way to make a non-breaking
hyphen in groff: with "\-". At least that it what testing in my
environment seems to indicate.

And because groff is not at all smart in the way it breaks things
at hyphens (it will, for example, break command arguments across
lines if they contain hyphens), we must globally replace all
hyphens with "\-".

God in heaven, please let me live to see a day when roff and all
is (r)offspring have disappeared from the face of the earth.

Output "\-" for non-breaking hyphen.

Changed default for verbosity to 0.

ignore RELEASE-NOTES.pdf and RELEASE-NOTES.fo

"clean" target now deletes $(SOURCES) xml files instead of doing a
blanket "rm -f *.xml", which was causing hte l10n.xml file to be
deleted. That file is under version control, so deleting it was
forcing you to do a "cvs update" after you run "make clean". if
you forget, it screws up the build.

Added missing entity ref for autlayout-file param.

Adde man.charmap.enabled param.

"clean" target no longer deletes html/profile-chunk.xsl or
html/profile-onechunk.xsl
Those files are under version control, not made. So they should
not be deleted by the build.

Update to include Slides and Website info, and also some other
clarifications.

Render servicemark and trademark as (SM) and (TM).
Because console output for groff "\(tm" is not acceptable.

Doc tweak.

Fixed typo.

Added PDF release notes to release build.

Added support for generating <rx:meta-field creator="foo"/> field
for XEP. Also, added support for picking up and using contents of
<corpauthor> for XEP <rx:meta-field author="foo"/> field.

Don't add docname to olink when pointing to root element.

Removed the start-indent on qandadiv because it conflicts with
other indents, and that style should be implemented with
a property set.

Implemented "character map" system for replacing Unicode
characters. (closes #1226009).

::PROBLEM:
The existing manpages mechanism for replacing Unicode symbols and
special characters with roff equivalents is not scalable and not
anywhere near as complete as it should be.

For example, the mechanism currently only handles a (somewhat
arbitrary) selection of less than 20 or so Unicode characters.

But there are potentially more than _800_ Unicode special
characters that have some groff equivalent they can be mapped to.

And there are about 34 symbols in the Latin-1 (ISO-8859-1) block
alone. Users might reasonably expect that if they include any of
those Latin-1 characters in their DocBook source documents, they
will get correctly convered to known roff equivalents in output.

In addition to those common symbols, certain users may have a need
to use symbols from other Unicode blocks.

Say, somebody who is documenting an application related to math
might need to use a bunch of symbols from the "Mathematical
Operators" Unicode block (there are about 65 characters in that
block that have reasonable roff equivalents).

Or somebody else might really like Dingbats -- such as the
checkmark character (I like that one myself) and so might use a
bunch of things from the "Dingbat" block (141 characters in that
that have roff equivalents or that can at least be "degraded"
somewhat gracefully into roff).

So we need a mechanism that is capable of handling all those 800
Unicode characters that have roff equivalents -- and/or of
allowing users to choose which Unicode blocks to use (through
tuning the value of a parameter or something).

::FIX:
Replaced the current Unicode character-substitution mechanism
(replace-entities template) with a completely different
character-substitution mechanism that is based on use of a
"character map" (in a format compliant with the XSLT 2.0 spec and
therefore completely "forward compatible" with XSLT 2.0).

By default, the new "character map" mechanism 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 is controlled through the following parameters:

  - man.charmap.enabled:
      turns character-map support on/off

  - man.charmap.use.subset.xml
      specifies that a subset of the character map is used instead
      of the full character map

  - man.charmap.subset.profile.xml
      specifies profile of character-map subset

  - man.charmap.uri.xml
      specifies an alternate character map to use instead of the
      "standard" character map provided in the distribution

For more details, see the current documention at:

  http://docbook.sf.net/snapshot/xsl/doc/manpages/charmap.html

Always make NEWS

Added IDs for sub-references, so that "human readable" filenames
are generated based on those (instead of, e.g., "rn.html")

Made doc source compliant with expectations of doc build.

Doc tweak.

Added "man.string.subst.map" parameter for controlling roff string
substitution performed just before applying character map. The
value of this parameter is not really intended to be monkeyed
with, but adding it as a param just in case.

Doc tweak to match user/developer distinction.

Doc tweak.

Ignore slides and website subdirs

Added an "apply-string-subst-map" function (template). Only
difference is that in the map that it expects, "oldstring" and
"newstring" attributes are used instead of "character" and
"string" attributes.

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 (&#45;); 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 (&#45;/&#x2D;) 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
      (&#45;), then you should use (&#8722;/&#x2212;) in your
      source instead. And if you have a place where you want an
      en dash, (&#8211;/&#x2013;). Or if there are places where
      the stylesheets are internally generating (&#45;) where they
      should be generating &#8722; or &#8211;, 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