Re: Suggestion for deprecated spellings

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(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.

I developed the attached patch to move the deprecated clauses to the
bottom.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Only you can decide what is important to you.