up vote 4 down vote favorite
share [g+] share [fb]

I'm trying to build documentation for PostgreSQL HEAD. It requires docbook 4.2, which I installed, but still the problem exist.

I described it in detail - including error messages, lists of packages, and configure options in mail to postgresql general mailing list.

Do you have any idea what to do to be able to build those docs?

link|improve this question
74% accept rate
An Arch Linux Bounty Question?! OMG. – Joseph Kern Nov 13 '09 at 16:22
@Joseph: I need those docs. – depesz Nov 14 '09 at 10:32
Have you tried the #archlinux irc channel? Do you have to use 4.2? I noticed there's a 4.5 in AUR ... – Joseph Kern Nov 15 '09 at 15:15
@Joseph - yes I tried. Yes, I have to - these are PostgreSQL docs, and I have no influence over source format. – depesz Nov 16 '09 at 13:06
feedback

2 Answers

up vote 1 down vote

These 'no' strings in ./configure output are okay: the script just tests the system capabilities.

As far as I understand, there's an error in /etc/xml/catalog. It also depends on some files in /etc/xml, which in turn uses definitions from /usr/share/xml, you may be missing something. Try the archive I've prepared for you and overwrite your /etc/xml & /usr/share/xml with its contents (backup first!). I believe it should really help.

link|improve this answer
I know system checks capabilities, but it doesn't let me (later on) build docs. Which is not ok, as I need those docs. – depesz Nov 13 '09 at 5:23
Ehm, have you tried my suggestion? – o_O Tync Nov 13 '09 at 12:42
feedback
up vote -1 down vote

This is reply to o_O Tync - sorry for abusing answers, but I can't format comment to answer.

So, i got your archive, unpacked and overwritten /etc/xml, /usr/share/xml and /usr/share/xml-core with what you provided.

configure still returns:

checking tcl.h presence... yes
checking for tcl.h... yes
checking for onsgmls... onsgmls
checking for openjade... no
checking for jade... jade
checking for DocBook V4.2... no
checking for DocBook stylesheets... no
checking for collateindex.pl... no
checking for xsltproc... xsltproc
checking for osx... osx
checking if gcc supports -Wl,--as-needed... yes

from config.log:

configure:27945: checking for jade
configure:27961: found /usr/bin/jade
configure:27972: result: jade
configure:27984: checking for DocBook V4.2
onsgmls:/etc/xml/catalog:2:61:E: name expected
onsgmls:/etc/xml/catalog:2:18:E: cannot find "PUBLIC"; tried "/etc/xml/PUBLIC", "/usr/share/sgml/PUBLIC", "/usr/share/xml/PUBLIC"
configure:28013: result: no
configure:28019: checking for DocBook stylesheets
configure:28058: result: no
configure:28112: checking for collateindex.pl
configure:28145: result: no

I even tried make html in src/sgml directory, and all i got was a long list of errors, starting with:

