Re: Simplify COMMENT and SECURITY LABEL documentation

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Simplify COMMENT and SECURITY LABEL documentation
Date: 2021-06-01 13:52:42
Message-ID: 2762111.1622555562@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com> writes:
> ... 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.

+1 for the concept, but I feel that "live in" is a bit too informal
for this context. I'm too caffeine-deprived to instantly come up
with le mot juste; but perhaps "exist within" would be an improvement?

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2021-06-01 15:56:09 Re: Simplify COMMENT and SECURITY LABEL documentation
Previous Message PG Doc comments form 2021-06-01 08:49:55 pg_prewarm