Re: Suspected documentation error

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, scoobster17(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Suspected documentation error
Date: 2026-05-14 15:30:15
Message-ID: agXqh-3xDAOZvfid@momjian.us
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Wed, May 6, 2026 at 10:13:03AM -0400, Tom Lane wrote:
> "David G. Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> writes:
> > On Wed, May 6, 2026 at 6:52 AM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)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(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

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

Attachment Content-Type Size
mi.diff text/x-diff 711 bytes

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message David G. Johnston 2026-05-14 16:35:19 Re: Please clarify that Timestamp with Timezone doesn't preserve the timezone.
Previous Message Shinya Kato 2026-05-14 12:14:27 Re: doc: Clarify ANALYZE VERBOSE output