ports/66246: new ports: textproc/docbook-utils, textproc/p5-SGMLSpm

[Brian Candler]

On Thu, Sep 01, 2005 at 07:53:36AM +0000, Sam Lawrance wrote:
> Are you still interested in adding these ports to the ports collection?  If so, could you please:
> - make sure that the shar you originally sent is up to date
> - set the port MAINTAINER is set to your email address (if not already done)
> - test the port to see that it still works correctly

Yes, I'm still interested (building the courier suite from CVS still needs
docbook2html and docbook2man). Thanks for picking up this PR!

I have re-tested the port, made a minor tweak and re-uploaded to
http://www.linnet.org/ports/docbook-utils.tgz
The p5-SGMLS port didn't need any updating (feel free to set the MAINTAINER)

However, perhaps someone who understands the SGML/XML catalog system better
than me can help me. There is a conflict when building the docbook-utils port
if "docbook-sk" is installed (e.g. required by scrollkeeper which in turn is
required by libgnome). I had to pkg_delete -f docbook-sk\* for the port to
build. (This is just a build-time problem, and the package seems to work
correctly if used subsequently even if docbook-sk is reinstalled, so I
don't think this warrants a CONFLICTS entry)

If docbook-sk remains installed, the error you get is:

gmake[2]: Entering directory `/v/ports/textproc/docbook-utils/work/docbook-utils-0.6.14/doc/HTML'
SGML_CATALOG_FILES=/usr/local/share/sgml/catalog \
SGML_SEARCH_PATH=../..:../../doc:.. \
        jade -t sgml -i html -d ../../docbook-utils.dsl\#html \
                -V '%use-id-as-filename%' ../../doc/docbook-utils.sgml
jade:/usr/local/share/xml/docbook/4.1.2/ent/iso-amsa.ent:8:19:E: "X21B6" is not a function name
jade:/usr/local/share/xml/docbook/4.1.2/ent/iso-amsa.ent:9:19:E: "X21B7" is not a function name
... lots more of these

but I can't see why these (XML) entity definitions are being included when
building an SGML document.

The file causing the problem *does* exist in the catalog:

$ cd /usr/local/share/sgml
$ cat catalog
-- Created by XML Catalog Manager 2.2 --
CATALOG "catalog.ports"

[brian at billdog sgml]$ cat catalog.ports
-- Created by xmlcatmgr-2.1 --
CATALOG "/usr/local/share/xml/docbook/4.1.2/docbook.cat"    # <<<<< HERE

CATALOG "/usr/local/share/xml/docbook/4.2/docbook.cat"

CATALOG "/usr/local/share/xml/sdocbook/4.1.2.5/catalog"

CATALOG "/usr/local/share/xml/dtd/xhtml/xhtml-dcl.soc"

CATALOG "iso8879/catalog"

CATALOG "html/catalog"

CATALOG "docbook/4.1/catalog"

CATALOG "docbook/dsssl/modular/catalog"

CATALOG "jade/catalog"

CATALOG "docbook/3.1/catalog"

$ grep iso-amsa /usr/local/share/xml/docbook/4.1.2/docbook.cat
PUBLIC "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN" "ent/iso-amsa.ent"

but I'm at a loss to see why it's being used, especially since the
particular document being built uses the V3.1 DocBook definition:

# grep DOCTYPE work/docbook-utils-0.6.14/doc/docbook-utils.sgml 
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

Any clues gratefully received.

Thanks,

Brian Candler.