OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [docbook-apps] ANNOUNCE: DocBook XSL 1.71.1 released


Version 1.71.1 of the DocBook XSL stylesheets is now available for
download from the DocBook project site.

  http://docbook.sf.net/files/xsl/latest
  http://docbook.sf.net/files/xsl-doc/latest
  http://sourceforge.net/projects/docbook

The release notes are included below. HTML and PDF versions of the
release notes are also available:

  http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.html
  http://docbook.sf.net/release/xsl/current/RELEASE-NOTES.pdf

------------------------------------------------------------------------------

This is a minor update to the 1.71.0 release. Along with a number of bug
fixes, it includes two feature changes:

  * Added support for profiling based on xml:lang and status attributes.

  * Added initial support in manpages output for footnote, annotation, and alt
    instances. Basically, they all now get handled the same way ulink
    instances are. They are treated as a class as "note sources": A numbered
    marker is generated at the place in the main text flow where they occur,
    then their contents are displayed in an endnotes section at the end of the
    man page.

Common

The following changes have been made to the common code since the 1.71.0
release.

  * For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.

  * Add support for Xalan generating a root xml:base like saxon.

FO

The following changes have been made to the fo code since the 1.71.0 release.

  * For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.

  * Add support for Xalan to add root node xml:base for db5 docs.

  * Added support for profiling based on xml:lang and status attributes.

HTML

The following changes have been made to the html code since the 1.71.0
release.

  * For backward compatability autoidx-ng.xsl is invoking "kosek" indexing method again.

  * Add support for Xalan to add root node xml:base for db5 docs.

  * Added support for profiling based on xml:lang and status attributes.

  * Made changes in namespace declarations to prevent xmllint's
    canonicalizer from treating them as relative namespace URIs.

      - Changed xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService"
        to xmlns:k="http://www.isogen.com/functions/com.isogen.saxoni18n.Saxoni18nService";;
        Saxon accepts either form
        (see http://www.saxonica.com/documentation/extensibility/functions.html);
        to Saxon, "the part of the URI before the final '/' is immaterial".

      - Changed, e.g. xmlns:xverb="com.nwalsh.xalan.Verbatim" to
        xmlns:xverb="xalan://com.nwalsh.xalan.Verbatim"; Xalan accepts
        either form
        (see http://xml.apache.org/xalan-j/extensions.html#java-namespace-declare);
        just as Saxon does, it will "simply use the string to the
        right of the rightmost forward slash as the Java class name".

      - Changed xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect"
        to xmlns:redirect="http://xml.apache.org/xalan/redirect";, and
        adjusted associated code to make the current Xalan redirect spec.
        (see http://xml.apache.org/xalan-j/apidocs/org/apache/xalan/lib/Redirect.html)

  * Added the html.append and chunk.append parameters. By default, the
    value of both is empty; but the internal DocBook XSL stylesheets
    build sets their value to "<xsl:text>&#x0a;</xsl:text>", in order
    to ensure that all files in the docbook-xsl-doc package end in a
    newline character. (Because diff and some other tools may emit
    error messages and/or not behave as expected when processing
    files that are not newline-terminated.)

Highlighting

The following changes have been made to the highlighting code since the 1.71.0
release.

  * Added license information

Manpages

The following changes have been made to the manpages code since the 1.71.0
release.

  * Added initial support in manpages output for footnote, annotation,
    and alt instances. Basically, they all now get handled the same
    way ulink instances are. They are treated as a class as "note
    sources": A numbered marker is generated at the place in the main
    text flow where they occur, then their contents are displayed in
    an endnotes section at the end of the man page (currently titled
    REFERENCES, for English output, but will be changed to NOTES).

    This support is not yet complete. It works for most "normal"
    cases, but probably mishandles a good number of cases. More
    testing will be needed to expose the problems. It may well also
    introduce some bugs and regressions in other areas, including
    basic paragraph handling, handling of "mixed block" content,
    handling of other indented content, and handling of authorblurb
    and personblurb in the AUTHORS section.

Params

The following changes have been made to the params code since the 1.71.0
release.

  * Added support for profiling based on xml:lang and status attributes.

  * Added the html.append and chunk.append parameters. By default, the
    value of both is empty; but the internal DocBook XSL stylesheets
    build sets their value to "<xsl:text>&#x0a;</xsl:text>", in order
    to ensure that all files in the docbook-xsl-doc package end in a
    newline character. (Because diff and some other tools may emit
    error messages and/or not behave as expected when processing
    files that are not newline-terminated.)

Profiling

The following changes have been made to the profiling code since the 1.71.0
release.

  * Added support for profiling based on xml:lang and status attributes.

Release: 1.71.0

This is mainly a bug fix release, but it also includes two significant feature
changes:

Highlighting support added

    The stylesheets now include support for source-code highlighting in output
    of programlisting instances (controlled through the highlight.source
    parameter). The Java-based implementation requires Saxon and makes use of
    Michal Molhanecs XSLTHL. More details are available at Jirka Koseks
    website:

        http://xmlguru.cz/2006/07/docbook-syntax-highlighting

    The support is currently limited to highlighting of XML, Java, PHP,
    Delphi, Modula-2 sources, and INI files.

Changes to autoindexing

    The templates that handle alternative indexing methods were reworked to
    avoid errors produced by certain processors not being able to tolerate the
    presence of unused functions. With this release, none of the code for the
    'kimber' or 'kosek' methods is included in the default stylesheets. In
    order to use one of those methods, your customization layer must import
    one of the optional stylesheet modules:

      * html/autoidx-kosek.xsl
      * html/autoidx-kimber.xsl
      * fo/autoidx-kosek.xsl
      * fo/autoidx-kimber.xsl

    See the index.method parameter reference page for more information.

    Two other changes to note:

      * The default indexing method now can handle accented characters in
        latin-based alphabets, not just English. This means accented latin
        letters will group and sort with their unaccented counterpart.
      * The default value for the index.method parameter was changed from
        'english' to 'basic' because now the default method can handle
        latin-based alphabets, not just English.

The following is a list of changes that have been made since the 1.70.1
release.

Common

The following changes have been made to the common code since the 1.70.1
release.

  * Added reference.autolabel parameter for controlling labels on
    reference output.

  * Support rows that are *completely* overlapped by the preceding row

  * New modules for supporting indexing extensions.

  * Support startinglinenumber on orderedlist

Extensions

The following changes have been made to the extensions code since the 1.70.1
release.

  * Completely reworked extensions build system; now uses NetBeans and ant

FO

The following changes have been made to the fo code since the 1.70.1 release.

  * xsl:sort lang attribute now uses two-char substring of lang attribute.

  * Support titlecase "Java", "Perl", and "IDL" as values for the
    language attribute on classsynopsis, etc. (instead of just
    lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
    (instead of just "cpp").

    Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
    to "Brian A. Vanderburg II".

  * Added support for the reference.autolabel param in (X)HTML and FO
    output.

  * Support rows that are *completely* overlapped by the preceding row

  * Rearranged templates for the 3 indexing methods
    and changed method named 'english' to 'basic'.

  * New modules for supporting indexing extensions.

  * Turn off blank-body for fop1.extensions too since fop 0.92
    does not support it either.

  * Add Xalan variant to test for exslt:node-set function.
    Xalan can use function named node-set(), but doesn't
    recognize it using function-available().

  * Added support to FO stylesheets for handling instances of Org
    where it occurs outside of *info content. In HTML stylesheets,
    moved handling of Org out of info.xsl and into inline.xsl. In both
    FO and HTML stylesheets, added support for correctly processing
    Affiliation and Jobtitle.

  * Don't output punctuation between Refname and Refpurpose if
    Refpurpose is empty. Also corrected handling of Refsect2/title
    instances, and removed some debugging stuff that was generated in
    manpages output to mark the ends of sections.

  * Added new email.delimiters.enabled param. If non-zero (the
    default), delimiters are generated around e-mail addresses (output
    of the email element). If zero, the delimiters are suppressed.

  * Initial support of syntax highlighting of programlistings.

  * Chapter after preface should restart numbering of pages.

HTML

The following changes have been made to the html code since the 1.70.1
release.

  * xsl:sort lang attribute now uses two-char substring of lang attribute.

  * Support titlecase "Java", "Perl", and "IDL" as values for the
    language attribute on classsynopsis, etc. (instead of just
    lowercase "java", "perl", and "idl"). Also support "c++" and "C++"
    (instead of just "cpp").

    Affects HTML, FO, and manpages output. Closes bug 1552332. Thanks
    to "Brian A. Vanderburg II".

  * Added support for the reference.autolabel param in (X)HTML and FO
    output.

  * Support rows that are *completely* overlapped by the preceding row

  * Rearranged templates for the 3 indexing methods
    and changed method named 'english' to 'basic'.

  * New modules for supporting indexing extensions.

  * Added several new HTML parameters for controlling appearance of
    content on HTML title pages:

    contrib.inline.enabled:
      If non-zero (the default), output of the contrib element is
      displayed as inline content rather than as block content.

    othercredit.like.author.enabled:
      If non-zero, output of the othercredit element on titlepages is
      displayed in the same style as author and editor output. If zero
      (the default), othercredit output is displayed using a style
      different than that of author and editor.

    blurb.on.titlepage.enabled:
      If non-zero, output from authorblurb and personblurb elements is
      displayed on title pages. If zero (the default), output from
      those elements is suppressed on title pages (unless you are
      using a titlepage customization that causes them to be included).

    editedby.enabled
      If non-zero (the default), a localized Edited by heading is
      displayed above editor names in output of the editor element.

  * Add Xalan variant to test for exslt:node-set function.
    Xalan can use function named node-set(), but doesn't
    recognize it using function-available().

  * Added support to FO stylesheets for handling instances of Org
    where it occurs outside of *info content. In HTML stylesheets,
    moved handling of Org out of info.xsl and into inline.xsl. In both
    FO and HTML stylesheets, added support for correctly processing
    Affiliation and Jobtitle.

  * Don't output punctuation between Refname and Refpurpose if
    Refpurpose is empty. Also corrected handling of Refsect2/title
    instances, and removed some debugging stuff that was generated in
    manpages output to mark the ends of sections.

  * Added new email.delimiters.enabled param. If non-zero (the
    default), delimiters are generated around e-mail addresses (output
    of the email element). If zero, the delimiters are suppressed.

  * Added qanda.nested.in.toc param. Default value is zero. If
    non-zero, instances of "nested" Qandaentry (ones that are children
    of Answer elements) are displayed in the TOC. Closes patch 1509018
    (from Daniel Leidert). Currently on affects HTML output (no patch
    for FO output provided).

  * Improved handling of relative locations generated files

  * Initial support of syntax highlighting of programlistings.

  * Support org

  * Support person

  * Support $keep.relative.image.uris also when chunking

Highlighting

The following changes have been made to the highlighting code since the 1.70.1
release.

  * Initial support of syntax highlighting of programlistings.

Manpages

The following changes have been made to the manpages code since the 1.70.1
release.

  * Suppress footnote markers and output warning that footnotes are
    not yet supported.

  * Handle instances of address/otheraddr/ulink in author et al in the
    same way as email instances; that is, display them on the same
    linke as the author, editor, etc., name.

  * Don't number or link-list any Ulink instance whose string value is
    identical to the value of its url attribute. Just display it inline.

  * Don't output punctuation between Refname and Refpurpose if
    Refpurpose is empty. Also corrected handling of Refsect2/title
    instances, and removed some debugging stuff that was generated in
    manpages output to mark the ends of sections.

  * Added new email.delimiters.enabled param. If non-zero (the
    default), delimiters are generated around e-mail addresses (output
    of the email element). If zero, the delimiters are suppressed.

  * In manpages output, if the last/nearest *info element for
    particular Refentry has multiple Copyright and/or Legalnotice
    children, process them all (not just the first ones). Closes bug
    1524576. Thanks to Sam Steingold for the report and to Daniel
    Leidert for providing a patch.

Params

The following changes have been made to the params code since the 1.70.1
release.

  * Added reference.autolabel parameter for controlling labels on
    reference output.

  * Added namespace declarations to document elements for all param files.

  * Updated index.method doc to describe revised setup for importing index
     extensions.

  * Added several new HTML parameters for controlling appearance of
    content on HTML title pages:

    contrib.inline.enabled:
      If non-zero (the default), output of the contrib element is
      displayed as inline content rather than as block content.

    othercredit.like.author.enabled:
      If non-zero, output of the othercredit element on titlepages is
      displayed in the same style as author and editor output. If zero
      (the default), othercredit output is displayed using a style
      different than that of author and editor.

    blurb.on.titlepage.enabled:
      If non-zero, output from authorblurb and personblurb elements is
      displayed on title pages. If zero (the default), output from
      those elements is suppressed on title pages (unless you are
      using a titlepage customization that causes them to be included).

    editedby.enabled
      If non-zero (the default), a localized Edited by heading is
      displayed above editor names in output of the editor element.

  * Added new email.delimiters.enabled param. If non-zero (the
    default), delimiters are generated around e-mail addresses (output
    of the email element). If zero, the delimiters are suppressed.

  * Added qanda.nested.in.toc param. Default value is zero. If
    non-zero, instances of "nested" Qandaentry (ones that are children
    of Answer elements) are displayed in the TOC. Closes patch 1509018
    (from Daniel Leidert). Currently on affects HTML output (no patch
    for FO output provided).

  * Initial support of syntax highlighting of programlistings.

Tools

The following changes have been made to the tools code since the 1.70.1
release.

  * Racheted down font sizes of headings in example makefile FO output.

  * Added param and attribute set to example makefile, for getting
    wrapping in verbatims in FO output.

  * Renamed Makefile.paramDoc to Makefile.docParam.

  * Added Makefile.paramDoc file, for creating versions of param.xsl
    files with doc embedded.

  * Added variable to example makefile for controlling whether HTML or
    XHTML is generated.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]