database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2026-10-23 13:29:09 +03:00
Code Activity

Doc: remove some annoying zero-width spaces.

Browse Source 
To avoid warnings and lines that extend beyond the right page
margin in the PDF documentation, we have zero-width spaces in
the source at strategic places.  They are not visible to the
naked eye, but allow FOP to break the lines in sane places.

However, some of these zero-width spaces were in the middle of
text that people might copy and paste from the HTML documentation,
which leads to mysterious syntax errors.

Scanning the documentation for &zwsp; identified four places
that this patch improves:

- an ISO 8601 interval literal didn't actually need a line break
  in either the US letter or A4 format, so simply remove that
  zero-width space.

- three v18-era examples for uuid_extract_timestamp() and
  uuid_extract_version() had zero-width spaces in the middle of UUID
  literals.  Instead, add regular spaces around the "::" cast symbols,
  allowing FOP to break the lines there.  This solution isn't
  invisible in the HTML output, but it doesn't look bad.

Reported-by: Y. Saburov <y.saburov@gmail.com>
Author: Laurenz Albe <laurenz.albe@cybertec.at>
Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/179143326813.1061054.14714458907175925072@wrigleys.postgresql.org
Backpatch-through: 18
This commit is contained in:
Tom Lane
2026-10-09 21:14:58 -04:00
parent d8444163d2
commit 91f75212bb
2 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/sgml/datatype.sgml
View File

@@ -3058,7 +3058,7 @@ SELECT '2 years 15 months 100 weeks 99 hours 123456789 milliseconds'::interval;
<entry><literal>iso_8601</literal></entry>
<entry>P1Y2M</entry>
<entry>P3DT4H5M6S</entry>
<entry>P-1Y-2M3D&zwsp;T-4H-5M-6S</entry>
<entry>P-1Y-2M3DT-4H-5M-6S</entry>
</row>
</tbody>
</tgroup>

6
doc/src/sgml/func/func-uuid.sgml
View File

@@ -142,7 +142,7 @@
implementation that generated the UUID.
</para>
<para>
<literal>uuid_extract_timestamp('019535d9-3df7-79fb-b466-&zwsp;fa907fa17f9e'::uuid)</literal>
<literal>uuid_extract_timestamp('019535d9-3df7-79fb-b466-fa907fa17f9e' :: uuid)</literal>
<returnvalue>2025-02-23 21:46:24.503-05</returnvalue>
</para></entry>
</row>
@@ -161,11 +161,11 @@
return 4.
</para>
<para>
<literal>uuid_extract_version('41db1265-8bc1-4ab3-992f-&zwsp;885799a4af1d'::uuid)</literal>
<literal>uuid_extract_version('41db1265-8bc1-4ab3-992f-885799a4af1d' :: uuid)</literal>
<returnvalue>4</returnvalue>
</para>
<para>
<literal>uuid_extract_version('019535d9-3df7-79fb-b466-&zwsp;fa907fa17f9e'::uuid)</literal>
<literal>uuid_extract_version('019535d9-3df7-79fb-b466-fa907fa17f9e' :: uuid)</literal>
<returnvalue>7</returnvalue>
</para></entry>
</row>