public inbox for pgsql-docs@postgresql.org  

help / color / mirror / Atom feed

From: Tom Lane <tgl@sss.pgh.pa.us>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: scoobster17@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Suspected documentation error
Date: Wed, 06 May 2026 09:52:02 -0400
Message-ID: <767365.1778075522@sss.pgh.pa.us> (raw)
In-Reply-To: <CAKFQuwYWhSxoCPf9RTVVgs96oU78rdh3Aj05s2PCppb1GscA8g@mail.gmail.com>
References: <177801333530.795.16999885814007014333@wrigleys.postgresql.org>
	<CAKFQuwYWhSxoCPf9RTVVgs96oU78rdh3Aj05s2PCppb1GscA8g@mail.gmail.com>

"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

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: tgl@sss.pgh.pa.us, david.g.johnston@gmail.com, scoobster17@gmail.com, pgsql-docs@lists.postgresql.org
  Subject: Re: Suspected documentation error
  In-Reply-To: <767365.1778075522@sss.pgh.pa.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox