pgsql: Doc: remove some annoying zero-width spaces. - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Doc: remove some annoying zero-width spaces.
Date
Msg-id E1xFLgA-000000011MX-00M4@gemulon.postgresql.org
Whole thread
List pgsql-committers
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

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/91f75212bbff4151d3dc391927721a2431e56973

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


pgsql-committers by date:

Previous
From: Richard Guo
Date:
Subject: pgsql: Preserve typmod and collation when reducing an expression to its
Next
From: Richard Guo
Date:
Subject: pgsql: Fix expr_is_nonnullable() for IS DISTINCT FROM