Doc: manually break lines in wide UUID examples.
authorTom Lane <tgl@sss.pgh.pa.us>
Tue, 18 Mar 2025 19:35:13 +0000 (15:35 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Tue, 18 Mar 2025 19:35:13 +0000 (15:35 -0400)
commita6524105d20b190fb4f5b2116e044e29be88f215
treecb99bab3bb9b79dde42089e23154cd60a1ae5195
parent499faf9063a4c5a9985d7ac657b86e8e34e02199
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.)
doc/src/sgml/func.sgml