Subject: Re: Simplify COMMENT and SECURITY LABEL documentation
To: Alvaro Herrera <alvherre@alvh.no-ip.org>, Tom Lane <tgl@sss.pgh.pa.us>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
References: <202106011556.au3hmtylr7cn@alvherre.pgsql>
From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
Message-ID: <d015a28c-0e0b-a8d0-c2cc-5a56f9703332@enterprisedb.com>
Date: Wed, 2 Jun 2021 17:05:10 +0200
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0)
 Gecko/20100101 Thunderbird/78.10.2
MIME-Version: 1.0
In-Reply-To: <202106011556.au3hmtylr7cn@alvherre.pgsql>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Archived-At: 
 <https://www.postgresql.org/message-id/d015a28c-0e0b-a8d0-c2cc-5a56f9703332%40enterprisedb.com>
Precedence: bulk

On 01.06.21 17:56, Alvaro Herrera wrote:
>> +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?
> 
> The glossary uses "reside in".

I like that.

> I suppose that we should either use the same term that the glossary
> uses, or alternatively fix the glossary to use whatever term we decide
> to use here.
> 
> I do notice now that I used the term "belong to" elsewhere in the
> glossary.  That could use some cleanup.

I think "belong to" is a stronger relationship, like a column belongs to 
a table.  Kind of like DEPENDENCY_INTERNAL vs. DEPENDENCY_NORMAL.