]> 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:35 +0000 (14:46 +0900)
commit228addbbf2c13f8cc8f80bb6f0aa5bd7204e65e5
tree6d5e58011935aea2f05d95b3ede41188984b8696
parent28c2b789652a8df0999d5dbfefa2482dafdcaaa1
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