Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1lo4p8-0001TX-9s
	for pgsql-docs@arkaria.postgresql.org; Tue, 01 Jun 2021 13:52:50 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1lo4p6-00083T-6L
	for pgsql-docs@arkaria.postgresql.org; Tue, 01 Jun 2021 13:52:48 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1lo4p5-00083J-UU
	for pgsql-docs@lists.postgresql.org; Tue, 01 Jun 2021 13:52:47 +0000
Received: from sss.pgh.pa.us ([66.207.139.130])
	by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <tgl@sss.pgh.pa.us>)
	id 1lo4p3-0006e4-3j
	for pgsql-docs@postgresql.org; Tue, 01 Jun 2021 13:52:46 +0000
Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1])
	by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 151Dqg5s2762112;
	Tue, 1 Jun 2021 09:52:43 -0400
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Simplify COMMENT and SECURITY LABEL documentation
In-reply-to: <b2ec2234-67fe-d861-5cea-f526cd18c086@enterprisedb.com>
References: <b2ec2234-67fe-d861-5cea-f526cd18c086@enterprisedb.com>
Comments: In-reply-to Peter Eisentraut <peter.eisentraut@enterprisedb.com>
	message dated "Tue, 01 Jun 2021 08:58:26 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <2762110.1622555562.1@sss.pgh.pa.us>
Date: Tue, 01 Jun 2021 09:52:42 -0400
Message-ID: <2762111.1622555562@sss.pgh.pa.us>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/2762111.1622555562%40sss.pgh.pa.us>
Precedence: bulk

Peter Eisentraut <peter.eisentraut@enterprisedb.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