Advise Debian/Ubuntu users to use openjade1.3.

The latest openjade packages for Ubuntu 10.10 seg fault when building
our documentation.

Josh Berkus

diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml
index 7ec75a3f3f3ccc22e7cddbaff3c47d8dfaefb47f..7bbe3246e74adab9efe7afec959a47eb3bf87c23 100644 (file)
--- a/doc/src/sgml/docguide.sgml
+++ b/doc/src/sgml/docguide.sgml
@@ -268,7 +268,7 @@ CATALOG "docbook/4.2/catalog"
     available for Debian GNU/Linux.
     To install, simply use:
 
-apt-get install docbook docbook-dsssl docbook-xsl openjade xsltproc
+apt-get install docbook docbook-dsssl docbook-xsl openjade1.3 xsltproc
 
    
   
@@ -309,6 +309,19 @@ make install
         installed and you want to install the rest of the toolchain
         locally.)
        
+
+       
+       
+        Some users have reported encountering a segmentation fault using
+        openjade 1.4devel to build the PDFs, with a message like:
+
+openjade:./stylesheet.dsl:664:2:E: flow object not accepted by port; only display flow objects accepted
+make: *** [postgres-A4.tex-pdf] Segmentation fault
+
+        Downgrading to openjade 1.3 should get rid of this error.
+       
+       
+