Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1jL0r8-0000da-0h
	for pgsql-hackers@arkaria.postgresql.org; Sun, 05 Apr 2020 08:42:14 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-hackers-owner+archive@lists.postgresql.org>)
	id 1jL0r6-0006l5-MX
	for pgsql-hackers@arkaria.postgresql.org; Sun, 05 Apr 2020 08:42:12 +0000
Received: from makus.postgresql.org ([2001:4800:3e1:1::229])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <juergen@purtz.de>)
	id 1jL0r6-0006ky-FU
	for pgsql-hackers@lists.postgresql.org; Sun, 05 Apr 2020 08:42:12 +0000
Received: from mout.kundenserver.de ([217.72.192.73])
	by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
	(Exim 4.92)
	(envelope-from <juergen@purtz.de>)
	id 1jL0qz-0006Mq-RM
	for pgsql-hackers@postgresql.org; Sun, 05 Apr 2020 08:42:11 +0000
Received: from [192.168.178.43] ([77.180.15.42]) by mrelayeu.kundenserver.de
 (mreue107 [212.227.15.145]) with ESMTPSA (Nemesis) id
 1MIcqp-1jZ3cc2OKD-00EcFd; Sun, 05 Apr 2020 10:41:47 +0200
Subject: Re: Add A Glossary
To: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: Erik Rijkers <er@xs4all.nl>, Justin Pryzby <pryzby@telsasoft.com>,
 Corey Huinker <corey.huinker@gmail.com>,
 Roger Harkavy <rogerharkavy@gmail.com>, pgsql-hackers@postgresql.org,
 Fabien COELHO <coelho@cri.ensmp.fr>, Michael Paquier <michael@paquier.xyz>
References: <20200403205143.GA7961@alvherre.pgsql>
From: =?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de>
Message-ID: <79036db2-147d-bd9d-6fd2-587ccb2c5ea4@purtz.de>
Date: Sun, 5 Apr 2020 10:41:44 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101
 Thunderbird/68.4.1
MIME-Version: 1.0
In-Reply-To: <20200403205143.GA7961@alvherre.pgsql>
Content-Type: multipart/mixed;
 boundary="------------78C6E5177569DC64D48F5227"
Content-Language: en-US
X-Provags-ID: V03:K1:E1KtZ19GH5U18XL/AWyjt0FB6wF7u7MDHA0Kt7F1V8beOPXmRXI
 JgUd+fFLroOWrD3j1IIhlpvSb1aSOp4Yc+848gfRlaeeb5FcIyvVJqM08z6wK5TejnBl+m6
 htz0RADI4hFaNlDPWS0lCDeT0Oqp0KuHJdRs2V5hvX8+1GVxWajwvj33NlES7whQFKBB3yw
 FgCEvq7knWO/DqqqI3gRw==
X-Spam-Flag: NO
X-UI-Out-Filterresults: notjunk:1;V03:K0:8q4z1QV8gAU=:LWpYOkkNsMArdHTA+CNlk0
 HIvBCh9Nra9GRyznLlzs65CCuwFrNTofrESZkhDSZD8eSldKGvkQ8Z+6m7qFLdH8oqH/vY58L
 YqdN25Hlc9aDxTLYCmjoJXhBxdIxGA1p+n/jgUyDE1/GkozzACBb8Its9MD7++ZvrIdCQkaNE
 hl9RQ8Qg61L+19/syb2ckZD2ZgdCL599x8seyTQFXdQMF9U1T9Dsf3M6NR854PvqDGDBy52nB
 T3Z6DBB3T/oz28vVz3QiNkQ/a+cxvSTTQmuTxflj47hasaHCRQTXZHpjVLfcGq0TNMbSAXbMo
 iPg3bdn0z//jMELLB7n1nNj0j+DgTlSslGfzdJCDEKDcULife+Rn+nmdqG18y5725QAjv+kra
 OvilW8H1VanXuDxCgQ4TFFTJUJM5CxxTNK9oPHNGV21xBL/kLP6ez0eJRZ9ybzNsTLMzDOXv3
 Y2CIKB2yc2xQHpewqFZGmtTSXTA3B/EOnFuEVbYJmxo/xujKiqL6S0iuxqiguJEihLVs4eRaN
 1WPTfACKaFGfQ1jRlKoQ6c41eNU5wR4eGSTq3DDTmZkHxPR8svN+Sg8iS6tKQUKcDmc4Ii5aI
 wSMbkS+d+0yGExw9lSDkAxugixz+EAF58rOKy3xbPOGCdOSTiu5CQWdQAJblPKCgqTHNde/qe
 4MECYvxdLKR0XRqGepMnoMQUGouiAJgXrPgi5+b5eD9uDcbU/ydPnDyKtcbPse6/x/xkoUeX5
 Y0jY/SjdTQBTn6F2ADFTYUKDsYR7jxY8uz5LVJyZd8Oh79zE6r/vEzAXYK7U7AWXQ0nnpDxDE
 lzURe3JPprm4c8dPY3Sl/x+xUCHc+Q3jX/4VeTXXPSk3sjJyjrKplX+W4hJj4qM0PKrfKo/
