]> git.ipfire.org Git - thirdparty/postgresql.git/commit
doc: Clarify that empty COMMENT string removes the comment.
authorFujii Masao <fujii@postgresql.org>
Tue, 3 Mar 2026 05:45:52 +0000 (14:45 +0900)
committerFujii Masao <fujii@postgresql.org>
Tue, 3 Mar 2026 05:46:25 +0000 (14:46 +0900)
commit47ad672a76d30110254561960f1fe33e453cf8fe
tree54b82d5f15f64c97ee0e58dcc016a59c8bcbb9ae
parentbde9ad31515a92ce23c9b9e113f08a71ca0f7dd1
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
doc/src/sgml/ref/comment.sgml
src/test/regress/expected/create_index.out
src/test/regress/expected/create_role.out
src/test/regress/sql/create_index.sql
src/test/regress/sql/create_role.sql