Re: Should we put command options in alphabetical order in the doc?

Поиск
Список
Период
Сортировка
От David Rowley
Тема Re: Should we put command options in alphabetical order in the doc?
Дата
Msg-id CAApHDvphkraLb+s2g=-R=VswPR+ZL7dc9tj7zv=nH7dvvXcE1A@mail.gmail.com
обсуждение исходный текст
Ответ на Re: Should we put command options in alphabetical order in the doc?  (Peter Geoghegan <pg@bowt.ie>)
Ответы Re: Should we put command options in alphabetical order in the doc?  (Peter Geoghegan <pg@bowt.ie>)
Список pgsql-hackers
On Tue, 18 Apr 2023 at 18:53, Peter Geoghegan <pg@bowt.ie> wrote:
> Take the VACUUM command. Right now FULL, FREEZE, and VERBOSE all come
> first. Those options are approximately the most important options --
> especially VERBOSE. But your patch places VERBOSE dead last.

hmm, how can we verify that the options are kept in order of
importance? What guidance can we provide to developers adding options
about where they should slot in the new option to the docs?

"Importance order" just seems horribly subjective to me.  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.

David



В списке pgsql-hackers по дате отправления:

Предыдущее
От: Peter Geoghegan
Дата:
Сообщение: Enhanced rmgr desc routines test !has_image, not has_data
Следующее
От: Peter Geoghegan
Дата:
Сообщение: Re: Should we put command options in alphabetical order in the doc?