1
0
mirror of https://github.com/postgres/postgres.git synced 2025-04-24 10:47:04 +03:00

doc: New glossary entries

Add:

- "Restartpoint"
- "Log sequence number"

"LSN" was already listed in the Acronyms appendix, but it is more
suitable as a glossary entry, so move it there and have the acronyms
entry link into the glossary.

Also turn on DocBook parameter glossentry.show.acronym to show
acronyms for glossary entries, which is being used here.

Reviewed-by: Daniel Gustafsson <daniel@yesql.se>
Reviewed-by: Alvaro Herrera <alvherre@alvh.no-ip.org>
Discussion: https://www.postgresql.org/message-id/flat/60915312-62cd-9c94-0d94-556023ece45f%40enterprisedb.com
This commit is contained in:
Peter Eisentraut 2023-05-04 06:44:38 +02:00
parent a6e04b1d20
commit 919c486a27
3 changed files with 38 additions and 2 deletions

View File

@ -402,8 +402,7 @@
<term><acronym>LSN</acronym></term>
<listitem>
<para>
Log Sequence Number, see <link linkend="datatype-pg-lsn"><type>pg_lsn</type></link>
and <link linkend="wal-internals">WAL Internals</link>.
<glossterm linkend="glossary-log-sequence-number">Log Sequence Number</glossterm>
</para>
</listitem>
</varlistentry>

View File

@ -1039,6 +1039,28 @@
</glossdef>
</glossentry>
<glossentry id="glossary-log-sequence-number">
<glossterm>Log sequence number</glossterm>
<acronym>LSN</acronym>
<glossdef>
<para>
Byte offset into the <glossterm linkend="glossary-wal">WAL</glossterm>,
increasing monotonically with each new <glossterm
linkend="glossary-wal-record">WAL record</glossterm>.
</para>
<para>
For more information, see <link
linkend="datatype-pg-lsn"><type>pg_lsn</type></link> and <xref
linkend="wal-internals"/>.
</para>
</glossdef>
</glossentry>
<glossentry>
<glossterm>LSN</glossterm>
<glosssee otherterm="glossary-log-sequence-number"/>
</glossentry>
<glossentry>
<glossterm>Master (server)</glossterm>
<glosssee otherterm="glossary-primary-server" />
@ -1342,6 +1364,20 @@
</glossdef>
</glossentry>
<glossentry id="glossary-restartpoint">
<glossterm>Restartpoint</glossterm>
<glossdef>
<para>
A variant of a <glossterm
linkend="glossary-checkpoint">checkpoint</glossterm> performed on a
<glossterm linkend="glossary-replica">replica</glossterm>.
</para>
<para>
For more information, see <xref linkend="wal-configuration"/>.
</para>
</glossdef>
</glossentry>
<glossentry id="glossary-result-set">
<glossterm>Result set</glossterm>
<glossdef>

View File

@ -28,6 +28,7 @@
</xsl:param>
<xsl:param name="callout.graphics" select="'0'"></xsl:param>
<xsl:param name="glossentry.show.acronym">yes</xsl:param>
<xsl:param name="toc.section.depth">2</xsl:param>
<xsl:param name="linenumbering.extension" select="'0'"></xsl:param>
<xsl:param name="section.autolabel" select="1"></xsl:param>