=> make html                              
make -C sgml html                         
make[1]: Entering directory `/home/pgdba/src/pgsql/doc/src/sgml'
{ \                                                             
          echo "<!entity version \"8.5devel\">"; \              
          echo "<!entity majorversion \"8.5\">"; \              
        } >version.sgml                                         
"/usr/bin/perl" ./mk_feature_tables.pl YES ../../../src/backend/catalog/sql_feature_packages.txt ../../../src/backend/catalog/sql_features.txt > features-supported.sgml
"/usr/bin/perl" ./mk_feature_tables.pl NO ../../../src/backend/catalog/sql_feature_packages.txt ../../../src/backend/catalog/sql_features.txt > features-unsupported.sgml
jade  -wall -wno-unused-param -wno-empty -wfully-tagged -D . -D .  -d stylesheet.dsl -t sgml -i output-html -V html-index postgres.sgml                                  
jade:E: unknown warning type "fully-tagged"                                                                                                                              
jade:postgres.sgml:3:55:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V4.2//EN"                                                            
jade:postgres.sgml:12:0:E: reference to entity "BOOK" for which no system identifier could be generated                                                                  
jade:postgres.sgml:3:0: entity was defined here                                                                                                                          
jade:postgres.sgml:12:0:E: DTD did not contain element declaration for document type name                                                                                
jade:postgres.sgml:14:9:E: there is no attribute "ID"                                                                                                                    
jade:postgres.sgml:14:19:E: element "BOOK" undefined                                                                                                                     
jade:postgres.sgml:15:7:E: element "TITLE" undefined                                                                                                                     
jade:postgres.sgml:17:10:E: element "BOOKINFO" undefined                                                                                                                 
jade:postgres.sgml:18:13:E: element "CORPAUTHOR" undefined                                                                                                               
jade:postgres.sgml:19:14:E: element "PRODUCTNAME" undefined                                                                                                              
jade:postgres.sgml:20:16:E: element "PRODUCTNUMBER" undefined

then i tried the same, but with first defining:

export DOCBOOKSTYLE=/usr/share/sgml/docbook-sgml-4.2

as it was suggested on pg list.

effect:

checking for tcl.h... yes
checking for onsgmls... onsgmls
checking for openjade... no
checking for jade... jade
checking for DocBook V4.2... no
checking for DocBook stylesheets... /usr/share/sgml/docbook-sgml-4.2
checking for collateindex.pl... no
checking for xsltproc... xsltproc
checking for osx... osx
checking if gcc supports -Wl,--as-needed... yes

same error in config.log

when building html i got:

=> make html 2>&1 | more                  
make -C sgml html
make[1]: Entering directory `/home/pgdba/src/pgsql/doc/src/sgml'
jade  -wall -wno-unused-param -wno-empty -wfully-tagged -D . -D . -c /usr/share/sgml/docbook-sgml-4.2/catalog -d stylesheet.dsl -t sgml -i output-html -V html-index postgres.sgml
jade:E: unknown warning type "fully-tagged"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:57:65:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:63:66:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:69:60:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:75:67:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:81:58:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:87:59:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:93:50:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Box and Line Drawing//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:99:46:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Russian Cyrillic//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:105:50:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:111:47:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Diacritical Marks//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:117:43:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Greek Letters//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:123:46:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Monotoniko Greek//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:129:43:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Greek Symbols//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:135:55:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:141:43:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Latin 1//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:147:43:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Added Latin 2//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:153:57:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:159:40:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES Publishing//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:165:47:W: cannot generate system identifier for public text "ISO 8879:1986//ENTITIES General Technical//EN"
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:308:8:E: reference to entity "ISOamsa" for which no system identifier could be generated
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:56:0: entity was defined here
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:312:8:E: reference to entity "ISOamsb" for which no system identifier could be generated
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:62:0: entity was defined here
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:316:8:E: reference to entity "ISOamsc" for which no system identifier could be generated
jade:/usr/share/sgml/docbook-sgml-4.2/dbcentx.mod:68:0: entity was defined here

and so on...

link|improve this answer
1  
Edit your question with this information. – womble Nov 15 '09 at 16:10
Hm, maybe if you know any distro that can build the docs, you should run it on a virtual machine? Alas, I have no better suggestions. – o_O Tync Nov 16 '09 at 17:33
Also can you please give me the link to these docs: I'll try something myself :) – o_O Tync Nov 16 '09 at 17:57
these are in cvs head - check description in here: bbs.archlinux.org/viewtopic.php?pid=654036#p654036 – depesz Nov 17 '09 at 15:51
I fetched the CVS snapshot. With some fixed issues, it builds OK on Ubuntu 9.10 'karmic'. This is PGSQL itself, not a docbook! Are you sure you need it? :) Here's the build result: sendspace.com/file/m9v35g – o_O Tync Nov 18 '09 at 12:03
show 6 more comments
feedback

Your Answer

 
or
required, but never shown
discard

Not the answer you're looking for? Browse other questions tagged or ask your own question.