Re: Suspected documentation error

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: scoobster17(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Suspected documentation error
Date: 2026-05-06 13:52:02
Message-ID: 767365.1778075522@sss.pgh.pa.us
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

"David G. Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> writes:
> On Tue, May 5, 2026 at 3:02 PM PG Doc comments form <noreply(at)postgresql(dot)org>
> wrote:
>> in the Udemy course I'm following, I noticed that the notes "OF" state
>> "time-zone offset from UTC (HH or HH:MM)", which I believe should be
>> "time-zone offset from UTC (HH or HH:MI)".

> Technically interpreting either of those according to the format specifiers
> co-located in that table is wrong.

Yeah; I think writing MI would make for more confusion not less, since
this specifier doesn't emit the same values that HH and MI refer to.

> All HH and MM stand for here are hours
> and minutes, trying to communicate fixed two-digits.

I'm inclined to try to fix it via formatting: change HH and MM to
lower case and wrap them in <replaceable> so they render in italics.
The other details are easily discovered by experiment, so I don't
feel a need to make the table entries any more verbose. Thoughts?

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message David G. Johnston 2026-05-06 14:07:59 Re: Suspected documentation error
Previous Message David G. Johnston 2026-05-05 23:27:42 Re: Suspected documentation error