On Mon, Apr 4, 2011 at 3:02 PM, Robert Haas <[email protected]> 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-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
