pgsql: doc: Clarify that empty COMMENT string removes the comment.

Поиск
Список
Период
Сортировка
От Fujii Masao
Тема pgsql: doc: Clarify that empty COMMENT string removes the comment.
Дата
Msg-id E1vxIe7-0027Ts-2T@gemulon.postgresql.org
обсуждение исходный текст
Список pgsql-committers
doc: Clarify that empty COMMENT string removes the comment.

Clarify the documentation of COMMENT ON to state that specifying an empty
string is treated as NULL, meaning that the comment is removed.

This makes the behavior explicit and avoids possible confusion about how
empty strings are handled.

Also adds regress test cases that use empty string to remove a comment.

Backpatch to all supported versions.

Author: Chao Li <lic@highgo.com>
Reviewed-by: Ashutosh Bapat <ashutosh.bapat.oss@gmail.com>
Reviewed-by: David G. Johnston <david.g.johnston@gmail.com>
Reviewed-by: Shengbin Zhao <zshengbin91@gmail.com>
Reviewed-by: Jim Jones <jim.jones@uni-muenster.de>
Reviewed-by: zhangqiang <zhang_qiang81@163.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/26476097-B1C1-4BA8-AA92-0AD0B8EC7190@gmail.com
Backpatch-through: 14

Branch
------
REL_14_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/7ab6ac1d7f50eb4a36280cbbee3be68bc19d28ca

Modified Files
--------------
doc/src/sgml/ref/comment.sgml              | 18 +++++++++++-------
src/test/regress/expected/create_index.out | 14 ++++++++++++++
src/test/regress/sql/create_index.sql      |  4 ++++
3 files changed, 29 insertions(+), 7 deletions(-)


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