"Eric S. Raymond" <[EMAIL PROTECTED]>, 2007-01-03 07:17 -0500:
> Michael(tm) Smith <[EMAIL PROTECTED]>: > > That was true prior to DocBook 4.3, but it's not true currently > > (neither in DocBook 4 nor DocBook 5). > > Oh, good. I shall add support for this immediately and get rid of a large > number of warnings and fix patches. Thanks for the heads-up, No problem. I think the previous content model was just trying to be too prescriptive. I can imagine some good use-cases for marking up names/descriptions for multiple utilities in one man page. The ImageMagick man page, for example. A lot of people know the name ImageMagick, but they don't necessarily know the names of the individual tools that are part of it, or what to use them for. The current ImageMagick man page has those names/descriptions buried halfway through the page. I think properly they ought to be listed at the top, where users would normally expect to see them. > > The current version of DocBook 4 is 4.5. And the version that should > > be available as a package for most distros is 4.4 (which was > > released 2 years ago) or at least 4.3 (released in 2004). > > Hmmm... > > [EMAIL PROTECTED]:~/WWW/doclifter$ rpm -qi docbook-style-xsl > Name : docbook-style-xsl Relocations: (not relocatable) > Version : 1.69.1 Vendor: Red Hat, Inc. > Release : 5.1 Build Date: Wed 12 Jul 2006 > 03:55:02 AM EDT [...] > Looks like Fedora Core 6 carriers version 5.1. I suspect that is just some release number that Fedora assigns. It's certainly not any version number that came from us upstream. And anyway, all that info appears just to be for the docbook-style-xsl package. I think you need to check for docbook-xml or docbook-dtd or some package name like that. The stylesheets and DTD are versioned and packaged separately. Or maybe look in /usr/share/xml/docbook/schema/dtd/ or /usr/share/sgml/docbook/schema/dtd/ and see what's there. I think one or the other of those is supposed to be the standard (LSB) location where the DTDs are supposed to go. > I've looked for, but not found, some analog of a changelog for the > DocBook DTD. Do you know where I could find such a thing? If you want the absolute latest, it's here: http://docbook.xml-doc.org/snapshots/xsl/RELEASE-NOTES.html http://docbook.xml-doc.org/snapshots/xsl/RELEASE-NOTES.txt I have a snapshot build that runs every time any time any new code change is committed to the project repository, and the above get auto-generated by the build. The first part of those documents list /all/ changes that have been committed since the last official release (including bug fixes). The remainder of them is per-release listing of just enhancements and API changes (sans the bug fixes), going back for several years's worth of releases. The document is broken down by output format; for example: http://docbook.xml-doc.org/snapshots/xsl/RELEASE-NOTES.html#V1.71.0_Manpages That has all of the manpages changes for the 1.71.0 release. If you want just the changes up through the latest official release, they're here: http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.txt http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.html http://docbook.sourceforge.net/release/xsl/current/RELEASE-NOTES.pdf And if you care to look at the whole raw Changlog going all the way back to when the repository was created, it's here: http://docbook.xml-doc.org/snapshots/xsl/ChangeHistory.xml.zip The home page for the DocBook project has links to some of that stuff. It's here: http://docbook.sourceforge.net/ If that's missing something you think it should have, let me know and I will add it. --Mike -- Michael(tm) Smith http://www.w3.org/People/Smith/ _______________________________________________ Groff mailing list Groff@gnu.org http://lists.gnu.org/mailman/listinfo/groff
