postgres.git / summary / log / commit / refs

commit    91f75212bbff4151d3dc391927721a2431e56973
Author:   Tom Lane <tgl@sss.pgh.pa.us>
Date:     Sat Oct 10 01:14:58 2026 +0000

    Doc: remove some annoying zero-width spaces.
    
    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


 doc/src/sgml/datatype.sgml       | 2 +-
 doc/src/sgml/func/func-uuid.sgml | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml
index 89985ab7b16..a3869e2054c 100644
--- a/doc/src/sgml/datatype.sgml
+++ b/doc/src/sgml/datatype.sgml
@@ -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>
diff --git a/doc/src/sgml/func/func-uuid.sgml b/doc/src/sgml/func/func-uuid.sgml
index 7b6181b38e7..430d2088fd9 100644
--- a/doc/src/sgml/func/func-uuid.sgml
+++ b/doc/src/sgml/func/func-uuid.sgml
@@ -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>


[parent: d8444163d22e]