public inbox for [email protected]
help / color / mirror / Atom feedFrom: Justin Pryzby <[email protected]>
To: Alvaro Herrera <[email protected]>
Cc: Jürgen Purtz <[email protected]>
Cc: Erik Rijkers <[email protected]>
Cc: Laurenz Albe <[email protected]>
Cc: Fabien COELHO <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: Corey Huinker <[email protected]>
Cc: Roger Harkavy <[email protected]>
Cc: [email protected]
Cc: Michael Paquier <[email protected]>
Cc: Pg Docs <[email protected]>
Subject: Re: Add A Glossary
Date: Tue, 16 Jun 2020 19:33:49 -0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
<[email protected]>
On Tue, Jun 16, 2020 at 08:09:26PM -0400, Alvaro Herrera wrote:
> diff --git a/doc/src/sgml/glossary.sgml b/doc/src/sgml/glossary.sgml
> index 25b03f3b37..e29b55e5ac 100644
> --- a/doc/src/sgml/glossary.sgml
> +++ b/doc/src/sgml/glossary.sgml
> @@ -395,15 +395,15 @@
> <para>
> The base directory on the filesystem of a
> <glossterm linkend="glossary-server">server</glossterm> that contains all
> - data files and subdirectories associated with an
> - <glossterm linkend="glossary-instance">instance</glossterm> (with the
> - exception of <glossterm linkend="glossary-tablespace">tablespaces</glossterm>).
> + data files and subdirectories associated with a
> + <glossterm linkend="glossary-db-cluster">database cluster</glossterm>
> + (with the exception of
> + <glossterm linkend="glossary-tablespace">tablespaces</glossterm>).
and (optionally) WAL
> + <glossentry id="glossary-db-cluster">
> + <glossterm>Database cluster</glossterm>
> + <glossdef>
> + <para>
> + A collection of databases and global SQL objects,
> + and their common static and dynamic meta-data.
metadata
> @@ -1245,12 +1255,17 @@
> <glossterm linkend="glossary-sql-object">SQL objects</glossterm>,
> which all reside in the same
> <glossterm linkend="glossary-database">database</glossterm>.
> - Each SQL object must reside in exactly one schema.
> + Each SQL object must reside in exactly one schema
> + (though certain types of SQL objects exist outside schemas).
(except for global objects which ..)
> <para>
> The names of SQL objects of the same type in the same schema are enforced
> to be unique.
> There is no restriction on reusing a name in multiple schemas.
> + For local objects that exist outside schemas, their names are enforced
> + unique across the whole database. For global objects, their names
I would say "unique within the database"
> + are enforced unique across the whole
> + <glossterm linkend="glossary-db-cluster">database cluster</glossterm>.
and "unique within the whole db cluster"
> Most local objects belong to a specific
> - <glossterm linkend="glossary-schema">schema</glossterm> in their containing database.
> + <glossterm linkend="glossary-schema">schema</glossterm> in their
> + containing database, such as
> + <glossterm linkend="glossary-relation">all types of relations</glossterm>,
> + <glossterm linkend="glossary-function">all types of functions</glossterm>,
Maybe say: >Relations< (all types), and >Functions< (all types)
> used as the default one for all SQL objects, called <literal>pg_default</literal>.
"the default" (remove "one")
--
Justin
view thread (97+ messages) latest in thread
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
Subject: Re: Add A Glossary
In-Reply-To: <[email protected]>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox