Errors in the Man-XML and Texi-XML DTD were fixed.

These DTDs are now used to validate the output coming out of the stylesheets, as part of automated testing. (Validation provides some assurance that the result of the conversions are correct.)

Several rendering errors were fixed after they had been discovered through automated testing.

Two HTML files in the docbook2X documentation were accidentally omitted in the last release. They have been added.

The pure-XSLT-based man-page conversion now supports table markup. The implemented was copied from the one by Michael Smith in the DocBook XSL stylesheets. Many thanks!

As requested by Daniel Leidert, the man-pages stylesheets now support the segmentedlist, segtitle and seg DocBook elements.

As suggested by Matthias Kievermagel, docbook2X now supports the code element.

Some stylistic improvements were made to the man-pages output.

This includes fixing a bug that, in some cases, caused an extra blank line to occur after lists in man pages.

There is a new value utf-8//TRANSLIT for the --encoding option to db2x_manxml and db2x_texixml.

Added -m to utf8trans for modifying (a large number of) files in-place.

Added a section to the documentation discussing conversion performance.

There is also a new test script, test/mass/test.pl that can exercise docbook2X by converting many documents at one time, with a focus on achieving the fastest conversion speed.

The documentation has also been improved in several places. Most notably, the docbook2X man page has been split into two much more detailed man pages explaining man-page conversion and Texinfo conversion separately, along with a reference of stylesheet parameters.

The documentation has also been re-indexed (finally!)

Also, due to an oversight, the last release omitted the stylesheet reference documentation. They are now included again.

Craig Ruff’s patches were not integrated correctly in the last release; this has been fixed.

By popular demand, man-page conversion can also be done with XSLT alone — i.e. no Perl scripts or compiling required, just a XSLT processor.

If you want to convert with pure XSLT, invoke the XSLT stylesheet in xslt/backend/db2x_manxml.xsl in lieu of the db2x_manxml Perl script.

Make the xmlcharmap2utf8trans script (convert XSLT 2.0 character maps to character maps in utf8trans format) really work.

Added rudimentary support for entrytbl in man pages; patch by Craig Ruff.

Added template for personname; patch by Aaron Hawley.

Fix a build problem that happened on IRIX; patch by Dirk Tilger.

Better rendering of man pages in general. Fixed an incompatibility with Solaris troff of some generated man pages.

Fixed some minor bugs in the Perl wrapper scripts.

There were some fixes to the Man-XML and Texi-XML document types. Some of these changes are backwards-incompatible with previous docbook2X releases. In particular, Man-XML and Texi-XML now have their own XML namespaces, so if you were using custom XSLT stylesheets you will need to add the appropriate namespace declarations.

Fixed a bug, from version 0.8.4, with the generated Texinfo files not setting the Info directory information correctly. (This is exactly the patch that was on the docbook2X Web site.)

Fixed a problem with db2x_manxml not calling utf8trans properly.

Added heavy-duty testing to the docbook2X distribution.

There is now an experimental implementation of db2x_manxml and db2x_texixml using pure XSLT, for those who can’t use the Perl one for whatever reason. See the xslt/backend/ directory. Do not expect this to work completely yet. In particular, tables are not yet available in man pages. (They are, of course, still available in the Perl implementation.)

Texinfo conversion does not require XSLT extensions anymore! See Design notes: the elimination of XSLT extensions for the full story.

As a consequence, db2x_xsltproc has been rewritten to be a Perl wrapper script around the stock xsltproc.

The -S option to db2x_xsltproc no longer uses libxml’s hackish “SGML DocBook” parser, but now calls sgml2xml. The corresponding long option has been renamed to --sgml from --sgml-docbook.

Fixed a heap of bugs — that caused invalid output — in the XSLT stylesheets, db2x_manxml and db2x_texixml.

Some features such as cmdsynopsis and funcsynopsis are rendered more nicely.

Man-XML and Texi-XML now have DTDs — these are useful when writing and debugging stylesheets.

Added a --plaintext option to db2x_texixml.

Updates to the docbook2X manual. Stylesheet documentation is in.

Incorporated Michael Smith’s much-expanded roff character maps.

There are some improvements to the stylesheets themselves, here and there.

Also I made the Texinfo stylesheets adapt to the XSLT processor automatically (with regards to the XSLT extensions). This might be of interest to anybody wanting to use the stylesheets with some other XSLT processor (especially SAXON).

Fixed a couple of bugs that prevented docbook2X from working on Cygwin.

Fixed a programming error in utf8trans that caused it to segfault. At the same time, I rewrote parts of it to make it more efficient for large character maps (those with more than a thousand entries).

The Perl component of docbook2X has switched from using libxml-perl (a SAX1 interface) to XML-SAX (a SAX2 interface). I had always wanted to do the switch since libxml-perl is not maintained, but the real impetus this time is that XML-SAX has a pure Perl XML parser. If you have difficulties building XML::Parser on Cygwin, like I did, the Perl component will automatically fall back on the pure Perl parser.

Added support for tables in man pages. Almost all table features that can be supported with tbl will work. The rest will be fixed in a subsequent release.

Copied the “gentext” stuff over from Norman Walsh’s XSL stylesheets. This gives (incomplete) localizations for the same languages that are supported by the Norman Walsh’s XSL stylesheets.

Although incomplete, they should be sufficient for localized man-page output, for which there are only a few strings like “Name” and “Synopsis” that need to be translated.

If you do make non-English man pages, you will need to revise the localization files; please send patches to fix them afterwards.

Rendering of bibliography, and other less common DocBook elements is broken. Actually, it was probably also slightly broken before. Some time will be needed to go through the stylesheets to check/document everything in it and to add anything that is still missing.

Added --info option to db2x_texixml, to save typing the makeinfo command.

Rename --stringparam option in db2x_xsltproc to --string-param, though the former option name is still accepted for compatibility.

Added the stylesheet for generating the XSLT reference documentation. But the reference documentation is not integrated into the main docbook2X documentation yet.

docbook2X no longer uses SGML-based tools to build. HTML documentation is now built with the DocBook XSL stylesheets.

Changed the license of this package to the MIT license. This is in case someone wants to copy snippets of the XSLT stylesheets, and requiring the resulting stylesheet to be GPL seems too onerous. Actually there is no real loss since no one wants to hide XSLT source anyway.

Switched to a newer version of autoconf.

Fixes for portability (to non-Linux OSes).

A number of small rendering bug fixes, as usual.

Bug fixes.

Texinfo menu generation has been improved: the menus now look almost as good as human-authored Texinfo pages and include detailed node listings (@detailmenu) also.

Added option to process XInclude in db2x_xsltproc just like standard xsltproc.

Moved docbook2man-spec.pl to a sister package, docbook2man-sgmlspl, since it seems to be used quite a lot.

There are now XSLT stylesheets for man page conversion, superceding the docbook2manxml. docbook2manxml had some neat code in it, but I fear maintaining two man-page converters will take too much time in the future, so I am dropping it now instead of later.

Fixed build errors involving libxslt headers, etc. that plagued the last release. The libxslt wrapper (name changed to db2x_xsltproc, formerly called docbook2texi-libxslt) has been updated for the recent libxslt changes. Catalog support working.

Transcoding output to non-UTF-8 charsets is automatic.

Made some wrapper scripts for the two-step conversion process.

More bug squashing and features in XSLT stylesheets and Perl scripts. Too many to list.

Added docbook2texi-libxslt, which uses libxslt. Finally, no more Java is necessary.

Added a C-based tool to translate UTF-8 characters to arbitrary (byte) sequences, to avoid having to patch a i0000755000000000000000000000000011060450075016113 5ustar rootroot./usr/share/doc/docbook2x/docbook2X/changes.html0000644000000000000000000005223211060450075020415 0ustar rootroot