Date: Wed, 2 Jun 2021 15:32:36 -0400
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Peter Eisentraut <peter.eisentraut@enterprisedb.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: Simplify COMMENT and SECURITY LABEL documentation
Message-ID: <202106021932.idmbjjaqk7ke@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="eyr736ilunmiuq6q"
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <d015a28c-0e0b-a8d0-c2cc-5a56f9703332@enterprisedb.com>
Archived-At: 
 <https://www.postgresql.org/message-id/202106021932.idmbjjaqk7ke%40alvherre.pgsql>
Precedence: bulk


--eyr736ilunmiuq6q
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit

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 improvement?
> > 
> > The glossary uses "reside in".
> 
> I like that.

So I would adjust the glossary as in the attached patch.

-- 
Álvaro Herrera       Valdivia, Chile
"Ed is the standard text editor."
      http://groups.google.com/group/alt.religion.emacs/msg/8d94ddab6a9b0ad3

--eyr736ilunmiuq6q
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="reside.patch"

diff --git a/doc/src/sgml/glossary.sgml b/doc/src/sgml/glossary.sgml
index 41f3e5ee86..c8d0440e80 100644
--- a/doc/src/sgml/glossary.sgml
+++ b/doc/src/sgml/glossary.sgml
@@ -1448,7 +1448,7 @@
       known as <firstterm>local objects</firstterm>.
      </para>
      <para>
-      Most local objects belong to a specific
+      Most local objects reside in a specific
       <glossterm linkend="glossary-schema">schema</glossterm> in their
       containing database, such as
       <glossterm linkend="glossary-relation">relations</glossterm> (all types),
@@ -1458,7 +1458,7 @@
       are enforced to be unique.
      </para>
      <para>
-      There also exist local objects that do not belong to schemas; some examples are
+      There also exist local objects that do not reside in schemas; some examples are
       <glossterm linkend="glossary-extension">extensions</glossterm>,
       <glossterm linkend="glossary-cast">data type casts</glossterm>, and
       <glossterm linkend="glossary-foreign-data-wrapper">foreign data wrappers</glossterm>.

--eyr736ilunmiuq6q--