public inbox for [email protected]  

help / color / mirror / Atom feed

From: Bruce Momjian <[email protected]>
To: Tom Lane <[email protected]>
Cc: David G. Johnston <[email protected]>
Cc: [email protected]
Cc: [email protected]
Subject: Re: Suspected documentation error
Date: Thu, 14 May 2026 11:30:15 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<CAKFQuwYWhSxoCPf9RTVVgs96oU78rdh3Aj05s2PCppb1GscA8g@mail.gmail.com>
	<[email protected]>
	<CAKFQuwa8KbYmjwv1nw-=5JJ3Yks2GApX2GrcBNfOAgsZmwPBTQ@mail.gmail.com>
	<[email protected]>

On Wed, May  6, 2026 at 10:13:03AM -0400, Tom Lane wrote:
> "David G. Johnston" <[email protected]> writes:
> > On Wed, May 6, 2026 at 6:52 AM Tom Lane <[email protected]> wrote:
> >> 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.
> 
> > And isn't replaceable usually something the user is expected to provide a
> > value for - not something the system populates?
> 
> No, I think it just means "this word is not literally what you'd see
> or type".

I came up with the attached patch.  I think 'mm' is just too much like
months so I sent with 'mi', and the "replaceable" tag was already there.

-- 
  Bruce Momjian  <[email protected]>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Do not let urgent matters crowd out time for investment in the future.


Attachments:

  [text/x-diff] mi.diff (711B, 2-mi.diff)
  download | inline diff:
diff --git a/doc/src/sgml/func/func-formatting.sgml b/doc/src/sgml/func/func-formatting.sgml
index af9e2223998..e4edaf4f42c 100644
--- a/doc/src/sgml/func/func-formatting.sgml
+++ b/doc/src/sgml/func/func-formatting.sgml
@@ -424,8 +424,8 @@
        </row>
        <row>
         <entry><literal>OF</literal></entry>
-        <entry>time-zone offset from UTC (<replaceable>HH</replaceable>
-         or <replaceable>HH</replaceable><literal>:</literal><replaceable>MM</replaceable>)</entry>
+        <entry>time-zone offset from UTC (<replaceable>hh</replaceable>
+         or <replaceable>hh</replaceable><literal>:</literal><replaceable>mi</replaceable>)</entry>
        </row>
       </tbody>
      </tgroup>

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: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: Suspected documentation error
  In-Reply-To: <[email protected]>

* 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