Re: Simplify COMMENT and SECURITY LABEL documentation

Peter Eisentraut <peter.eisentraut@enterprisedb.com>

From: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
To: Alvaro Herrera <alvherre@alvh.no-ip.org>, Tom Lane <tgl@sss.pgh.pa.us>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Date: 2021-06-02T15:05:10Z
Lists: pgsql-docs
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.



Commits

  1. doc: Simplify COMMENT and SECURITY LABEL documentation

  2. doc: Make terminology in glossary consistent