Re: [DOCS] PDF building with FOP - Mailing list pgsql-docs

From Alexander Law
Subject Re: [DOCS] PDF building with FOP
Date
Msg-id 2222e787-430e-4d67-4f55-4e091b7a2f53@gmail.com
Whole thread Raw
In response to [DOCS] PDF building with FOP  (Peter Eisentraut <peter.eisentraut@2ndquadrant.com>)
List pgsql-docs
Hello Peter,

11.03.2017 05:25, Peter Eisentraut wrote:
> The questions for those who are building PDFs are
>
> - Can you make the build work?
>
> - Does the output look OK?
Yes, we use FOP build to generate all the PDF's for current versions
(starting with 9.5).
Output looks ok, though we need to use extra fop-config.xml with font
substitutions to get Russian letters in the translated docs
(e.g. http://repo.postgrespro.ru/doc/pgsql/9.6/ru/postgres-A4-fop.pdf).
> Some tips:  FOP is extremely memory hungry.  You will probably have to
> fiddle with some Java memory settings to make it work.  One way is by
> edting ~/.foprc and set something like
>
> FOP_OPTS='-Xmx1200m'          # fop upstream binary installation
> ADDITIONAL_FLAGS='-Xmx1200m'  # centos/fedora
> JAVA_ARGS='-Xmx1200m'         # debian
>
> It looks like you need at least -Xmx1000m, depending on the fop version.
>   More memory can make things faster.  (Some of this could go into the
> documentation.)
Yes, we added JAVA_ARGS=-Xmx4096m to get the docs built on Ubuntu 14.04
(with FOP Version 1.1)
We also haven't encountered new problems on Ubuntu 16.04 (with FOP
Version 2.1). (This version prints some additional warnings, but the
resulting PDF looks valid).

Best regards,
Alexander



pgsql-docs by date:

Previous
From: Alexander Law
Date:
Subject: Re: [DOCS] PDF building with FOP
Next
From: johnjdevine@gmail.com
Date:
Subject: [DOCS] incorrect assignment op (= vs :=)