Content-Type: multipart/alternative;
 boundary="------------zsdyEdJtrJYV0S6fS7iPhyQD"
Message-ID: <d0f46297-56e6-cf73-8b59-a7b23d675670@gmail.com>
Date: Mon, 30 Jan 2023 21:52:15 +0100
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.4.2
Subject: Re: Suggestion for deprecated spellings
Content-Language: pl-PL, en-US
To: Bruce Momjian <bruce@momjian.us>, pgsql-docs@lists.postgresql.org
References: <167473556945.2667294.2003897901995802549@wrigleys.postgresql.org>
 <Y9grBFU+2DBXBB7z@momjian.us>
From: =?UTF-8?Q?Tomis=c5=82aw_Kity=c5=84ski?= <t.kitynski@gmail.com>
In-Reply-To: <Y9grBFU+2DBXBB7z@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/d0f46297-56e6-cf73-8b59-a7b23d675670%40gmail.com>
Precedence: bulk

This is a multi-part message in MIME format.
--------------zsdyEdJtrJYV0S6fS7iPhyQD
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

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

--------------zsdyEdJtrJYV0S6fS7iPhyQD
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 8bit

<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body text="#cccccc" bgcolor="#2f2f2f">
    <div class="moz-cite-prefix">W dniu 30.01.2023 o 21:39, Bruce
      Momjian pisze:<br>
    </div>
    <blockquote type="cite" cite="mid:Y9grBFU+2DBXBB7z@momjian.us">
      <pre class="moz-quote-pre" wrap="">On Thu, Jan 26, 2023 at 12:19:29PM +0000, PG Doc comments form wrote:
</pre>
      <blockquote type="cite">
        <pre class="moz-quote-pre" wrap="">The following documentation comment has been logged on the website:

Page: <a class="moz-txt-link-freetext" href="https://www.postgresql.org/docs/12/sql-createrole.html">https://www.postgresql.org/docs/12/sql-createrole.html</a>
Description: