Re: [HACKERS] 9.2rc1 build requirements

2012-09-01 Thread Robert Haas
On Thu, Aug 30, 2012 at 8:31 PM, Jeff Janes jeff.ja...@gmail.com wrote:
 patch to do that attached.

Committed.

-- 
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise PostgreSQL Company


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


[HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Joe Abbate
Hello hackers,

In order to test 9.2rc1, I had to build contrib (because Pyrseas uses
some of those modules).  The build instructions
(http://www.postgresql.org/docs/9.2/static/install-procedure.html )
state the way to build everything (contrib + docs, etc.) is

   gmake world

Unfortunately, that failed because the doc build requires jade.  I
managed to build contrib separately, but wanted to point out that jade
is not mentioned in the requirements page
(http://www.postgresql.org/docs/9.2/static/install-requirements.html ).
 In fact, searching for 'jade' returns no results.

As an aside, I installed jade (on Debian) and tried to make world but
got several errors, starting with the following:

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

Best regards,

Joe


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Jeff Janes
On Thu, Aug 30, 2012 at 1:18 PM, Joe Abbate j...@freedomcircle.com wrote:
 Hello hackers,

 In order to test 9.2rc1, I had to build contrib (because Pyrseas uses
 some of those modules).  The build instructions
 (http://www.postgresql.org/docs/9.2/static/install-procedure.html )
 state the way to build everything (contrib + docs, etc.) is

gmake world

 Unfortunately, that failed because the doc build requires jade.  I
 managed to build contrib separately, but wanted to point out that jade
 is not mentioned in the requirements page
 (http://www.postgresql.org/docs/9.2/static/install-requirements.html ).

That page should probably point out that there are additional
requirements to build the documentation, and link to the relevant
place that describes those.

  In fact, searching for 'jade' returns no results.

Searching in the 9.2 docs from the web page doesn't work at all, I'm
not sure why.  You can search for jade in 9.1, and then once you
find the page there is a cross link to the 9.2 version of it:

http://www.postgresql.org/docs/9.2/static/docguide-toolsets.html


 As an aside, I installed jade (on Debian) and tried to make world but
 got several errors, starting with the following:

 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

I think is probably because you don't have DocBook DTD or some of
the other prerequisites listed in the URL I gave above.  Or maybe you
just need to re-run make maintainer-clean and ./configure after
installing jade.  I've been tripped up by both issues in the past.


Cheers,

Jeff


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Alvaro Herrera
Excerpts from Joe Abbate's message of jue ago 30 16:18:05 -0400 2012:
 Hello hackers,
 
 In order to test 9.2rc1, I had to build contrib (because Pyrseas uses
 some of those modules).  The build instructions
 (http://www.postgresql.org/docs/9.2/static/install-procedure.html )
 state the way to build everything (contrib + docs, etc.) is
 
gmake world
 
 Unfortunately, that failed because the doc build requires jade.  I
 managed to build contrib separately, but wanted to point out that jade
 is not mentioned in the requirements page
 (http://www.postgresql.org/docs/9.2/static/install-requirements.html ).
  In fact, searching for 'jade' returns no results.
 
 As an aside, I installed jade (on Debian) and tried to make world but
 got several errors, starting with the following:
 
 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

I'm not sure what's the status of jade, but our Debian instructions to
build docs suggest to use openjade instead:
http://www.postgresql.org/docs/devel/static/docguide-toolsets.html

-- 
Álvaro Herrerahttp://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training  Services


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Tom Lane
Joe Abbate j...@freedomcircle.com writes:
 As an aside, I installed jade (on Debian) and tried to make world but
 got several errors, starting with the following:

 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

FWIW, that suggests that this version of jade is too old.  I'm not sure
that jade per se (as opposed to the successor project openjade) can be
used to build our docs at all --- you should check whether this is
openjade, or really the original project.

regards, tom lane


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Joe Abbate
Hello Jeff,

On 30/08/12 17:05, Jeff Janes wrote:
 I think is probably because you don't have DocBook DTD or some of
 the other prerequisites listed in the URL I gave above.

Indeed.  I was able to build world after invoking the apt-get line in
J.2.3 on that page.  The only adjustment I had to make is to add a
symbolic from /usr/share/sgml/openjade1.3 to /usr/share/sgml/jade
because it was looking for the 'catalog' file in the latter.

Thanks,

Joe


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Joe Abbate
On 30/08/12 17:36, Tom Lane wrote:
 FWIW, that suggests that this version of jade is too old.  I'm not sure
 that jade per se (as opposed to the successor project openjade) can be
 used to build our docs at all --- you should check whether this is
 openjade, or really the original project.

It was the old jade.  After I installed openjade, as suggested by Alvaro
and Jeff Janes, and re-ran ./configure the invocation line changed to
use openjade.

Joe


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Jeff Janes
On Thu, Aug 30, 2012 at 2:05 PM, Jeff Janes jeff.ja...@gmail.com wrote:
 On Thu, Aug 30, 2012 at 1:18 PM, Joe Abbate j...@freedomcircle.com wrote:

gmake world

 Unfortunately, that failed because the doc build requires jade.  I
 managed to build contrib separately, but wanted to point out that jade
 is not mentioned in the requirements page
 (http://www.postgresql.org/docs/9.2/static/install-requirements.html ).

 That page should probably point out that there are additional
 requirements to build the documentation, and link to the relevant
 place that describes those.

patch to do that attached.

Cheers,

Jeff


doc_require_doc_v1.patch
Description: Binary data

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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Jaime Casanova
On Thu, Aug 30, 2012 at 4:58 PM, Joe Abbate j...@freedomcircle.com wrote:
 On 30/08/12 17:36, Tom Lane wrote:
 FWIW, that suggests that this version of jade is too old.  I'm not sure
 that jade per se (as opposed to the successor project openjade) can be
 used to build our docs at all --- you should check whether this is
 openjade, or really the original project.

 It was the old jade.  After I installed openjade, as suggested by Alvaro
 and Jeff Janes, and re-ran ./configure the invocation line changed to
 use openjade.


so, now the question is: should we accept jade at all in configure? or
should we fail after not finding jade and report why?

-- 
Jaime Casanova www.2ndQuadrant.com
Professional PostgreSQL: Soporte 24x7 y capacitación


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Jaime Casanova
On Thu, Aug 30, 2012 at 7:47 PM, Jaime Casanova ja...@2ndquadrant.com wrote:
 On Thu, Aug 30, 2012 at 4:58 PM, Joe Abbate j...@freedomcircle.com wrote:
 On 30/08/12 17:36, Tom Lane wrote:
 FWIW, that suggests that this version of jade is too old.  I'm not sure
 that jade per se (as opposed to the successor project openjade) can be
 used to build our docs at all --- you should check whether this is
 openjade, or really the original project.

 It was the old jade.  After I installed openjade, as suggested by Alvaro
 and Jeff Janes, and re-ran ./configure the invocation line changed to
 use openjade.


 so, now the question is: should we accept jade at all in configure? or
 should we fail after not finding jade and report why?


the last one should read openjade ;)


-- 
Jaime Casanova www.2ndQuadrant.com
Professional PostgreSQL: Soporte 24x7 y capacitación


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


Re: [HACKERS] 9.2rc1 build requirements

2012-08-30 Thread Peter Eisentraut
On Thu, 2012-08-30 at 17:36 -0400, Tom Lane wrote:
 Joe Abbate j...@freedomcircle.com writes:
  As an aside, I installed jade (on Debian) and tried to make world but
  got several errors, starting with the following:
 
  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
 
 FWIW, that suggests that this version of jade is too old.  I'm not sure
 that jade per se (as opposed to the successor project openjade) can be
 used to build our docs at all --- you should check whether this is
 openjade, or really the original project.

This is a bit bizarre, actually.  His problem is that the old version of
jade doesn't understand the -wfully-tagged warning option.  But the
comment in the Makefile says

# -wfully-tagged needed to throw a warning on missing tags
# for older tool chains, 2007-08-31

AFAICT, the desirable effect of all these options together is to warn
about empty start tags, but only openjade supports -wfully-tagged, and
even the most recent version needs it to produce that warning.

Of course there could have been intermediate versions that I don't have
access to right now.



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