agora inbox for pgsql-docs@postgresql.org
help / color / mirror / Atom feedFrom: Fujii Masao <masao.fujii@oss.nttdata.com>
To: pgsql-docs@lists.postgresql.org
Subject: Remove unnecessary secondary index terms for replication settings
Date: Wed, 23 Apr 2025 15:53:54 +0900
Message-ID: <e825e7a7-4877-441d-93c1-25377db36c31@oss.nttdata.com> (raw)
Hi,
In config.sgml, the entries for max_replication_slots and
max_active_replication_origins include secondary index terms:
<primary><varname>max_replication_slots</varname> configuration parameter</primary>
<secondary>in a sending server</secondary>
<primary><varname>max_active_replication_origins</varname> configuration parameter</primary>
<secondary>in a subscriber</secondary>
These secondary terms don't seem necessary anymore, since each parameter
now has only one index entry. Removing them would simplify the documentation.
Originally, the secondary entries made sense because
max_active_replication_origins was part of max_replication_slots,
so both needed separate index entries. But commit 04ff636cbce
split them into distinct parameters.
Patch attached.
Regards,
--
Fujii Masao
Advanced Computing Technology Center
Research and Development Headquarters
NTT DATA CORPORATION
From fada9d65dd5c177e43179bcd5cc2e57d36b5d831 Mon Sep 17 00:00:00 2001
From: Fujii Masao <fujii@postgresql.org>
Date: Wed, 23 Apr 2025 15:25:42 +0900
Subject: [PATCH v1] doc: remove unnecessary secondary index terms for
replication settings.
Previously, config.sgml included secondary index terms for
max_replication_slots and max_active_replication_origins. These are
no longer necessary, as each parameter now has a single distinct index entry.
The secondary terms were originally useful because
max_active_replication_origins was part of max_replication_slots,
and separate index entries helped users locate each setting. However,
commit 04ff636cbce split them into independent parameters,
making the secondary terms redundant.
This commit removes the unnecessary secondary index entries to
simplify the documentation.
---
doc/src/sgml/config.sgml | 2 --
1 file changed, 2 deletions(-)
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index c1674c22cb2..bd48a3ba139 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -4511,7 +4511,6 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<term><varname>max_replication_slots</varname> (<type>integer</type>)
<indexterm>
<primary><varname>max_replication_slots</varname> configuration parameter</primary>
- <secondary>in a sending server</secondary>
</indexterm>
</term>
<listitem>
@@ -5282,7 +5281,6 @@ ANY <replaceable class="parameter">num_sync</replaceable> ( <replaceable class="
<term><varname>max_active_replication_origins</varname> (<type>integer</type>)
<indexterm>
<primary><varname>max_active_replication_origins</varname> configuration parameter</primary>
- <secondary>in a subscriber</secondary>
</indexterm>
</term>
<listitem>
--
2.49.0
Attachments:
[text/plain] v1-0001-doc-remove-unnecessary-secondary-index-terms-for-.patch (1.8K, ../e825e7a7-4877-441d-93c1-25377db36c31@oss.nttdata.com/2-v1-0001-doc-remove-unnecessary-secondary-index-terms-for-.patch)
download | inline diff:
From fada9d65dd5c177e43179bcd5cc2e57d36b5d831 Mon Sep 17 00:00:00 2001
From: Fujii Masao <fujii@postgresql.org>
Date: Wed, 23 Apr 2025 15:25:42 +0900
Subject: [PATCH v1] doc: remove unnecessary secondary index terms for
replication settings.
Previously, config.sgml included secondary index terms for
max_replication_slots and max_active_replication_origins. These are
no longer necessary, as each parameter now has a single distinct index entry.
The secondary terms were originally useful because
max_active_replication_origins was part of max_replication_slots,
and separate index entries helped users locate each setting. However,
commit 04ff636cbce split them into independent parameters,
making the secondary terms redundant.
This commit removes the unnecessary secondary index entries to
simplify the documentation.
---
doc/src/sgml/config.sgml | 2 --
1 file changed, 2 deletions(-)
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index c1674c22cb2..bd48a3ba139 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -4511,7 +4511,6 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows
<term><varname>max_replication_slots</varname> (<type>integer</type>)
<indexterm>
<primary><varname>max_replication_slots</varname> configuration parameter</primary>
- <secondary>in a sending server</secondary>
</indexterm>
</term>
<listitem>
@@ -5282,7 +5281,6 @@ ANY <replaceable class="parameter">num_sync</replaceable> ( <replaceable class="
<term><varname>max_active_replication_origins</varname> (<type>integer</type>)
<indexterm>
<primary><varname>max_active_replication_origins</varname> configuration parameter</primary>
- <secondary>in a subscriber</secondary>
</indexterm>
</term>
<listitem>
--
2.49.0
view thread (4+ messages) latest in thread
Message-ID: <e825e7a7-4877-441d-93c1-25377db36c31@oss.nttdata.com>
Permalink: ../e825e7a7-4877-441d-93c1-25377db36c31@oss.nttdata.com/
Also on: postgresql.org/message-id/e825e7a7-4877-441d-93c1-25377db36c31@oss.nttdata.com
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: pgsql-docs@postgresql.org
Cc: masao.fujii@oss.nttdata.com, pgsql-docs@lists.postgresql.org
Subject: Re: Remove unnecessary secondary index terms for replication settings
In-Reply-To: <e825e7a7-4877-441d-93c1-25377db36c31@oss.nttdata.com>
* 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