Re: [docbook] Best way to add DocBook 4.5 to my catalog on Ubuntu

[Daniel Leidert <daniel.leidert.spam@gmx.net>]

This should probably go to docbook-apps (or even docbook-packagers) - or
better on a Debian or Ubuntu list.

Am Mittwoch, den 03.10.2007, 11:35 +0100 schrieb Andrew McFarland:

> I'm using Ubunty Fiesty Fawn. When I run apt-get install docbook-xml,
> the latest version of DocBook it installs is 4.4. I need to add 4.5 to
> my catalog.
> 
> Where is the best place to add it? Initially I added the 4.5 files
> using a delegatePublic in /etc/xml/catalog:
> 
> sudo xmlcatalog --noout --add delegatePublic "-//OASIS//DTD DocBook
> XML V4.5" "file:///usr/share/xml/docbook/schema/dtd/4.5/catalog.xml"
> /etc/xml/catalog

Read update-xmlcatalog(8). Every change you make using xmlcatalog will
be overwritten the next time, the system catalog is recreated - this
means, every time, a package installs a catalog, you will loose this
entry again.

> This seemed to work.
> 
> But I was looking at /etc/xml/catalog, and I saw that all the other
> DocBook files were referenced like this:
> 
> <delegatePublic publicIdStartString="-//OASIS//DTD DocBook XML"
> catalog="file:///etc/xml/docbook-xml.xml"/>

This is the standard system on Debian:
http://debian-xml-sgml.alioth.debian.org/xml-policy/

> So it would seem to make more sense to put the 4.5 references in
> docbook-xml.xml.
> 
> But when I looked at that file and there were several references to
> the 4.4 catalog file.
> 
> Which is the correct/best place to add the references to the 4.5
> catalog file? If I should be adding it to docbook-xml.xml, how do I do
> this? Simply copy every 4.4 line and update it as appropriate?

If you are really interested in the way it works, take the package from
Debian or Ubuntu Feisty and look at the postinst script
in /var/lib/dpkg/info.

> And finally, I have to work with several DocBook 4.5 documents that
> have the wrong public ID - "-//OASIS//DTD DocBook V4.5//EN" instead of
> "-//OASIS//DTD DocBook XML V4.5//EN".

Why makes you think, they are wrong? These are the SGML system IDs of
DocBook 4.5. Installing the docbook Debian package version 4.5 would
register these IDs in the SGML catalog.

> I  know I can fix this by using
> a rewriteSystem in my catalog, but which is the best file to put this
> into - /etc/xml/catalog, /etc/xml/docbook-xml.xml, or somewhere else?

You would have to use the same tool: update-xmlcatalog. But you better
create an entry for a fake package, so you don't need to care about it,
when the docbook-xml package is updated.

Regards, Daniel