On Thu, 2026-10-08 at 12:41 -0400, Tom Lane wrote:
> Laurenz Albe <[email protected]> writes:
> > On Thu, 2026-10-08 at 04:21 +0000, PG Doc comments form wrote:
> > > Page: https://www.postgresql.org/docs/18/functions-uuid.html
> > > 
> > > Examples not working; (zero-width space)
> > > 
> > > select 
> > > uuid_extract_version('41db1265-8bc1-4ab3-992f-​885799a4af1d'::uuid);
> > > ПОМИЛКА:  неприпустимий синтаксис для типу uuid:
> > > "41db1265-8bc1-4ab3-992f-​885799a4af1d"
> > > LINE 1: select uuid_extract_version('41db1265-8bc1-4ab3-992f-​8857...
> 
> > Right.  That must have slipped in by mistake.
> 
> Not in the least.  Those, and every other &zwsp; in the SGML docs,
> are there so that the PDF version renders without complaints about
> overlength lines.  For cases like this, FOP is not bright enough
> to break what looks to it like one huge word, so we have to help it
> out by putting in fake whitespace.
> 
> If you know another way to accomplish that goal, I wouldn't mind
> changing.  But just removing these characters isn't OK.
> 
> I'm not personally of the opinion that copying-and-pasting our
> examples is a useful thing to do, so I'm not particularly concerned
> about this complaint.

Ugh.  I should have put some effort into research before claiming
it is a mistake.

But I doubt if is is smart to break copy and paste from the HTML
documentation to avoid warnings in the PDF build.  I for one regularly
copy and paste stuff from the HTML documentation, and I have seen and
built the PDF documentation for the first time today (before writing
this).  I doubt I am the only one.  Are these warnings a big problem?

Yours,
Laurenz Albe


Reply via email to