Re: Suggestion for deprecated spellings

W dniu 30.01.2023 o 21:39, Bruce Momjian pisze:
> On Thu, Jan 26, 2023 at 12:19:29PM +0000, PG Doc comments form wrote:
>> The following documentation comment has been logged on the website:
>>
>> Page:https://www.postgresql.org/docs/12/sql-createrole.html
>> Description:
>>
>> 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. For instance
>> see `CREATE ROLE` with deprecated spellings like `IN GROUP` or `USER`. I
>> guess it would be useful to see those spellings visually marked as
>> deprecated in Synopsis section (with e.g. strike-through or whatever suits
>> better). Otherwise, when consulting documentation, it often requires jumping
>> from the synopsis to detailed description and back to check if given
>> spelling is still applicable. Just a thought. :-)
> We don't need to show all _supported_ syntaxes in the "Synopsis"
> section, so we could just remove them.
>
I like this idea even more! :-) Much cleaner approach . And then those
obsolete aliases could be simply mentioned in the text for backward
compatibility. Big yes! :-)

--
Greetings, TK