From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
---|---|
To: | Bruce Momjian <bruce(at)momjian(dot)us> |
Cc: | Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, juha(dot)mustonen(at)iki(dot)fi, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: [DOCS] Add example about date ISO format |
Date: | 2023-11-22 20:19:00 |
Message-ID: | CAKFQuwaYMEsbPEKEX9W2E9gzYRLYq8142CpU3VoAbfZFBORg6w@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Wed, Nov 22, 2023 at 12:26 PM Bruce Momjian <bruce(at)momjian(dot)us> wrote:
> On Wed, Nov 22, 2023 at 06:26:45PM +0100, Álvaro Herrera wrote:
> > On 2023-Nov-22, Laurenz Albe wrote:
> >
> > > I think the example had best be at "8.5.2. Date/Time Output", in
> > > doc/src/sgml/datatype.sgml around line 2552.
> >
> > Actually, isn't that a strange location? Chapter 8.5.2 is about the
> > datatype itself, and there's already a cross-link to Section 9.8 for
> > to_char() stuff. Since this is to_char() that the example wants to add,
> > I think the to_char reference is a more appropriate place -- probably
> > table "9.31 to_char Examples".
>
> I originally thought it belonged in section 9.8 too, but I think the
> value of this example is ISO 8601 and I don't see how we can cleanly
> mention that in table 9.31.
>
>
Most of our tables have description columns, we could add one here. Or
I've seen us use footnote superscripts before in a table then add the
footnote text after the end of the table.
I'm against incorporating this material into the data types in Chapter 8.
David J.
From | Date | Subject | |
---|---|---|---|
Next Message | Bruce Momjian | 2023-11-22 21:13:10 | Re: [DOCS] Confusing Trigger Docs. |
Previous Message | Bruce Momjian | 2023-11-22 19:26:28 | Re: [DOCS] Add example about date ISO format |