[DOCS] Cannot build docs on Ubuntu 10.04?

#11

Josh Berkus <josh (AT) agliodbs (DOT) com> writes:

Quote:

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 (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#12

Excerpts from Josh Berkus's message of jue ene 12 18:43:39 -0300 2012:

Quote:

=20
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.
=20
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.

--=20
=C3=81lvaro Herrera <alvherre (AT) commandprompt (DOT) com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

--=20
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#13

Alvaro Herrera <alvherre (AT) commandprompt (DOT) com> writes:

Quote:

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 (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#14

Excerpts from Tom Lane's message of jue ene 12 18:55:41 -0300 2012:

Quote:

Josh Berkus <josh (AT) agliodbs (DOT) com> writes:
LC_ALL=3DC '/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
=20
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

--=20
=C3=81lvaro Herrera <alvherre (AT) commandprompt (DOT) com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

--=20
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#15

On Thu, Jan 12, 2012 at 4:50 PM, Josh Berkus <josh (AT) agliodbs (DOT) com> wrote:

Quote:

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

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#16

On fre, 2012-01-27 at 12:19 -0500, Robert Haas wrote:

Quote:

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.

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#17

On 12-01-2012 17:28, Josh Berkus wrote:

Quote:

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 forthe 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

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#18

Excerpts from John Lumby's message of mi=C3=A9 mar 14 10:25:19 -0300 2012:

Quote:

=20
On 12-01-2012 17:28, Josh Berkus wrote:
=20
Can't open perl script "/bin/collateindex.pl": No such file or directory
=20
On Thu, 12 Jan 2012 19:37:20 -0300 Alvaro Herrera wrote:
=C2=A0>=C2=A0 dpkg -S collateindex.pl
docbook-dsssl:
=20
=C2=A0>=C2=A0 /usr/bin/collateindex.pl
=20
=20
I wonder if everyone noticed that the postgres sgml makefile is looking f=
or the script in /bin
(see Josh's append)
but docbook-dssl puts it in /usr/bin=20
(see Alvaro's append).
=20
I think this line in
postgresql-9.1.3/doc/src/sgml/Makefile
=20
=C2=A0COLLATEINDEX =3D $(DOCBOOKSTYLE)/bin/collateindex.pl
=20
could be improved=C2=A0 -=C2=A0 maybe should read
=20
COLLATEINDEX =3D `which collateindex.pl`
=20
I fixed it by
=C2=A0ln `which collateindex.pl` /bin/collateindex.pl
=20
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.

--=20
=C3=81lvaro Herrera <alvherre (AT) commandprompt (DOT) com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

--=20
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#19

John Lumby <johnlumby (AT) hotmail (DOT) com> writes:

Quote:

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.

Quote:

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

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#20

Álvaro Herrera wrote :

Quote:

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 :

Quote:

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

Quote:

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

--
Sent via pgsql-docs mailing list (pgsql-docs (AT) postgresql (DOT) org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs