Updated to use new OASIS template

fileref in equation.001.xml was not resolvable

Changed @cols to 5.

fixed bug in indenting of output for contrib instances in AUTHORS
section. Thanks to Daniel Leidert and the fglrx docs for exposing
the bug.

Made reporting of missing refentry metadata more quiet:

  - we no longer report anything if usable-but-not-preferred
    metadata is found; we just quietly use whatever we manage to
    find

  - we now only report missing "source" metadata if the refentry
    is missing BOTH "source name" and "version" metadata; if it
    has one but not the other, we use whichever one it has and
    don't report anything as missing

The above changes were made because testing with some "real world"
source reveals that some authors are intentionally choosing to use
"non preferred" markup for some metadata, and also choosing to
omit "source name" or "version" metadata in there DocBook XML. So
it does no good to give them pedantic reminders about what they
already know...

Also, changed code to cause "fixme" text to be inserted in output
in particular cases:

  - if we can't manage to find any "source" metadata at all, we
    now put fixme text into the output

  - if we can't manage to find any "manual" metadata a all, we
    now put fixme text into the output

The "source" and "manual" metadata is necessary information, so
buy putting the fixme stuff in the output, we alert users to the
need problem of it being missing.

for a para or simpara that is the first child of a callout,
suppress the .sp or .PP that would normally be output (because in
those cases, the output goes into a table cell, and the .sp or .PP
markup causes a spurious linebreak before it when displayed

fixed typos in comments

Added support for rendering co callouts and calloutlist instances.
So you can now use simple callouts -- marking up programlisting
and such with co instances -- and have the callouts displayed in
man-page output. ("simple callouts" means using co@id and
callout@arearefs pointing to co@id instances; in man/roff output,
we can't/don't support markup that uses areaset and area)

initial add; pam man sources

added fglrx

added example refentry source from Debian docbook-xsl package

Rename link

added git documentation

When generating manpages output, we no longer report anything if
the refentry source is missing date or pubdate content. In
practice, many users intentionally omit the date from the source
because they explicitly want it to be generated.

only put a line of space after a verbatim if it's followed by a
text node or a paragraph

added mysql doc sources

put verbatim environments in slightly smaller font in non-TTY
output

minor whitespace-only reformatting of lists.xsl source

Made refinements/fixes to output of orderedlist and itemizedlist
-- in part, to get mysql man pages to display correctly. This
change causes a "\c" continuation marker to be added between
listitem markers and contents (to ensure that the content remains
on the same line as the marker when displayed)

put a line of vertical space after all verbatim output that has
sibling content following it (not just if that sibling content is
a text node)

refined spacing around titles for admonitions

Deal with case of verbatim environments that have a linebreak
after the opening tag. Assumption is that users generally don't
want that linebreak to appear in output, so we do some groff
hackery to mess with vertical spacing and close the space.

indexterm instances now produce groff comments like this:

  .\" primary: secondary: tertiary

remark instances, if non-empty, now produce groff comments

convert no-break space character to groff "\ \&" (instead of just
"\ "). the reason is that if a space occurs at the end of a line,
our processing causes it to be eaten. a real-world case of this is
the mysql(1) man page. appending the "\&" prevents that

Copy over the libxslt README too (currently there is no other documentation).
Do not delete the extensions directory when cleaning; only delete (non-dot) files in it.

Changed the name of the script file back to "xslt.py". Using "libxslt.py"
leads to a name clash since the script contains a "import libxslt" statement.

various changes and additions to support making with asciidoc as
an input format

initial add

re-adding empty extensions subdir

added hg and apt docs and set ignore props

make dblatex the default PDF maker for the example makefile

output "sp" before simpara output, not after it (outputting it
after results in undesirable whitespace in particular cases; for
example, in the hg/mercurial docs

renamed from title-preamble to pinch.together and replaced "sp -1"
between synopsis fragments with call to pinch.together instead

use title-preamble template for table titles (instead of "sp -1"
hack), and "sp 1" after all tables (instead of just "sp"

created title-preamble template for suppressing line spacing after
headings

fixed typo

further refinement of indenting in AUTHORS section

refined handling of admonitions

Use RS/RE in another place where we had IP ""

remove stray word that inadvertently got added to makefile

refined build of extensions subdir

make extensions packaging depend on xsl-libxslt/python/docbook.py
and xsl-libxslt/python/xslt.py

Replace (ab)use of IP with "sp -1" in AUTHORS section with RS/RE
instead.

changed all instances of ".sp -1n" to ".sp -1"

Added rules to include libxslt extensions in snapshot builds.

Tweaked the text a little.

Renamed xsl-xsltproc to the more apt xsl-libxslt.

update repository location

fail properly if VERSION not set

handle missing VERSION error correctly

updated to use debian svn as source

Adding sample refentry doc for saxonb

add extra line before SH heads only in non-TTY output

Reworked output for admonitions (caution, important, note, tip,
warning). In TTY output, admonitions now get indented. In non-TTY
output, a colored marker (yellow) is displayed next to them.

Added BM/EM macros for putting a colored marker in margin next to
a block of text.

created make.bold.title template by moving title-bolding part out
from nested-section-title template. This allows the bolding to
also be used by the template for formatting admonitions

put .br before copyright contents to prevent them from getting run in

made point size of output for Refsect2 and Refsect3 heads bigger

put slightly more space between SH head and underline in non-TTY
output

made some further doc tweaks related to the
man.charmap.subset.profile.english param

Fixed some typos.

Added the man.charmap.subset.profile.english parameter and refined
the handling of charmap subsets to differentiate between English
and non-English source.

This way charmap subsets are now handled is this:

If the value of the man.charmap.use.subset parameter is non-zero,
and your DocBook source is not written in English (that is, if its
lang or xml:lang attribute has a value other than en), then the
character-map subset specified by the man.charmap.subset.profile
parameter is used instead of the full roff character map.

Otherwise, if the lang or xml:lang attribute on the root element
in your DocBook source or on the first refentry element in your
source has the value en or if it has no lang or xml:lang
attribute, then the character-map subset specified by the
man.charmap.subset.profile.english parameter is used instead of
man.charmap.subset.profile.

The difference between the two subsets is that
man.charmap.subset.profile provides mappings for characters in
Western European languages that are not part of the Roman
(English) alphabet (ASCII character set).

Various updates, mainly related to uppercasing SH titles:

  - added a "Language: " metadata line to the top comment area of
    output man pages, to indicate the language the page is in

  - added a "toupper" macro of doing locale-aware uppercasing of
    SH titles and cross-references to SH titles; the mechanism
    relies on the uppercase.alpha and lowercase.alpha DocBook
    gentext keys to do locale-aware uppercasing based on the
    language the page is written in

  - added a "string.shuffle" template, which provides a library
    function for "shuffling" two strings together into a single
    string; it takes the first character for the first string, the
    first character from second string, etc. The only current use
    for it is to generate the argument for the groff tr request
    that does string uppercasing.

  - added make.tr.uppercase.arg and make.tr.normalcase.arg named
    templates for use in generating groff code for uppercasing and
    "normal"-casing SH titles

  - made the BB/BE "background drawing" macros have effect only in
    non-TTY output

  - output a few comments in the top part of source

removed some leftover kruft

To create the name(s) for each man page, we now replace any spaces
in the refname(s) with underscores. This ensures that tools like
lexgrog(1) will be able to parse the name (lexgrog won't parse
names that contain spaces).

Put a comment into source of man page to indicate where the main
content starts. (We now have a few of macro definitions at the
start of the source, so putting this comment in helps those that
might be viewing the source.)

added pubdate, fixed metadata handling in biblioentry

refined mechanism for generating SH titles

Added zcaron, Zcaron, scaron, and Scaron to the groff character map.
This means that generated Finnish man pages will no longer contain
any raw accented characters -- they'll instead by marked up with
groff escapes.

Added to default charmap used by manpages:

  - the "letters" part of the 'C1 Controls And Latin-1 Supplement
    (Latin-1 Supplement)' Unicode block
  - Latin Extended-A block (but not all of the characters from
    that block have mappings in groff, so some of them are still
    passed through as-is)

The effects of this change are that in man pages generated for
most Western European languages and for Finnish, all characters
not part of the Roman alphabet are (e.g., "accented" characters)
are converted to groff escapes.

Previously, by default we passed through those characters as is
(and users needed to use the full charmap if they wanted to have
those characters converted).

As a result of this change, man pages generated for Western
European languages will be viewable in some environments in which
they are not viewable if the "raw" non-Roman characters are in them.

Added in support for building the Galician locale.

fixed error in lowercase.alpha definition in Hungarian locale

corrected a regression I introduced about a year ago that caused
dots to be output just as "\." -- instead needs to be "\&." (which
is what it will be now, after this change)

Changed backend handling for generating titles for SH sections and
for cross-references to those sections. This should have no effect
on TTY output (behavior should remain the same hopefully) but
results in titles in normal case (instead of uppercase) in PS
output.

use make.subheading template to make subheadings for AUTHORS and
COPYRIGHT sections (instead of harcoding roff markup)

put code font around programlisting etc.

embed custom macro definitions in man pages, plus wrap synopsis in
code font

use the make.subheading template to generated SH subheading for
endnotes section.

Added some templates for generating if-then-else conditional
markup in groff, so let's use those instead of hard-coding it in
multiple places...

Initial checkin of some changes related to making PS/PDF output
from "man -l -Tps" look better. The current changes:

  - render synopsis and verbatim sections in a monospace/code font

  - put a light-grey background behind all programlisting, screen,
    and literallayout instances

  - prevent SH heads in PS output from being rendered in uppercase
    (as they are in console output)

  - also display xrefs to SH heads in PS output in normal case
    (instead of uppercase)

  - draw a line under SH heads in PS output

The changes made to the code to support the above features were:

  - added some embedded/custom macros: one for conditionally
    upper-casing SH x-refs, one for redefining the SH macro
    itself, with some conditional handling for PS output, and
    finally a macro for putting a background/screen (filled box)
    around a block of text (e.g., a program listing) in PS output

  - added utility templates for wrapping blocks of text in code
    font; also templates for inline code font

I changed the snapshot build to only generated zip versions of
snapshots, so change the reference to the XSL2 bz2 file to zip
file instead.

Added information on how the filename is computed.

Added support for edition.

Removed stylesheets for old, deprecated conversion method.

Added support for Open Office, added edition element, improved list and table support in Word and Pages

refpurpose nodes now get apply-templates instead of just normalize-space().

Added preliminary README information for libxslt extensions.
The adjustColumnWidths() function works well for me (tested on
Windows XP with Python 2.5).

Added a fix to make rowsep apply to the last row of thead in entrytbl.

Clarified PI usage.

Fixed alignment of first lined of text for each listitem in
orderedlist output for TTY. Existing code seemed to have been
causing an extra undesirable space to appear.

Wrapped some roff conditionals around roff markup for orderedlist
and itemizedlist output, so that the lists look acceptable in PS
output as well as TTY.

Simplified and streamlined handling of output for ANSI-style
funcprototype output, to correct a problem that was causing type
data to be lost in the output parameter definitions. For example,
for an instance like this:
  <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
... the brackets (indicating an array type) were being dropped.

Changed HTML handling of K&R-style paramdef output. The parameter
definitions are no longer output in a table (though the prototype
still is). The reason for the change is that the
kr-tabular-funcsynopsis-mode template was causing type data to be
lost in the output parameter definitions. For example, for an
instance like this:
  <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
... the brackets (indicating an array type) were being dropped.
The easiest way to deal with the problem is to not try to chop up
the parameter definitions and display them in table format, but to
instead just output them as-is. May not look quite as pretty, but
at least we can be sure no information is being lost...

Added the man.funcsynopsis.style parameter. Has the same effect in
manpages output as the funcsynopsis.style parameter has in HTML
output -- except that its default value is 'ansi' instead of 'kr'.

Reworked handling of K&R funcprototype output. It no longer relies
on the HTML kr-tabular templates, but instead just does direct
transformation to roff. For K&R output, it displays the paramdef
output in an indented list following the prototype.

Made attribute-sets members of the param list. This enables links to attribute-sets in the
reference documentation.

Fixed typo.

Properly integrated handling for K&R output into manpages
stylesheet. The choice between K&R output and ANSI output is
currently controlled through use of the (HTML) funcsynopsis.style
parameter. Note that because the mechanism does currently rely on
funcsynopsis.style, the default in manpages output is now K&R
(because that's the default of that param). But I suppose I ought
to create a man.funcsynopsis.style and make the default for that
ANSI (to preserve the existing default behavior).

added manpages/pi.xsl file

use .BI handling in K&R funsynopsis output for manpages, just as
we do already of ANSI output