From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: t.kitynski@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Suggestion for deprecated spellings
Date: Mon, 30 Jan 2023 16:07:46 -0500
Message-ID: <888259.1675112866@sss.pgh.pa.us> (raw)
In-Reply-To: <Y9grBFU+2DBXBB7z@momjian.us>
References: <167473556945.2667294.2003897901995802549@wrigleys.postgresql.org>
<Y9grBFU+2DBXBB7z@momjian.us>
Bruce Momjian <bruce@momjian.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
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: tgl@sss.pgh.pa.us, bruce@momjian.us, t.kitynski@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Suggestion for deprecated spellings
In-Reply-To: <888259.1675112866@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox