On Mon, Apr 4, 2011 at 3:02 PM, Robert Haas <robertmh...@gmail.com> wrote: > In theory, we have > documentation that explains this: > > http://www.postgresql.org/docs/current/static/docguide-toolsets.html
While we're on the subject.. Attached is a patch against that page suggesting using openjade 1.3, not 1.4devel as part of the doc build toolset. Source of this recommendation: <http://old.nabble.com/openjade-segfault-on-Postgres-PDF%3A-flow-object-not-accepted-by-port-to30764268.html> I just double checked, and with the latest openjade package (1.4devel) on Ubuntu 10.10, I still see the same segfault; downgrading to package "openjade1.3" allows me to make postgres-A4.pdf successfully. Josh
diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml index 7ec75a3..7bbe324 100644 *** a/doc/src/sgml/docguide.sgml --- b/doc/src/sgml/docguide.sgml *************** CATALOG "docbook/4.2/catalog" *** 268,274 **** available for <productname>Debian GNU/Linux</productname>. To install, simply use: <programlisting> ! apt-get install docbook docbook-dsssl docbook-xsl openjade xsltproc </programlisting> </para> </sect2> --- 268,274 ---- available for <productname>Debian GNU/Linux</productname>. To install, simply use: <programlisting> ! apt-get install docbook docbook-dsssl docbook-xsl openjade1.3 xsltproc </programlisting> </para> </sect2> *************** make install *** 309,314 **** --- 309,327 ---- installed and you want to install the rest of the toolchain locally.) </para> + + <note> + <para> + Some users have reported encountering a segmentation fault using + openjade 1.4devel to build the PDFs, with a message like: + <screen> + openjade:./stylesheet.dsl:664:2:E: flow object not accepted by port; only display flow objects accepted + make: *** [postgres-A4.tex-pdf] Segmentation fault + </screen> + Downgrading to openjade 1.3 should get rid of this error. + </para> + </note> + </step> <step id="doc-openjade-install">
-- Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-hackers