Subject: Re: Add A Glossary
To: pgsql-docs@lists.postgresql.org
References: <20200619171037.GA14536@alvherre.pgsql>
From: =?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de>
Message-ID: <95f90a5d-7692-701d-2c0c-0c88eb5cea7d@purtz.de>
Date: Tue, 21 Jul 2020 13:47:10 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
 Thunderbird/68.10.0
MIME-Version: 1.0
In-Reply-To: <20200619171037.GA14536@alvherre.pgsql>
Content-Type: multipart/mixed;
 boundary="------------02C7FA5E35FFA24E3C1A4852"
Content-Language: en-US
Precedence: bulk

This is a multi-part message in MIME format.
--------------02C7FA5E35FFA24E3C1A4852
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit

On 19.06.20 19:10, Alvaro Herrera wrote:
> Thanks for these fixes!  I included all of these.
>
> On 2020-Jun-19, Erik Rijkers wrote:
>
>> And one thing that I am not sure of (but strikes me as a bit odd):
>> there are several cases of
>> 'are enforced unique'. Should that not be
>> 'are enforced to be unique'  ?
> I included this change too; I am not too sure of it myself.  If some
> English language neatnik wants to argue one way or the other, be my
> guest.
>
- Added '(process)' to the two terms 'Autovacuum' and 'Stats Collector'

- Removed link to himself in 'Logger (process)'

- new term: Base Backup


--

Jürgen Purtz


--------------02C7FA5E35FFA24E3C1A4852
Content-Type: text/x-patch; charset=UTF-8;
 name="0005-glossary.patch"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="0005-glossary.patch"

diff --git a/doc/src/sgml/glossary.sgml b/doc/src/sgml/glossary.sgml
index 76525c6302..58e5071642 100644
--- a/doc/src/sgml/glossary.sgml
+++ b/doc/src/sgml/glossary.sgml
@@ -108,7 +108,7 @@
   </glossentry>
 
   <glossentry id="glossary-autovacuum">
-   <glossterm>Autovacuum</glossterm>
+   <glossterm>Autovacuum (process)</glossterm>
    <glossdef>
     <para>
      A set of background processes that routinely perform
@@ -178,6 +178,19 @@
    </glossdef>
   </glossentry>
 
+  <glossentry id="glossary-basebackup">
+   <glossterm>Base Backup</glossterm>
+   <glossdef>
+    <para>
+     A binary copy of all
+     <glossterm linkend="glossary-db-cluster">database cluster</glossterm>
+     files. It is generated by the tool <xref linkend="app-pgbasebackup"/>.  
+     In combination with WAL files it can be used as the starting point
+     for recovery, log shipping, or streaming replication.
+    </para>
+   </glossdef>
+  </glossentry>
+
   <glossentry id="glossary-bloat">
    <glossterm>Bloat</glossterm>
    <glossdef>
@@ -855,8 +868,7 @@
    <glossterm>Logger (process)</glossterm>
    <glossdef>
     <para>
-     If activated, the
-     <glossterm linkend="glossary-logger">Logger</glossterm> process
+     If activated, the process
      writes information about database events into the current
      <glossterm linkend="glossary-log-file">log file</glossterm>.
      When reaching certain time- or
@@ -1486,7 +1498,7 @@
   </glossentry>
 
   <glossentry id="glossary-stats-collector">
-   <glossterm>Stats collector</glossterm>
+   <glossterm>Stats collector (process)</glossterm>
    <glossdef>
     <para>
      This process collects statistical information about the

--------------02C7FA5E35FFA24E3C1A4852--