public inbox for pgsql-docs@postgresql.org
help / color / mirror / Atom feedFrom: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: David G. Johnston <david.g.johnston@gmail.com>
Cc: scoobster17@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Suspected documentation error
Date: Thu, 14 May 2026 11:30:15 -0400
Message-ID: <agXqh-3xDAOZvfid@momjian.us> (raw)
In-Reply-To: <768685.1778076783@sss.pgh.pa.us>
References: <177801333530.795.16999885814007014333@wrigleys.postgresql.org>
<CAKFQuwYWhSxoCPf9RTVVgs96oU78rdh3Aj05s2PCppb1GscA8g@mail.gmail.com>
<767365.1778075522@sss.pgh.pa.us>
<CAKFQuwa8KbYmjwv1nw-=5JJ3Yks2GApX2GrcBNfOAgsZmwPBTQ@mail.gmail.com>
<768685.1778076783@sss.pgh.pa.us>
On Wed, May 6, 2026 at 10:13:03AM -0400, Tom Lane wrote:
> "David G. Johnston" <david.g.johnston@gmail.com> writes:
> > On Wed, May 6, 2026 at 6:52 AM Tom Lane <tgl@sss.pgh.pa.us> 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 <bruce@momjian.us> 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: pgsql-docs@postgresql.org
Cc: bruce@momjian.us, 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: <agXqh-3xDAOZvfid@momjian.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