Best way to add DocBook 4.5 to my catalog on Ubuntu

Hi,

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.x
ml"
/etc/xml/catalog

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"/>

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?

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". 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?

Andrew
-- 
We can't change the past, but each of us, by challenging
prejudice and
intolerance, can help to change the future.
- Rabbi Jonathan Sacks, Address at Holocaust Memorial Day,
Westminster
Hall, bond, 27th January 2005

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-helplists.oasis-open.org

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.x
ml"
> /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


------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-helplists.oasis-open.org

Hi,

Thanks for the information. I'm glad I decided to ask before
I started
messing around with things  I'll read
update-xmlcatalog(8) and ask
around the Debian/Ubuntu lists if I need any more help.

On 03/10/2007, Daniel Leidert <daniel.leidert.spamgmx.net> wrote:

<snip/>
> Why makes you think, they are wrong? These are the SGML
system IDs of
> DocBook 4.5.

The corresponding system ID points to the XML DTDs, and the
documents
themselves use XML empty element syntax, so it is the XML
version of
DocBook 4.5 that the author intended to use.

Andrew
-- 
We can't change the past, but each of us, by challenging
prejudice and
intolerance, can help to change the future.
- Rabbi Jonathan Sacks, Address at Holocaust Memorial Day,
Westminster
Hall, bond, 27th January 2005

------------------------------------------------------------
---------
To unsubscribe, e-mail: docbook-unsubscribelists.oasis-open.org
For additional commands, e-mail: docbook-helplists.oasis-open.org