public inbox for [email protected]  

help / color / mirror / Atom feed

From: Josh Kupershmidt <[email protected]>
To: Robert Haas <[email protected]>
Cc: Christopher Browne <[email protected]>
Cc: Susanne Ebrecht <[email protected]>
Cc: Tom Lane <[email protected]>
Cc: Gabriele Bartolini <[email protected]>
Cc: [email protected]
Cc: PostgreSQL-development <[email protected]>
Subject: Re: [HACKERS] Uppercase SGML entity declarations
Date: Tue, 5 Apr 2011 21:55:31 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>

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-to307642...;

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


Attachments:

  [text/x-diff] docguide_openjade.diff (1.4K, 2-docguide_openjade.diff)
  download | inline diff:
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">

view thread (29+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: [HACKERS] Uppercase SGML entity declarations
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox