pgsql: Doc: improve description of allowed spellings for Booleaninput.

Поиск
Список
Период
Сортировка
От Tom Lane
Тема pgsql: Doc: improve description of allowed spellings for Booleaninput.
Дата
Msg-id E1hbFtc-00041d-TF@gemulon.postgresql.org
обсуждение исходный текст
Список pgsql-committers
Doc: improve description of allowed spellings for Boolean input.

datatype.sgml failed to explain that boolin() accepts any unique
prefix of the basic input strings.  Indeed it was actively misleading
because it called out a few minimal prefixes without mentioning that
there were more valid inputs.

I also felt that it wasn't doing anybody any favors by conflating
SQL key words, valid Boolean input, and string literals containing
valid Boolean input.  Rewrite in hopes of reducing the confusion.

Per bug #15836 from Yuming Wang, as diagnosed by David Johnston.
Back-patch to supported branches.

Discussion: https://postgr.es/m/15836-656fab055735f511@postgresql.org

Branch
------
REL_11_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/afaa32daf293163cb9612bdb20a04a5fcb26309d

Modified Files
--------------
doc/src/sgml/datatype.sgml | 66 ++++++++++++++++++++++++++++++----------------
1 file changed, 43 insertions(+), 23 deletions(-)


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

Предыдущее
От: Bruce Momjian
Дата:
Сообщение: pgsql: docs: PG 12 relnotes, update btree items
Следующее
От: Tom Lane
Дата:
Сообщение: pgsql: Doc: fix bogus example.