Horton
Menu

Thread

  1. 9.2rc1 build requirements

    Joe Abbate <jma@freedomcircle.com> — 2012-08-30T20:18:05Z

    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

  2. Re: 9.2rc1 build requirements

    Alvaro Herrera <alvherre@2ndquadrant.com> — 2012-08-30T20:50:57Z

    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 Herrera                http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services

  3. Re: 9.2rc1 build requirements

    Jeff Janes <jeff.janes@gmail.com> — 2012-08-30T21:05:40Z

    On Thu, Aug 30, 2012 at 1:18 PM, Joe Abbate <jma@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

  4. Re: 9.2rc1 build requirements

    Tom Lane <tgl@sss.pgh.pa.us> — 2012-08-30T21:36:56Z

    Joe Abbate <jma@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

  5. Re: 9.2rc1 build requirements

    Joe Abbate <jma@freedomcircle.com> — 2012-08-30T21:39:48Z

    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

  6. Re: 9.2rc1 build requirements

    Joe Abbate <jma@freedomcircle.com> — 2012-08-30T21:58:56Z

    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

  7. Re: 9.2rc1 build requirements

    Jeff Janes <jeff.janes@gmail.com> — 2012-08-31T00:31:11Z

    On Thu, Aug 30, 2012 at 2:05 PM, Jeff Janes <jeff.janes@gmail.com> wrote:
> On Thu, Aug 30, 2012 at 1:18 PM, Joe Abbate <jma@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

  8. Re: 9.2rc1 build requirements

    Jaime Casanova <jaime@2ndquadrant.com> — 2012-08-31T00:47:01Z

    On Thu, Aug 30, 2012 at 4:58 PM, Joe Abbate <jma@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

  9. Re: 9.2rc1 build requirements

    Jaime Casanova <jaime@2ndquadrant.com> — 2012-08-31T00:48:08Z

    On Thu, Aug 30, 2012 at 7:47 PM, Jaime Casanova <jaime@2ndquadrant.com> wrote:
> On Thu, Aug 30, 2012 at 4:58 PM, Joe Abbate <jma@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

  10. Re: 9.2rc1 build requirements

    Peter Eisentraut <peter_e@gmx.net> — 2012-08-31T01:14:23Z

    On Thu, 2012-08-30 at 17:36 -0400, Tom Lane wrote:
> Joe Abbate <jma@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.

  11. Re: 9.2rc1 build requirements

    Robert Haas <robertmhaas@gmail.com> — 2012-09-01T10:28:47Z

    On Thu, Aug 30, 2012 at 8:31 PM, Jeff Janes <jeff.janes@gmail.com> wrote:
> patch to do that attached.

Committed.

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