Feedback-ID: i131946ab:Fastmail
Message-ID: <cfdc61c0-206e-3aa4-6fd4-d89fad3d35d4@enterprisedb.com>
Date: Wed, 19 Apr 2023 10:52:06 +0200
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0)
 Gecko/20100101 Thunderbird/102.10.0
Subject: Re: Should we put command options in alphabetical order in the doc?
To: Peter Geoghegan <pg@bowt.ie>, David Rowley <dgrowleyml@gmail.com>
Cc: PostgreSQL Developers <pgsql-hackers@lists.postgresql.org>
References: <CAApHDvo1eWbt5PVpk0G=yCbBNgLU7KaRP6dCBHpNbFaBjyGyQA@mail.gmail.com>
 <CAH2-WzncduQWPfxn+1-S6k9JdwNoyDRJKxJoA_60iZNw82c+sA@mail.gmail.com>
 <CAApHDvphkraLb+s2g=-R=VswPR+ZL7dc9tj7zv=nH7dvvXcE1A@mail.gmail.com>
 <CAH2-WzkzxyGCLBYR8f9mGNdbR8HZuXX2_79G85=1NwHEeNLcvg@mail.gmail.com>
Content-Language: en-US
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
In-Reply-To: <CAH2-WzkzxyGCLBYR8f9mGNdbR8HZuXX2_79G85=1NwHEeNLcvg@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Archived-At: <https://www.postgresql.org/message-id/cfdc61c0-206e-3aa4-6fd4-d89fad3d35d4%40enterprisedb.com>
Precedence: bulk

On 19.04.23 01:30, Peter Geoghegan wrote:
>> I'd be interested to know if you could tell me if SKIP_LOCKED has more
>> importance than INDEX_CLEANUP, for example. If you can, it would seem
>> like trying to say apples are more important than oranges, or
>> vice-versa.
> 
> I don't accept your premise that the only thing that matters (or the
> most important thing) is adherence to some unambiguous and consistent
> order.

My thinking is, if I want to look up FREEZE on the VACUUM man page, I 
would welcome some easily identifiable way of locating it.  At that 
point, I don't know whether FREEZE is important or what kind of option 
it is.  For reference material, easy lookup should be a priority.  For a 
narrative chapter on VACUUM, you can introduce the options in any other 
suitable order.