diff --git a/doc/src/sgml/ref/comment.sgml b/doc/src/sgml/ref/comment.sgml
index 53c6b0fcbc9..838f43fcbd5 100644
--- a/doc/src/sgml/ref/comment.sgml
+++ b/doc/src/sgml/ref/comment.sgml
@@ -24,9 +24,9 @@ PostgreSQL documentation
COMMENT ON
{
TABLE object_name |
- COLUMN table_name.column_name |
AGGREGATE agg_name (agg_type [, ...] ) |
CAST (source_type AS target_type) |
+ COLUMN relation_name.column_name |
CONSTRAINT constraint_name ON table_name |
CONVERSION object_name |
DATABASE object_name |
@@ -86,7 +86,7 @@ COMMENT ON
object_name
- table_name.column_name
+ relation_name.column_name
agg_name
constraint_name
function_name
@@ -99,6 +99,9 @@ COMMENT ON
aggregates, domains, functions, indexes, operators, operator classes,
operator families, sequences, text search objects, types, and views can
be schema-qualified.
+ When commenting on a column,
+ relation_name must refer
+ to a table, view, or composite types.