groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Groff] Multiple description lines in DocBook


From: Michael(tm) Smith
Subject: Re: [Groff] Multiple description lines in DocBook
Date: Thu, 4 Jan 2007 02:04:20 +0900
User-agent: Mutt/1.5.13 (2006-08-11)

"Eric S. Raymond" <address@hidden>, 2007-01-03 07:17 -0500:

> Michael(tm) Smith <address@hidden>:
> > 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...
> 
> address@hidden:~/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/




reply via email to

[Prev in Thread] Current Thread [Next in Thread]