[DOCS] Cannot build docs on Ubuntu 10.04?
What packages and versions do I need to install to build the docs on Ubuntu? I tried 10.04's version of Openjade, which wasn't recognized, and with "jade" I got: postgres@31214-1-950145:/usr/local/src/test$ make docs make -C doc all make[1]: Entering directory `/usr/local/src/test/doc' make -C src all make[2]: Entering directory `/usr/local/src/test/doc/src' make -C sgml all make[3]: Entering directory `/usr/local/src/test/doc/src/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 ... and lots of other errors, eventually fatal. Requirements for building the docs are not documented in our docs. -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
Josh Berkus wrote: > What packages and versions do I need to install to build the docs > on Ubuntu? > > I tried 10.04's version of Openjade, which wasn't recognized > Requirements for building the docs are not documented in our docs. I did find that getting the doc build going was a bit fussy, even after reading the docs on it: http://www.postgresql.org/docs/current/static/docguide.html There were recently some posts that helped me clear up a lot of warnings I was getting, which basically boiled down to the need to install the opensp package. -Kevin -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
> http://www.postgresql.org/docs/current/static/docguide.html > > There were recently some posts that helped me clear up a lot of > warnings I was getting, which basically boiled down to the need to > install the opensp package. Yeah, that guide isn't much help, because the named requirements don't relate at all to debian/ubuntu packages. We'd probably get more help on the docs if it wasn't a day-long effort to build them. Sphinx anyone? -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
To be more specific, having installed all of the requirements listed in
builddocs, I'm still getting a fatal error:
make[3]: Entering directory `/usr/local/src/test/doc/src/sgml'
{ \
echo ""; \
echo ""; \
} > 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
'/usr/bin/perl' ./generate-errcodes-table.pl
../../../src/backend/utils/errcodes.txt > errcodes-table.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"
LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
bookindex.sgml HTML.index
Can't open perl script "/bin/collateindex.pl": No such file or directory
make[3]: *** [bookindex.sgml] Error 2
--
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
On 1/12/12 12:28 PM, Josh Berkus wrote:
> To be more specific, having installed all of the requirements listed in
> builddocs, I'm still getting a fatal error:
>
> make[3]: Entering directory `/usr/local/src/test/doc/src/sgml'
> { \
> echo ""; \
> echo ""; \
> } > 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
> '/usr/bin/perl' ./generate-errcodes-table.pl
> ../../../src/backend/utils/errcodes.txt > errcodes-table.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"
> LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
> bookindex.sgml HTML.index
> Can't open perl script "/bin/collateindex.pl": No such file or directory
> make[3]: *** [bookindex.sgml] Error 2
So apparently I needed to do a "make distclean" and then ./configure
again after installing a couple of the missing packages. Built now.
--
Josh Berkus
PostgreSQL Experts Inc.
http://pgexperts.com
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
Excerpts from Josh Berkus's message of jue ene 12 17:28:28 -0300 2012:
> To be more specific, having installed all of the requirements listed in
> builddocs, I'm still getting a fatal error:
>
> make[3]: Entering directory `/usr/local/src/test/doc/src/sgml'
> { \
> echo ""; \
> echo ""; \
> } > 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
> '/usr/bin/perl' ./generate-errcodes-table.pl
> ../../../src/backend/utils/errcodes.txt > errcodes-table.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"
> LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o
> bookindex.sgml HTML.index
> Can't open perl script "/bin/collateindex.pl": No such file or directory
> make[3]: *** [bookindex.sgml] Error 2
Did you re-run configure after installing everything? It seems to me
the path to collateindex.pl is not correctly set -- looks like a
variable expanding to empty string.
The warning about "unknown warning type" means you're using the wrong
tool to me. My toolchain here uses "openjade" which is a fork of the
earlier jade (so install opensp as Kevin suggested, and rerun configure
after that); my guess is that we're pretty much dependent on openjade
features that did not exist in plain jade. Maybe we should just get rid
of our attempts to use the older tool.
--
Álvaro Herrera
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
> The warning about "unknown warning type" means you're using the wrong > tool to me. My toolchain here uses "openjade" which is a fork of the > earlier jade (so install opensp as Kevin suggested, and rerun configure > after that); my guess is that we're pretty much dependent on openjade > features that did not exist in plain jade. Maybe we should just get rid > of our attempts to use the older tool. Yeah, the problem is that if you install just "openjade" on debian/ubuntu, it doesn't create the command "jade", which is what our make script is looking for. -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
On 12-01-2012 17:28, Josh Berkus wrote: > Can't open perl script "/bin/collateindex.pl": No such file or directory > make[3]: *** [bookindex.sgml] Error 2 > Did you install docbook-dsssl? It must contain that script. -- Euler Taveira de Oliveira - Timbira http://www.timbira.com.br/ PostgreSQL: Consultoria, Desenvolvimento, Suporte 24x7 e Treinamento -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
On 1/12/12 1:43 PM, Euler Taveira de Oliveira wrote: > On 12-01-2012 17:28, Josh Berkus wrote: >> Can't open perl script "/bin/collateindex.pl": No such file or directory >> make[3]: *** [bookindex.sgml] Error 2 >> > Did you install docbook-dsssl? It must contain that script. Per prior email, I needed to do a "make distclean" and re-configure. -- Josh Berkus PostgreSQL Experts Inc. http://pgexperts.com -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
Josh Berkus writes: > We'd probably get more help on the docs if it wasn't a day-long effort > to build them. [ shrug... ] On Fedora, installing the "authoring/publishing tools" package group has always gotten me everything needed. regards, tom lane -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
Josh Berkus writes: > LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o > bookindex.sgml HTML.index > Can't open perl script "/bin/collateindex.pl": No such file or directory On Fedora, that script comes in the docbook-style-dsssl package. Don't know how Ubuntu has chopped things up. regards, tom lane -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
Excerpts from Josh Berkus's message of jue ene 12 18:43:39 -0300 2012: > > > The warning about "unknown warning type" means you're using the wrong > > tool to me. My toolchain here uses "openjade" which is a fork of the > > earlier jade (so install opensp as Kevin suggested, and rerun configure > > after that); my guess is that we're pretty much dependent on openjade > > features that did not exist in plain jade. Maybe we should just get rid > > of our attempts to use the older tool. > > Yeah, the problem is that if you install just "openjade" on > debian/ubuntu, it doesn't create the command "jade", which is what our > make script is looking for. BS. You just neglected to rerun configure at that point. # config/docbook.m4 # PGAC_PROG_JADE # -- AC_DEFUN([PGAC_PROG_JADE], [AC_CHECK_PROGS([JADE], [openjade jade])]) I think the main failure of the docs is to make it more prominent that you need to rerun configure after you install stuff. -- Álvaro Herrera The PostgreSQL Company - Command Prompt, Inc. PostgreSQL Replication, Consulting, Custom Development, 24x7 support -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
Alvaro Herrera writes: > The warning about "unknown warning type" means you're using the wrong > tool to me. My toolchain here uses "openjade" which is a fork of the > earlier jade (so install opensp as Kevin suggested, and rerun configure > after that); my guess is that we're pretty much dependent on openjade > features that did not exist in plain jade. Maybe we should just get rid > of our attempts to use the older tool. Hm ... on my machine /usr/bin/jade is a symlink to openjade, anyway. My recollection is that even with openjade, it won't work real well with older versions because of assorted bugs in that tool that have been fixed over time. So original jade might be pretty hopeless by now. regards, tom lane -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Cannot build docs on Ubuntu 10.04?
Excerpts from Tom Lane's message of jue ene 12 18:55:41 -0300 2012: > Josh Berkus writes: > > LC_ALL=C '/usr/bin/perl' /bin/collateindex.pl -f -g -i 'bookindex' -o > > bookindex.sgml HTML.index > > Can't open perl script "/bin/collateindex.pl": No such file or directory > > On Fedora, that script comes in the docbook-style-dsssl package. Don't > know how Ubuntu has chopped things up. $ dpkg -S collateindex.pl docbook-dsssl: /usr/share/man/man1/collateindex.pl.1.gz docbook-dsssl: /usr/bin/collateindex.pl -- Álvaro Herrera The PostgreSQL Company - Command Prompt, Inc. PostgreSQL Replication, Consulting, Custom Development, 24x7 support -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
