Date: Tue, 10 Oct 2023 16:44:36 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: t.kitynski@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Suggestion for deprecated spellings
Message-ID: <ZSW3tKL_-shcBkCm@momjian.us>
References: <167473556945.2667294.2003897901995802549@wrigleys.postgresql.org>
 <Y9grBFU+2DBXBB7z@momjian.us>
 <888259.1675112866@sss.pgh.pa.us>
 <Y9gz2rRpm6VKnC0M@momjian.us>
 <ZRTGMpPpFCFbdSsM@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <ZRTGMpPpFCFbdSsM@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/ZSW3tKL_-shcBkCm%40momjian.us>
Precedence: bulk

On Wed, Sep 27, 2023 at 08:17:54PM -0400, Bruce Momjian wrote:
> On Mon, Jan 30, 2023 at 04:17:14PM -0500, Bruce Momjian wrote:
> > On Mon, Jan 30, 2023 at 04:07:46PM -0500, Tom Lane wrote:
> > > 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.
> > 
> > Yeah, I remember that with COPY.  t.kitynski@gmail.com, please us that
> > as a guide.  Thanks.
> 
> I developed the attached patch to move the deprecated clauses to the
> bottom.

Applied to master.  I didn't want to backpatch a command syntax
adjustment like this.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.