Re: Simplify COMMENT and SECURITY LABEL documentation

2021-06-05 Thread Peter Eisentraut
On 02.06.21 21:32, Alvaro Herrera wrote: On 2021-Jun-02, Peter Eisentraut wrote: 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

Re: Simplify COMMENT and SECURITY LABEL documentation

2021-06-02 Thread Alvaro Herrera
On 2021-Jun-02, Peter Eisentraut wrote: > 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 impro

Re: Simplify COMMENT and SECURITY LABEL documentation

2021-06-02 Thread Tom Lane
Peter Eisentraut writes: > On 01.06.21 17:56, Alvaro Herrera wrote: >> The glossary uses "reside in". > I like that. > I think "belong to" is a stronger relationship, like a column belongs to > a table. Kind of like DEPENDENCY_INTERNAL vs. DEPENDENCY_NORMAL. Hmm, okay. I can support "reside

Re: Simplify COMMENT and SECURITY LABEL documentation

2021-06-02 Thread Peter Eisentraut
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

Re: Simplify COMMENT and SECURITY LABEL documentation

2021-06-01 Thread Tom Lane
Alvaro Herrera writes: > On 2021-Jun-01, Tom Lane 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 "resid

Re: Simplify COMMENT and SECURITY LABEL documentation

2021-06-01 Thread Alvaro Herrera
On 2021-Jun-01, Tom Lane wrote: > Peter Eisentraut 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,

Re: Simplify COMMENT and SECURITY LABEL documentation

2021-06-01 Thread Tom Lane
Peter Eisentraut 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 informa

Simplify COMMENT and SECURITY LABEL documentation

2021-05-31 Thread Peter Eisentraut
there is any doubt. Patch attached. Thoughts? From d5072256b1faabe516eb58990d6f89fa1a3bdd9f Mon Sep 17 00:00:00 2001 From: Peter Eisentraut Date: Tue, 1 Jun 2021 08:50:40 +0200 Subject: [PATCH] doc: Simplify COMMENT and SECURITY LABEL documentation Just say that objects that live in schemas can be