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.) isgmake 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.) isgmake 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
Attachments:
doc_require_doc_v1.patchapplication/octet-stream; name=doc_require_doc_v1.patchDownload
diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
new file mode 100644
index c02ed87..2457fc5
*** a/doc/src/sgml/installation.sgml
--- b/doc/src/sgml/installation.sgml
*************** su - postgres
*** 280,285 ****
--- 280,293 ----
encryption using those services.
</para>
</listitem>
+
+ <listitem>
+ <para>
+ To build the <productname>PostgreSQL</productname> documentation,
+ there is a separate set of requirements.
+ See <xref linkend="docguide-toolsets">.
+ </para>
+ </listitem>
</itemizedlist>
</para>
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