Thread: 9.2rc1 build requirements
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
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
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
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
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
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
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
Attachment
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
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
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.
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