| From: | Bruce Momjian <bruce(at)momjian(dot)us> |
|---|---|
| To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Cc: | t(dot)kitynski(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org |
| Subject: | Re: Suggestion for deprecated spellings |
| Date: | 2023-01-30 21:17:14 |
| Message-ID: | Y9gz2rRpm6VKnC0M@momjian.us |
| Views: | Whole Thread | Raw Message | Download mbox | Resend email |
| Thread: | |
| Lists: | pgsql-docs |
On Mon, Jan 30, 2023 at 04:07:46PM -0500, Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > On Thu, Jan 26, 2023 at 12:19:29PM +0000, PG Doc comments form wrote:
> >> From time to time some spelling for given command gets obsolete, yet it is
> >> shown in the syntax on "equal rights" as other valid clauses.
>
> > We don't need to show all _supported_ syntaxes in the "Synopsis"
> > section, so we could just remove them.
>
> IIRC, there is precedent in COPY for moving obsolete alternatives
> to a separate part of the man page. I'd prefer that to just
> removing them, because then there is no documentation to help
> someone understand what an old SQL script is doing.
Yeah, I remember that with COPY. t(dot)kitynski(at)gmail(dot)com, please us that
as a guide. Thanks.
--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com
Embrace your flaws. They make you human, rather than perfect,
which you will never be.
| From | Date | Subject | |
|---|---|---|---|
| Next Message | PG Doc comments form | 2023-02-02 00:52:09 | 1.3 Creating a database - windows 10x64 |
| Previous Message | Tom Lane | 2023-01-30 21:07:46 | Re: Suggestion for deprecated spellings |