List-Id: <pgsql-hackers.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-hackers@lists.postgresql.org>
List-Owner: <mailto:pgsql-hackers-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-hackers>
Precedence: bulk

This is a multi-part message in MIME format.
--------------78C6E5177569DC64D48F5227
Content-Type: text/plain; charset=windows-1252; format=flowed
Content-Transfer-Encoding: 8bit

a) Some rearrangements of the sequence of terms to meet alphabetical order.

b) <glossterm id="linkend-xxx">  --> <glossterm linkend="glossary-xxx">  
in two cases. Or should it be a <firstterm>?


Kind regards, Jürgen



--------------78C6E5177569DC64D48F5227
Content-Type: text/x-patch; charset=UTF-8;
 name="glossfixes-2.patch"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename="glossfixes-2.patch"

diff --git a/doc/src/sgml/glossary.sgml b/doc/src/sgml/glossary.sgml
index 8c6cb6e942..25762b7c3a 100644
--- a/doc/src/sgml/glossary.sgml
+++ b/doc/src/sgml/glossary.sgml
@@ -208,15 +208,6 @@
    </glossdef>
   </glossentry>
 
-  <glossentry id="glossary-checkpointer">
-   <glossterm>Checkpointer (process)</glossterm>
-   <glossdef>
-    <para>
-     A specialized process responsible for executing checkpoints.
-    </para>
-   </glossdef>
-  </glossentry>
-
   <glossentry id="glossary-checkpoint">
    <glossterm>Checkpoint</glossterm>
    <glossdef>
@@ -244,6 +235,15 @@
    </glossdef>
   </glossentry>
 
+  <glossentry id="glossary-checkpointer">
+   <glossterm>Checkpointer (process)</glossterm>
+   <glossdef>
+    <para>
+     A specialized process responsible for executing checkpoints.
+    </para>
+   </glossdef>
+  </glossentry>
+
   <glossentry>
    <glossterm>Class (archaic)</glossterm>
    <glosssee otherterm="glossary-relation" />
@@ -761,25 +761,6 @@
    </glossdef>
   </glossentry>
 
-  <glossentry id="glossary-logger">
-   <glossterm>Logger (process)</glossterm>
-   <glossdef>
-    <para>
-     If activated, the
-     <glossterm linkend="glossary-logger">Logger</glossterm> process
-     writes information about database events into the current
-     <glossterm linkend="glossary-log-file">log file</glossterm>.
-     When reaching certain time- or
-     volume-dependent criteria, a new log file is created.
-     Also called <firstterm>syslogger</firstterm>.
-    </para>
-    <para>
-     For more information, see
-     <xref linkend="runtime-config-logging"/>.
-    </para>
-   </glossdef>
-  </glossentry>
-
   <glossentry id="glossary-log-record">
    <glossterm>Log Record</glossterm>
     <glossdef>
@@ -803,6 +784,25 @@
    </glossdef>
   </glossentry>
 
+  <glossentry id="glossary-logger">
+   <glossterm>Logger (process)</glossterm>
+   <glossdef>
+    <para>
+     If activated, the
+     <glossterm linkend="glossary-logger">Logger</glossterm> process
+     writes information about database events into the current
+     <glossterm linkend="glossary-log-file">log file</glossterm>.
+     When reaching certain time- or
+     volume-dependent criteria, a new log file is created.
+     Also called <firstterm>syslogger</firstterm>.
+    </para>
+    <para>
+     For more information, see
+     <xref linkend="runtime-config-logging"/>.
+    </para>
+   </glossdef>
+  </glossentry>
+
   <glossentry>
    <glossterm>Master (server)</glossterm>
    <glosssee otherterm="glossary-primary-server" />
@@ -1651,6 +1651,11 @@
    </glossdef>
   </glossentry>
 
+  <glossentry>
+   <glossterm>WAL</glossterm>
+   <glosssee otherterm="glossary-wal" />
+  </glossentry>
+
   <glossentry id="glossary-wal-archiver">
    <glossterm>WAL Archiver (process)</glossterm>
    <glossdef>
@@ -1696,11 +1701,6 @@
    </glossdef>
   </glossentry>
 
-  <glossentry>
-   <glossterm>WAL</glossterm>
-   <glosssee otherterm="glossary-wal" />
-  </glossentry>
-
   <glossentry id="glossary-wal-record">
    <glossterm>WAL Record</glossterm>
    <glossdef>
@@ -1728,8 +1728,8 @@
   <glossdef>
    <para>
     A process that writes <glossterm linkend="glossary-wal-record">WAL records</glossterm>
-    from <glossterm id="linkend-shared-memory">shared memory</glossterm> to
-    <glossterm id="linkend-wal-file">WAL files</glossterm>.
+    from <glossterm linkend="glossary-shared-memory">shared memory</glossterm> to
+    <glossterm linkend="glossary-wal-file">WAL files</glossterm>.
    </para>
    <para>
     For more information, see

--------------78C6E5177569DC64D48F5227--