Simplify COMMENT and SECURITY LABEL documentation - Mailing list pgsql-docs

From Peter Eisentraut
Subject Simplify COMMENT and SECURITY LABEL documentation
Date
Msg-id b2ec2234-67fe-d861-5cea-f526cd18c086@enterprisedb.com
Whole thread Raw
Responses Re: Simplify COMMENT and SECURITY LABEL documentation  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
The COMMENT ref page says (and SECURITY LABEL similarly):

     The name of the object to be commented.  Names of tables,
     aggregates, collations, ..., and views can be schema-qualified.

and it lists all such possible object types.  I find this tedious to 
read.  (And there are omissions.  For example materialized views are not 
listed.)  I wonder if it would be more practical to just write:

     The name of the object to be commented.  Names of objects that live
     in schemas (tables, functions, etc.) can be schema-qualified.

There are also examples at the end that cover this if there is any doubt.

Patch attached.  Thoughts?

Attachment

pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Vacuum full and reindex
Next
From: PG Doc comments form
Date:
Subject: pg_prewarm