Re: Suggestion for deprecated spellings

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Bruce Momjian <bruce(at)momjian(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:07:46
Message-ID: 888259.1675112866@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2023-01-30 21:17:14 Re: Suggestion for deprecated spellings
Previous Message Bruce Momjian 2023-01-30 20:52:55 Re: Suggestion for deprecated spellings