Re: Suggestion for deprecated spellings - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Suggestion for deprecated spellings
Date
Msg-id Y9gz2rRpm6VKnC0M@momjian.us
Whole thread Raw
In response to Re: Suggestion for deprecated spellings  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Suggestion for deprecated spellings  (Bruce Momjian <bruce@momjian.us>)
List pgsql-docs
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.

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

Embrace your flaws.  They make you human, rather than perfect,
which you will never be.



pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Suggestion for deprecated spellings
Next
From: PG Doc comments form
Date:
Subject: 1.3 Creating a database - windows 10x64