Re: Suspected documentation error - Mailing list pgsql-docs

From Tom Lane
Subject Re: Suspected documentation error
Date
Msg-id 767365.1778075522@sss.pgh.pa.us
Whole thread
In response to Re: Suspected documentation error  ("David G. Johnston" <david.g.johnston@gmail.com>)
Responses Re: Suspected documentation error
List pgsql-docs
"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Tue, May 5, 2026 at 3:02 PM PG Doc comments form <noreply@postgresql.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



pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: Suspected documentation error
Next
From: "David G. Johnston"
Date:
Subject: Re: Suspected documentation error