pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedCannot build docs on Ubuntu 10.04?
21+ messages / 8 participants
[nested] [flat]
* Cannot build docs on Ubuntu 10.04?
@ 2012-01-12 20:04 Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
0 siblings, 1 reply; 21+ messages in thread
From: Josh Berkus @ 2012-01-12 20:04 UTC (permalink / raw)
To: pgsql-docs
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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-12 20:17 ` Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:23 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
0 siblings, 2 replies; 21+ messages in thread
From: Kevin Grittner @ 2012-01-12 20:17 UTC (permalink / raw)
To: Josh Berkus <josh@agliodbs.com>; pgsql-docs
Josh Berkus <josh@agliodbs.com> 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
@ 2012-01-12 20:23 ` Josh Berkus <josh@agliodbs.com>
2012-01-12 21:53 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 1 reply; 21+ messages in thread
From: Josh Berkus @ 2012-01-12 20:23 UTC (permalink / raw)
To: Kevin Grittner <Kevin.Grittner@wicourts.gov>; +Cc: pgsql-docs
> 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:23 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-12 21:53 ` Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 21+ messages in thread
From: Tom Lane @ 2012-01-12 21:53 UTC (permalink / raw)
To: Josh Berkus <josh@agliodbs.com>; +Cc: Kevin Grittner <Kevin.Grittner@wicourts.gov>; pgsql-docs
Josh Berkus <josh@agliodbs.com> 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
@ 2012-01-12 20:28 ` Josh Berkus <josh@agliodbs.com>
2012-01-12 21:16 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:16 ` Re: Cannot build docs on Ubuntu 10.04? Alvaro Herrera <alvherre@commandprompt.com>
2012-01-12 21:43 ` Re: Cannot build docs on Ubuntu 10.04? Euler Taveira de Oliveira <euler@timbira.com>
2012-01-12 21:55 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 4 replies; 21+ messages in thread
From: Josh Berkus @ 2012-01-12 20:28 UTC (permalink / raw)
To: Kevin Grittner <Kevin.Grittner@wicourts.gov>; +Cc: pgsql-docs
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 "<!ENTITY version \"9.2devel\">"; \
echo "<!ENTITY majorversion \"9.2\">"; \
} > 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-12 21:16 ` Josh Berkus <josh@agliodbs.com>
3 siblings, 0 replies; 21+ messages in thread
From: Josh Berkus @ 2012-01-12 21:16 UTC (permalink / raw)
To: Kevin Grittner <Kevin.Grittner@wicourts.gov>; +Cc: pgsql-docs
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 "<!ENTITY version \"9.2devel\">"; \
> echo "<!ENTITY majorversion \"9.2\">"; \
> } > 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-12 21:16 ` Alvaro Herrera <alvherre@commandprompt.com>
2012-01-12 21:43 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 22:13 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
3 siblings, 2 replies; 21+ messages in thread
From: Alvaro Herrera @ 2012-01-12 21:16 UTC (permalink / raw)
To: Josh Berkus <josh@agliodbs.com>; +Cc: Kevin Grittner <kevin.grittner@wicourts.gov>; pgsql-docs
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 "<!ENTITY version \"9.2devel\">"; \
> echo "<!ENTITY majorversion \"9.2\">"; \
> } > 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 <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:16 ` Re: Cannot build docs on Ubuntu 10.04? Alvaro Herrera <alvherre@commandprompt.com>
@ 2012-01-12 21:43 ` Josh Berkus <josh@agliodbs.com>
2012-01-12 22:01 ` Re: Cannot build docs on Ubuntu 10.04? Alvaro Herrera <alvherre@commandprompt.com>
1 sibling, 1 reply; 21+ messages in thread
From: Josh Berkus @ 2012-01-12 21:43 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@commandprompt.com>; +Cc: Kevin Grittner <kevin.grittner@wicourts.gov>; pgsql-docs
> 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:16 ` Re: Cannot build docs on Ubuntu 10.04? Alvaro Herrera <alvherre@commandprompt.com>
2012-01-12 21:43 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-12 22:01 ` Alvaro Herrera <alvherre@commandprompt.com>
0 siblings, 0 replies; 21+ messages in thread
From: Alvaro Herrera @ 2012-01-12 22:01 UTC (permalink / raw)
To: Josh Berkus <josh@agliodbs.com>; +Cc: Kevin Grittner <kevin.grittner@wicourts.gov>; pgsql-docs
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 <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:16 ` Re: Cannot build docs on Ubuntu 10.04? Alvaro Herrera <alvherre@commandprompt.com>
@ 2012-01-12 22:13 ` Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 0 replies; 21+ messages in thread
From: Tom Lane @ 2012-01-12 22:13 UTC (permalink / raw)
To: Alvaro Herrera <alvherre@commandprompt.com>; +Cc: Josh Berkus <josh@agliodbs.com>; Kevin Grittner <kevin.grittner@wicourts.gov>; pgsql-docs
Alvaro Herrera <alvherre@commandprompt.com> 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-12 21:43 ` Euler Taveira de Oliveira <euler@timbira.com>
2012-01-12 21:50 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
3 siblings, 1 reply; 21+ messages in thread
From: Euler Taveira de Oliveira @ 2012-01-12 21:43 UTC (permalink / raw)
To: Josh Berkus <josh@agliodbs.com>; +Cc: Kevin Grittner <Kevin.Grittner@wicourts.gov>; pgsql-docs
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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:43 ` Re: Cannot build docs on Ubuntu 10.04? Euler Taveira de Oliveira <euler@timbira.com>
@ 2012-01-12 21:50 ` Josh Berkus <josh@agliodbs.com>
2012-01-27 17:19 ` Re: Cannot build docs on Ubuntu 10.04? Robert Haas <robertmhaas@gmail.com>
0 siblings, 1 reply; 21+ messages in thread
From: Josh Berkus @ 2012-01-12 21:50 UTC (permalink / raw)
To: Euler Taveira de Oliveira <euler@timbira.com>; +Cc: Kevin Grittner <Kevin.Grittner@wicourts.gov>; pgsql-docs
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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:43 ` Re: Cannot build docs on Ubuntu 10.04? Euler Taveira de Oliveira <euler@timbira.com>
2012-01-12 21:50 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-27 17:19 ` Robert Haas <robertmhaas@gmail.com>
2012-01-31 17:57 ` Re: Cannot build docs on Ubuntu 10.04? Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 21+ messages in thread
From: Robert Haas @ 2012-01-27 17:19 UTC (permalink / raw)
To: Josh Berkus <josh@agliodbs.com>; +Cc: Euler Taveira de Oliveira <euler@timbira.com>; Kevin Grittner <Kevin.Grittner@wicourts.gov>; pgsql-docs
On Thu, Jan 12, 2012 at 4:50 PM, Josh Berkus <josh@agliodbs.com> wrote:
> 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.
So do we have a complete list of the packages needed on Ubuntu now,
that we could add to the documentation? I grow weary of figuring this
out every time I set up a new machine.
--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:43 ` Re: Cannot build docs on Ubuntu 10.04? Euler Taveira de Oliveira <euler@timbira.com>
2012-01-12 21:50 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-27 17:19 ` Re: Cannot build docs on Ubuntu 10.04? Robert Haas <robertmhaas@gmail.com>
@ 2012-01-31 17:57 ` Peter Eisentraut <peter_e@gmx.net>
0 siblings, 0 replies; 21+ messages in thread
From: Peter Eisentraut @ 2012-01-31 17:57 UTC (permalink / raw)
To: Robert Haas <robertmhaas@gmail.com>; +Cc: Josh Berkus <josh@agliodbs.com>; Euler Taveira de Oliveira <euler@timbira.com>; Kevin Grittner <Kevin.Grittner@wicourts.gov>; pgsql-docs
On fre, 2012-01-27 at 12:19 -0500, Robert Haas wrote:
> So do we have a complete list of the packages needed on Ubuntu now,
> that we could add to the documentation? I grow weary of figuring this
> out every time I set up a new machine.
The list we have had in the documentation (under Debian) is correct.
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
@ 2012-01-12 21:55 ` Tom Lane <tgl@sss.pgh.pa.us>
2012-01-12 22:37 ` Re: Cannot build docs on Ubuntu 10.04? Alvaro Herrera <alvherre@commandprompt.com>
3 siblings, 1 reply; 21+ messages in thread
From: Tom Lane @ 2012-01-12 21:55 UTC (permalink / raw)
To: Josh Berkus <josh@agliodbs.com>; +Cc: Kevin Grittner <Kevin.Grittner@wicourts.gov>; pgsql-docs
Josh Berkus <josh@agliodbs.com> 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
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Re: Cannot build docs on Ubuntu 10.04? Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:28 ` Re: Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 21:55 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
@ 2012-01-12 22:37 ` Alvaro Herrera <alvherre@commandprompt.com>
0 siblings, 0 replies; 21+ messages in thread
From: Alvaro Herrera @ 2012-01-12 22:37 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Josh Berkus <josh@agliodbs.com>; Kevin Grittner <kevin.grittner@wicourts.gov>; pgsql-docs
Excerpts from Tom Lane's message of jue ene 12 18:55:41 -0300 2012:
> Josh Berkus <josh@agliodbs.com> 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 <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
@ 2012-03-14 13:25 John Lumby <johnlumby@hotmail.com>
2012-03-14 14:13 ` Re: Cannot build docs on Ubuntu 10.04? Alvaro Herrera <alvherre@commandprompt.com>
2012-03-14 14:21 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 2 replies; 21+ messages in thread
From: John Lumby @ 2012-03-14 13:25 UTC (permalink / raw)
To: pgsql-docs
On 12-01-2012 17:28, Josh Berkus wrote:
> Can't open perl script "/bin/collateindex.pl": No such file or directory
On Thu, 12 Jan 2012 19:37:20 -0300 Alvaro Herrera wrote:
> dpkg -S collateindex.pl
docbook-dsssl:
> /usr/bin/collateindex.pl
I wonder if everyone noticed that the postgres sgml makefile is looking for the script in /bin
(see Josh's append)
but docbook-dssl puts it in /usr/bin
(see Alvaro's append).
I think this line in
postgresql-9.1.3/doc/src/sgml/Makefile
COLLATEINDEX = $(DOCBOOKSTYLE)/bin/collateindex.pl
could be improved - maybe should read
COLLATEINDEX = `which collateindex.pl`
I fixed it by
ln `which collateindex.pl` /bin/collateindex.pl
maybe this is what the "configure" that someone mentioned would have done?
Cheers, John
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-03-14 13:25 Re: Cannot build docs on Ubuntu 10.04? John Lumby <johnlumby@hotmail.com>
@ 2012-03-14 14:13 ` Alvaro Herrera <alvherre@commandprompt.com>
1 sibling, 0 replies; 21+ messages in thread
From: Alvaro Herrera @ 2012-03-14 14:13 UTC (permalink / raw)
To: John Lumby <johnlumby@hotmail.com>; +Cc: pgsql-docs
Excerpts from John Lumby's message of mié mar 14 10:25:19 -0300 2012:
>
> On 12-01-2012 17:28, Josh Berkus wrote:
>
> > Can't open perl script "/bin/collateindex.pl": No such file or directory
>
> On Thu, 12 Jan 2012 19:37:20 -0300 Alvaro Herrera wrote:
> > dpkg -S collateindex.pl
> docbook-dsssl:
>
> > /usr/bin/collateindex.pl
>
>
> I wonder if everyone noticed that the postgres sgml makefile is looking for the script in /bin
> (see Josh's append)
> but docbook-dssl puts it in /usr/bin
> (see Alvaro's append).
>
> I think this line in
> postgresql-9.1.3/doc/src/sgml/Makefile
>
> COLLATEINDEX = $(DOCBOOKSTYLE)/bin/collateindex.pl
>
> could be improved - maybe should read
>
> COLLATEINDEX = `which collateindex.pl`
>
> I fixed it by
> ln `which collateindex.pl` /bin/collateindex.pl
>
> maybe this is what the "configure" that someone mentioned would have done?
What configure would have done is put the correct value of the
DOCBOOKSTYLE variable in Makefile.global. In Josh's case,
collateindex.pl was not found so the variable is empty, with the results
you see.
I think there's nothing to change here, except maybe to warn something
if DOCBOOKSTYLE is defined to empty.
--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-03-14 13:25 Re: Cannot build docs on Ubuntu 10.04? John Lumby <johnlumby@hotmail.com>
@ 2012-03-14 14:21 ` Tom Lane <tgl@sss.pgh.pa.us>
2012-03-14 17:47 ` Re: Cannot build docs on Ubuntu 10.04? John Lumby <johnlumby@hotmail.com>
2012-03-22 04:12 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 2 replies; 21+ messages in thread
From: Tom Lane @ 2012-03-14 14:21 UTC (permalink / raw)
To: John Lumby <johnlumby@hotmail.com>; +Cc: pgsql-docs
John Lumby <johnlumby@hotmail.com> writes:
> On 12-01-2012 17:28, Josh Berkus wrote:
> I wonder if everyone noticed that the postgres sgml makefile is looking for the script in /bin
> (see Josh's append)
That means that configure failed to find it, and failed to determine
a setting for DOCBOOKSTYLE as well.
> I think this line in
> postgresql-9.1.3/doc/src/sgml/Makefile
> COLLATEINDEX = $(DOCBOOKSTYLE)/bin/collateindex.pl
> could be improved - maybe should read
> COLLATEINDEX = `which collateindex.pl`
No, that would not be an improvement. If collateindex.pl were in your
PATH, then configure would have found it (cf PGAC_PATH_COLLATEINDEX),
and so COLLATEINDEX would be set and we'd not be here at all.
Maybe the Makefile should just error out if COLLATEINDEX isn't set,
rather than trying a "fallback" value that configure has already
determined isn't going to work.
regards, tom lane
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-03-14 13:25 Re: Cannot build docs on Ubuntu 10.04? John Lumby <johnlumby@hotmail.com>
2012-03-14 14:21 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
@ 2012-03-14 17:47 ` John Lumby <johnlumby@hotmail.com>
1 sibling, 0 replies; 21+ messages in thread
From: John Lumby @ 2012-03-14 17:47 UTC (permalink / raw)
To: pgsql-docs
Álvaro Herrera wrote :
> What configure would have done is put the correct value of the
> DOCBOOKSTYLE variable in Makefile.global. In Josh's case,
> collateindex.pl was not found so the variable is empty, with the results
you see.
I see, thanks.
Tom Lane wrote :
> No, that would not be an improvement. If collateindex.pl were in your
> PATH, then configure would have found it (cf PGAC_PATH_COLLATEINDEX),
> and so COLLATEINDEX would be set and we'd not be here at all.
Ok
> Maybe the Makefile should just error out if COLLATEINDEX isn't set,
> rather than trying a "fallback" value that configure has already
> determined isn't going to work.
actually, now I understand what happened, I suggest adding an additional configure option
--disable-docs
and configure should baulk if neither --disable-docs nor collateindex.pl in the PATH.
That makes it explicit.
Cheers John
^ permalink raw reply [nested|flat] 21+ messages in thread
* Re: Cannot build docs on Ubuntu 10.04?
2012-03-14 13:25 Re: Cannot build docs on Ubuntu 10.04? John Lumby <johnlumby@hotmail.com>
2012-03-14 14:21 ` Re: Cannot build docs on Ubuntu 10.04? Tom Lane <tgl@sss.pgh.pa.us>
@ 2012-03-22 04:12 ` Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 0 replies; 21+ messages in thread
From: Tom Lane @ 2012-03-22 04:12 UTC (permalink / raw)
To: pgsql-docs
I wrote:
> Maybe the Makefile should just error out if COLLATEINDEX isn't set,
> rather than trying a "fallback" value that configure has already
> determined isn't going to work.
I looked at this a bit closer, and figured out why the Makefile is
trying an apparently pointless case: the test implemented in configure
is wrong! In at least some installations of docbook, for instance the
ancient one I've got in captivity on my HPUX box, collateindex.pl is
provided in $(DOCBOOKSTYLE)/bin/, but *it is not marked executable*.
This causes AC_PATH_PROGS to not consider it valid. However, the docs
Makefile is coded to invoke the script via $(PERL) $(COLLATEINDEX),
which is presumably done precisely to be able to cope with
not-executable scripts.
So I think we should adjust the configure test to accept
$(DOCBOOKSTYLE)/bin/collateindex.pl if it is readable, whether or not it
is executable, and only use the Autoconf macro if we fall back to
searching PATH for collateindex.pl. Having done that, it should be safe
to simplify the Makefile to throw error if COLLATEINDEX isn't set.
regards, tom lane
^ permalink raw reply [nested|flat] 21+ messages in thread
end of thread, other threads:[~2012-03-22 04:12 UTC | newest]
Thread overview: 21+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2012-01-12 20:04 Cannot build docs on Ubuntu 10.04? Josh Berkus <josh@agliodbs.com>
2012-01-12 20:17 ` Kevin Grittner <Kevin.Grittner@wicourts.gov>
2012-01-12 20:23 ` Josh Berkus <josh@agliodbs.com>
2012-01-12 21:53 ` Tom Lane <tgl@sss.pgh.pa.us>
2012-01-12 20:28 ` Josh Berkus <josh@agliodbs.com>
2012-01-12 21:16 ` Josh Berkus <josh@agliodbs.com>
2012-01-12 21:16 ` Alvaro Herrera <alvherre@commandprompt.com>
2012-01-12 21:43 ` Josh Berkus <josh@agliodbs.com>
2012-01-12 22:01 ` Alvaro Herrera <alvherre@commandprompt.com>
2012-01-12 22:13 ` Tom Lane <tgl@sss.pgh.pa.us>
2012-01-12 21:43 ` Euler Taveira de Oliveira <euler@timbira.com>
2012-01-12 21:50 ` Josh Berkus <josh@agliodbs.com>
2012-01-27 17:19 ` Robert Haas <robertmhaas@gmail.com>
2012-01-31 17:57 ` Peter Eisentraut <peter_e@gmx.net>
2012-01-12 21:55 ` Tom Lane <tgl@sss.pgh.pa.us>
2012-01-12 22:37 ` Alvaro Herrera <alvherre@commandprompt.com>
2012-03-14 13:25 Re: Cannot build docs on Ubuntu 10.04? John Lumby <johnlumby@hotmail.com>
2012-03-14 14:13 ` Alvaro Herrera <alvherre@commandprompt.com>
2012-03-14 14:21 ` Tom Lane <tgl@sss.pgh.pa.us>
2012-03-14 17:47 ` John Lumby <johnlumby@hotmail.com>
2012-03-22 04:12 ` Tom Lane <tgl@sss.pgh.pa.us>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox