pgsql: Doc: fix some rendering problems in the PDF docs build.

Started by Tom Laneabout 3 years ago3 messagescomitters
Jump to latest
#1Tom Lane
tgl@sss.pgh.pa.us

Doc: fix some rendering problems in the PDF docs build.

Tweak column widths in a couple of tables to avoid "contents
... exceed the available area" warnings. Remove usage of
some non-Latin-1 characters.

Discussion: /messages/by-id/614600.1684537037@sss.pgh.pa.us

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/b62381d9a23b4b96259cf560e411137656201704

Modified Files
--------------
doc/src/sgml/charset.sgml | 21 +++++++++++++++++----
doc/src/sgml/release-16.sgml | 2 +-
2 files changed, 18 insertions(+), 5 deletions(-)

#2Jeff Davis
pgsql@j-davis.com
In reply to: Tom Lane (#1)
Re: pgsql: Doc: fix some rendering problems in the PDF docs build.

On Sun, 2023-05-21 at 15:21 +0000, Tom Lane wrote:

Doc: fix some rendering problems in the PDF docs build.

Tweak column widths in a couple of tables to avoid "contents
... exceed the available area" warnings.  Remove usage of
some non-Latin-1 characters.

Thank you for taking care of this.

Aside from the formatting issue, I included some non-ascii characters
in the documentation. Are those OK, or should I replace them with &#
sequences, or find some way to not use such characters at all?

I see a few places with such non-ASCII characters, but only a few, so
it's possible those are mistakes.

Regards,
Jeff Davis

#3Tom Lane
tgl@sss.pgh.pa.us
In reply to: Jeff Davis (#2)
Re: pgsql: Doc: fix some rendering problems in the PDF docs build.

Jeff Davis <pgsql@j-davis.com> writes:

Aside from the formatting issue, I included some non-ascii characters
in the documentation. Are those OK, or should I replace them with &#
sequences, or find some way to not use such characters at all?

I see a few places with such non-ASCII characters, but only a few, so
it's possible those are mistakes.

The PDF toolchain can cope with ISO-8859-1 (Latin-1) characters,
so it's not problematic to use those. I'm not seeing any complaints
from the current build.

regards, tom lane