docbook-apps

  • 1.  docbook v4.1.2 missing "catalog.xml". broken?

    Posted 12-22-2008 16:54
    i've DL'd (from http://www.docbook.org/xml) xml catalogs on OSX,

    cd /usr/local/share/docbook/xml
    ls -al
    drwxr-xr-x 16 root wheel 544 2008-12-21 15:46 4.1.2/
    drwxr-xr-x 15 root wheel 510 2008-12-21 15:46 4.2/
    drwxr-xr-x 16 root wheel 544 2008-12-21 15:46 4.3/
    drwxr-xr-x 16 root wheel 544 2008-12-21 15:46 4.4/
    drwxr-xr-x 16 root wheel 544 2008-12-21 15:46 4.5/

    and created a catalog file,

    cat /usr/local/etc/xml/catalog

    Catalog V1.0//EN"
    "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
    <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
    <nextCatalog catalog="file:///usr/local/share/docbook/xml/4.5/catalog.xml"/>
    <nextCatalog catalog="file:///usr/local/share/docbook/xml/4.4/catalog.xml"/>
    <nextCatalog catalog="file:///usr/local/share/docbook/xml/4.3/catalog.xml"/>
    <nextCatalog catalog="file:///usr/local/share/docbook/xml/4.2/catalog.xml"/>
    <nextCatalog
    catalog="file:///usr/local/share/docbook/xml/4.1.2/catalog.xml"/>
    <nextCatalog
    catalog="file:///usr/local/share/docbook/xsl/1.74.0/catalog.xml"/>
    <rewriteURI
    uriStartString="http://docbook.sourceforge.net/release/xsl/current/"
    rewritePrefix="file:///usr/local/share/docbook/xsl/1.74.0"/>
    </catalog>

    validating, v4.5 works ok,

    xmlcatalog -v /usr/local/etc/xml/catalog \
    "-//OASIS//DTD DocBook XML V4.5//EN" \
    http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd

    file:///usr/local/share/docbook/xml/4.5/catalog.xml added to file hash
    Found public match -//OASIS//DTD DocBook XML V4.5//EN
    file:///usr/local/share/docbook/xml/4.5/docbookx.dtd
    Resolve sysID http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
    Found system match
    http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd, using
    file:///usr/local/share/docbook/xml/4.5/docbookx.dtd
    file:///usr/local/share/docbook/xml/4.5/docbookx.dtd
    Catalogs cleanup

    v4.4, v4.3 & v4.2 are also ok.

    but not 4.1.2,

    xmlcatalog -v /usr/local/etc/xml/catalog \
    "-//OASIS//DTD DocBook XML V4.1.2//EN" \
    http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd

    No entry for PUBLIC -//OASIS//DTD DocBook XML V4.1.2//EN
    Resolve sysID http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
    No entry for SYSTEM http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
    Resolve URI http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
    No entry for URI http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd
    Catalogs cleanup

    checking, I find that 'catalog.xml' is missing from the 4.1.2 DL ...

    cd /usr/local/share/docbook/xml
    ls -al */catalog.xml
    -rw-r--r-- 1 root wheel 4535 2002-07-17 09:14 4.2/catalog.xml
    -rw-r--r-- 1 root wheel 4535 2004-03-31 03:22 4.3/catalog.xml
    -rw-r--r-- 1 root wheel 4805 2005-01-27 05:57 4.4/catalog.xml
    -rw-r--r-- 1 root wheel 4805 2006-10-03 06:26 4.5/catalog.xml
    ls -al 4.1.2
    -rw-rw-r-- 1 root wheel 2409 2000-08-27 08:19 40chg.txt
    -rw-rw-r-- 1 root wheel 603 2000-08-27 08:19 41chg.txt
    -rw-rw-r-- 1 root wheel 3936 2000-08-27 08:19 ChangeLog
    -rwxrw-r-- 1 root wheel 8352 2000-08-27 08:19 calstblx.dtd
    -rwxrw-r-- 1 root wheel 6268 2000-08-27 08:19 dbcentx.mod
    -rw-rw-r-- 1 root wheel 1605 2000-08-27 08:19 dbgenent.mod
    -rwxrw-r-- 1 root wheel 59188 2000-08-27 08:19 dbhierx.mod
    -rwxrw-r-- 1 root wheel 4316 2000-08-27 08:19 dbnotnx.mod
    -rwxrw-r-- 1 root wheel 203338 2000-08-27 08:19 dbpoolx.mod
    -rw-rw-r-- 1 root wheel 3681 2000-08-27 08:19 docbook.cat
    -rwxrw-r-- 1 root wheel 4658 2000-08-27 08:19 docbookx.dtd
    drwxrwxr-x 21 root wheel 714 2000-08-27 08:19 ent/
    -rw-rw-r-- 1 root wheel 448 2000-08-27 08:19 readme.txt
    -rw-rw-r-- 1 root wheel 12587 2000-08-27 08:19 soextblx.dtd

    which, i believe, explains the failure ...

    for 'just' docbook usage, i understand that I caould simply switch to
    one of the catalogs that validate correctly ... but, in building
    "glib-2.19.2 --enable-gtk-doc ...", it specifically checks (and fails)
    for v4.1.2,

    ...
    dnl check for DocBook DTD and stylesheets in the local catalog.
    JH_CHECK_XML_CATALOG([-//OASIS//DTD DocBook XML V4.1.2//EN],
    [DocBook XML DTD V4.1.2],,enable_man=no)
    JH_CHECK_XML_CATALOG([http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl],
    [DocBook XSL Stylesheets],,enable_man=no)
    fi
    ...

    Checking with the glib 'folks', that version dependency can't be
    changed -- and the claim is that the docbook DL's 'packaging' for
    v4.1.2 is broken.

    can this be fixed in the online source ? or, is ther something else wrong here?

    Thanks.



  • 2.  Re: docbook v4.1.2 missing "catalog.xml". broken?

    Posted 12-22-2008 21:33
    a bit more info ...

    it seems that a developer @ the macports project addressed this,
    providing a patch file,

    http://trac.macports.org/browser/trunk/dports/textproc/docbook-xml-4.1.2/files/catalog.xml

    which, cp'd into my local v4.1.2 dir, enables xmlcatalog validation to
    pass (i'm re-attempting a glib build atm ...).

    the developer had, apparently, communicated with upstream about this issue,

    http://lists.macosforge.org/pipermail/macports-users/2007-June/003703.html

    but afaict, there was no response. and, clearly, there's been no
    catalog.xml added to the 4.1.2 dtd online.