| 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
| 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 |