Clarify which relkinds accept column comments.

Per discussion with Josh Kupershmidt.

diff --git a/doc/src/sgml/ref/comment.sgml b/doc/src/sgml/ref/comment.sgml
index 53c6b0fcbc9db09692a58d4f81cc675b085ac237..838f43fcbd59a8e4537cec57f5abb503febf6fac 100644 (file)
--- 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.