| From: | Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Cc: | y(dot)saburov(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org |
| Subject: | Re: Table 9.46. UUID Extraction Functions |
| Date: | 2026-10-09 22:25:06 |
| Message-ID: | 176ada94989db19564e580b48c2b44be94a06d3e.camel@cybertec.at |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
On Fri, 2026-10-09 at 01:35 -0400, Tom Lane wrote:
> Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at> writes:
> > On Thu, 2026-10-08 at 23:32 -0400, Tom Lane wrote:
> > > I still wonder whether there's another solution path though.
> > > We settled on &zwsp; because it fixed the major issue here,
> > > but that doesn't mean there isn't a better answer.
>
> > I think that an improved version could look as follows:
>
> > uuid_extract_timestamp(
> > '019535d9-3df7-79fb-b466-fa907fa17f9e'::uuid
> > ) → 2025-02-23 21:46:24.503-05
>
> Hmm, yeah, that could work so far as the PDF line-break problem
> is concerned. Would it look too odd to HTML readers?
>
> > Also, not everything (query results etc.) are likely to be copied and
> > pasted by users. So I guess the way forward would be for me to spend
> > some time with this. But then - is it *that* important?
>
> Yup, that. If you want to press forward, have at it; I'm willing
> to push fixes in this area.
I felt inspired enough to take a look, and I found only three places
that looked like likely things that someone might copy and paste.
The first didn't actually need a line break in either the US letter
or A4 format, so I simply removed the &zwsp;. I wonder if some other
documentation format might need it though...
For the UUID functions that the complaint was about, I simply added
regular spaces inside the parentheses, which in HTML looks like
uuid_extract_version( '41db1265-8bc1-4ab3-992f-885799a4af1d'::uuid ) → 4
I'd say that that is acceptable.
Yours,
Laurenz Albe
| Attachment | Content-Type | Size |
|---|---|---|
| v1-0001-Remove-some-zero-width-spaces-in-the-docs.patch | text/x-patch | 2.7 KB |
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Tom Lane | 2026-10-10 00:25:16 | Re: Table 9.46. UUID Extraction Functions |
| Previous Message | Tom Lane | 2026-10-09 21:36:06 | Re: ALTER SCHEMA: renaming does not update string-literal function bodies |