I got this from postgresql-docs while emerge was trying to upgrade world: openjade -wall -wno-unused-param -wno-empty -wfully-tagged -D . -D . -c /usr/share/sgml/stylesheets/dsssl/docbook/catalog -d stylesheet.dsl -t sgml -i output-html -V html-index postgres.sgml openjade:postgres.sgml:3:55:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V4.2//EN" openjade:postgres.sgml:12:0:E: reference to entity "BOOK" for which no system identifier could be generated openjade:postgres.sgml:3:0: entity was defined here openjade:postgres.sgml:12:0:E: DTD did not contain element declaration for document type name openjade:postgres.sgml:14:9:E: there is no attribute "ID" openjade:postgres.sgml:14:19:E: element "BOOK" undefined openjade:postgres.sgml:15:7:E: element "TITLE" undefined and it goes on with that sort of error for all of the elements in the sgml. I tried re-installing app-text/docbook-xml-dtd:4.2 and that allowed the pg docs ebuild to complete. It seems that the only slot of app-text/docbook-xml-dtd which works is the one most recently installed.
There is currently only one ebuild for docbook-sgml-dtd:4.2 available, and you said that it works ok? It sounds like once upon a time there was a bad revision of docbook-sgml-dtd:4.2, but it is not in the tree anymore... Possibly I'm confused, but it seems like this bug already got fixed before you reported it. If that's not the case, please point out what I have overlooked or misunderstood :)
Let me try again. After I first installed the 4.2 slot of docbook-xml-dtd, it worked. Once I installed another slot of docbook-xml-dtd, the 4.2 slot stopped working. Re-installing the 4.2 slot made it work again. The report, then, is that installing any given slot of docbook-xml-dtd, seems to break any other, already installed slot. My /etc/sgml/catalog file does, currently, have entries for all of the .cat files in /etc/sgml, and the entries are absolute. One would expect them to work. But they only point at other catalog files, which in turn reference the actual files of interest, such as the dtd files, et al. Somehow, installing another slot must have broken the referencing, preventing the app from locating either /usr/share/sgml/docbook/sgml-dtd-4.2/docbook.dtd or /usr/share/sgml/docbook/sgml-dtd-4.2/docbookx.dtd (loaded by the first).
Thanks for the clear explanation, I get it now. Please post your 'emerge --info', and then we'll assign this bug to docbook maintainers.
reminder -- 'emerge --info'?
Created attachment 238631 [details] emerge --info Here is the emerge-info.
archtester docbook-xml-dtd # ls /usr/share/sgml/docbook/xml-dtd-4.2/ calstblx.dtd dbcentx.mod dbgenent.mod dbhierx.mod dbnotnx.mod dbpoolx.mod docbook.cat docbookx.dtd ent soextblx.dtd archtester docbook-xml-dtd # ls /usr/share/sgml/docbook/xml-dtd-4.4/ calstblx.dtd dbcentx.mod dbhierx.mod dbpoolx.mod docbookx.dtd htmltblx.mod catalog.xml dbgenent.mod dbnotnx.mod docbook.cat ent soextblx.dtd archtester docbook-xml-dtd # find /usr/share/sgml/docbook/ -name docbook.dtd archtester docbook-xml-dtd # Possible cause?? or James is wrong citing it. The installed files in /etc/sgml archtester docbook-xml-dtd # ls /etc/sgml/ catalog sgml.conf sgml-docbook-4.0.cat sgml-docbook.cat xhtml1.cat xml-docbook-4.3.cat openjade-1.3.2.cat sgml-docbook-3.0.cat sgml-docbook-4.1.cat sgml-ent.cat xml-docbook-4.1.2.cat xml-docbook-4.4.cat sgml.cenv sgml-docbook-3.1.cat sgml-docbook-4.5.cat sgml.env xml-docbook-4.2.cat xml-docbook-4.5.cat perhaps need to cite the ${PV} where they don't.
Yeah... what version of postgresql-docs was this? Recent versions appear to install pre-generated html files.
> what version of postgresql-docs was this? > Recent versions appear to install pre-generated html files. The 2010-06-22 version? ☺ Even if pgsql doesn’t trip it any more, the bug (that installing one version of the docbook xml dtd prevents other, already installed version from continuing to work) still may be relevant. I don’t have a test case, though, other than the then-current version of pgsql docs.
(In reply to comment #8) Hmm... it looks like the postgresql 9.0 pre-release versions (beta/rc) had ebuilds that generated docs from the docbook sources. I'll try pulling a copy from the Attic. http://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/dev-db/postgresql-docs/?hideattic=0
I was not able to reproduce the problem.