pgsql: Doc: manually break lines in wide UUID examples.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: manually break lines in wide UUID examples.
Date: 2025-03-18 19:35:45
Message-ID: E1tucj3-00394P-2N@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: manually break lines in wide UUID examples.

Buildfarm member crake has been complaining "WARNING: The contents of
fo:inline line 1 exceed the available area in the inline-progression
direction by 20500 millipoints. (See position 23808:106)" since
ba57dcfdc went in. The other doc-building animals are not showing
this warning, and I don't see it on my RHEL8 workstation either, but
I was able to reproduce it on a Fedora 41 box. So apparently this
is due to a recent-ish change in DocBook's line-breaking heuristics,
which caused it to cope less well with the UUIDs in these examples.
Put in some zero-width spaces to encourage the PDF toolchain to
break these lines in a better place. (Only one of these examples
actually needs this today, but I marked up all three to ensure that
they get wrapped in a consistent way.)

Branch
------
master

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

Modified Files
--------------
doc/src/sgml/func.sgml | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Bruce Momjian 2025-03-18 20:08:22 Re: pgsql: Increase default maintenance_io_concurrency to 16
Previous Message Andres Freund 2025-03-18 18:12:56 pgsql: smgr: Make SMgrRelation initialization safer against errors