MIME-Version: 1.0
From: Fujii Masao <masao.fujii@gmail.com>
Date: Fri, 23 Jan 2026 19:21:51 +0900
Message-ID: 
 <CAHGQGwE_LwgXgCrqd08OFteJqdERiF3noqOKu2vt7Kjk4vMiGg@mail.gmail.com>
Subject: Placement of synchronized_standby_slots description in config.sgml
To: pgsql-docs@lists.postgresql.org
Content-Type: multipart/mixed; boundary="0000000000004c8d7406490b876d"
Archived-At: 
 <https://www.postgresql.org/message-id/CAHGQGwE_LwgXgCrqd08OFteJqdERiF3noqOKu2vt7Kjk4vMiGg%40mail.gmail.com>
Precedence: bulk

--0000000000004c8d7406490b876d
Content-Type: text/plain; charset="UTF-8"

Hi,

synchronized_standby_slots is defined in guc_parameter.dat as part of
the REPLICATION_PRIMARY group and appears under the "Primary Server"
section in postgresql.conf.sample. However, in the documentation
its description is placed under the "Sending Servers" section.

Given this, it seems the description should also be under "Primary Server"
in the documentation. I've attached a patch that moves it there.

Alternatively, if synchronized_standby_slots is intended to be set also
on a standby in cascading replication setups, then the current documentation
placement may be correct, and instead guc_parameter.dat and
postgresql.conf.sample should be updated. My understanding, though,
is that this parameter is normally set only on the primary. Right?

Regards,

-- 
Fujii Masao

--0000000000004c8d7406490b876d
Content-Type: application/octet-stream;
	name="v1-0001-doc-Move-synchronized_standby_slots-to-Primary-Se.patch"
Content-Disposition: attachment;
	filename="v1-0001-doc-Move-synchronized_standby_slots-to-Primary-Se.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_mkqqe4jl0>
X-Attachment-Id: f_mkqqe4jl0

RnJvbSBhYzQyNTQwYzRhZGY4NzBhZmFiNjIwZWMwOWRmZDc2YjZhOGJiNWE5IE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiBGdWppaSBNYXNhbyA8ZnVqaWlAcG9zdGdyZXNxbC5vcmc+CkRh
dGU6IEZyaSwgMjMgSmFuIDIwMjYgMTY6NTE6MzEgKzA5MDAKU3ViamVjdDogW1BBVENIIHYxXSBk
b2M6IE1vdmUgc3luY2hyb25pemVkX3N0YW5kYnlfc2xvdHMgdG8gUHJpbWFyeSBTZXJ2ZXIKIHNl
Y3Rpb24uCgpzeW5jaHJvbml6ZWRfc3RhbmRieV9zbG90cyBpcyBkZWZpbmVkIGluIGd1Y19wYXJh
bWV0ZXIuZGF0IGFzIHBhcnQgb2YKdGhlIFJFUExJQ0FUSU9OX1BSSU1BUlkgZ3JvdXAgYW5kIGlz
IGxpc3RlZCB1bmRlciB0aGUgIlByaW1hcnkgU2VydmVyIgpzZWN0aW9uIGluIHBvc3RncmVzcWwu
Y29uZi5zYW1wbGUuIEhvd2V2ZXIsIGluIHRoZSBkb2N1bWVudGF0aW9uCml0cyBkZXNjcmlwdGlv
biB3YXMgcHJldmlvdXNseSBwbGFjZWQgdW5kZXIgdGhlICJTZW5kaW5nIFNlcnZlcnMiIHNlY3Rp
b24uCgpUaGlzIGNvbW1pdCBtb3ZlcyB0aGUgZGVzY3JpcHRpb24gb2Ygc3luY2hyb25pemVkX3N0
YW5kYnlfc2xvdHMgdG8KdGhlICJQcmltYXJ5IFNlcnZlciIgc2VjdGlvbiBpbiB0aGUgZG9jdW1l
bnRhdGlvbi4KLS0tCiBkb2Mvc3JjL3NnbWwvY29uZmlnLnNnbWwgfCA3OCArKysrKysrKysrKysr
KysrKysrKy0tLS0tLS0tLS0tLS0tLS0tLS0tCiAxIGZpbGUgY2hhbmdlZCwgMzkgaW5zZXJ0aW9u
cygrKSwgMzkgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZG9jL3NyYy9zZ21sL2NvbmZpZy5z
Z21sIGIvZG9jL3NyYy9zZ21sL2NvbmZpZy5zZ21sCmluZGV4IDU1NjBiOTVlZTYwLi4wY2FjYzA2
MmNkZCAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21sL2NvbmZpZy5zZ21sCisrKyBiL2RvYy9zcmMv
c2dtbC9jb25maWcuc2dtbApAQCAtNDcyMiw0NSArNDcyMiw2IEBAIHJlc3RvcmVfY29tbWFuZCA9
ICdjb3B5ICJDOlxcc2VydmVyXFxhcmNoaXZlZGlyXFwlZiIgIiVwIicgICMgV2luZG93cwogICAg
ICAgPC9saXN0aXRlbT4KICAgICAgPC92YXJsaXN0ZW50cnk+CiAKLSAgICAgPHZhcmxpc3RlbnRy
eSBpZD0iZ3VjLXN5bmNocm9uaXplZC1zdGFuZGJ5LXNsb3RzIiB4cmVmbGFiZWw9InN5bmNocm9u
aXplZF9zdGFuZGJ5X3Nsb3RzIj4KLSAgICAgIDx0ZXJtPjx2YXJuYW1lPnN5bmNocm9uaXplZF9z
dGFuZGJ5X3Nsb3RzPC92YXJuYW1lPiAoPHR5cGU+c3RyaW5nPC90eXBlPikKLSAgICAgIDxpbmRl
eHRlcm0+Ci0gICAgICAgPHByaW1hcnk+PHZhcm5hbWU+c3luY2hyb25pemVkX3N0YW5kYnlfc2xv
dHM8L3Zhcm5hbWU+IGNvbmZpZ3VyYXRpb24gcGFyYW1ldGVyPC9wcmltYXJ5PgotICAgICAgPC9p
bmRleHRlcm0+Ci0gICAgICA8L3Rlcm0+Ci0gICAgICA8bGlzdGl0ZW0+Ci0gICAgICAgPHBhcmE+
Ci0gICAgICAgIEEgY29tbWEtc2VwYXJhdGVkIGxpc3Qgb2Ygc3RyZWFtaW5nIHJlcGxpY2F0aW9u
IHN0YW5kYnkgc2VydmVyIHNsb3QgbmFtZXMKLSAgICAgICAgdGhhdCBsb2dpY2FsIFdBTCBzZW5k
ZXIgcHJvY2Vzc2VzIHdpbGwgd2FpdCBmb3IuIExvZ2ljYWwgV0FMIHNlbmRlciBwcm9jZXNzZXMK
LSAgICAgICAgd2lsbCBzZW5kIGRlY29kZWQgY2hhbmdlcyB0byBwbHVnaW5zIG9ubHkgYWZ0ZXIg
dGhlIHNwZWNpZmllZCByZXBsaWNhdGlvbgotICAgICAgICBzbG90cyBjb25maXJtIHJlY2Vpdmlu
ZyBXQUwuIFRoaXMgZ3VhcmFudGVlcyB0aGF0IGxvZ2ljYWwgcmVwbGljYXRpb24KLSAgICAgICAg
ZmFpbG92ZXIgc2xvdHMgZG8gbm90IGNvbnN1bWUgY2hhbmdlcyB1bnRpbCB0aG9zZSBjaGFuZ2Vz
IGFyZSByZWNlaXZlZAotICAgICAgICBhbmQgZmx1c2hlZCB0byBjb3JyZXNwb25kaW5nIHBoeXNp
Y2FsIHN0YW5kYnlzLiBJZiBhCi0gICAgICAgIGxvZ2ljYWwgcmVwbGljYXRpb24gY29ubmVjdGlv
biBpcyBtZWFudCB0byBzd2l0Y2ggdG8gYSBwaHlzaWNhbCBzdGFuZGJ5Ci0gICAgICAgIGFmdGVy
IHRoZSBzdGFuZGJ5IGlzIHByb21vdGVkLCB0aGUgcGh5c2ljYWwgcmVwbGljYXRpb24gc2xvdCBm
b3IgdGhlCi0gICAgICAgIHN0YW5kYnkgc2hvdWxkIGJlIGxpc3RlZCBoZXJlLiBOb3RlIHRoYXQg
bG9naWNhbCByZXBsaWNhdGlvbiB3aWxsIG5vdAotICAgICAgICBwcm9jZWVkIGlmIHRoZSBzbG90
cyBzcGVjaWZpZWQgaW4gdGhlCi0gICAgICAgIDx2YXJuYW1lPnN5bmNocm9uaXplZF9zdGFuZGJ5
X3Nsb3RzPC92YXJuYW1lPiBkbyBub3QgZXhpc3Qgb3IgYXJlIGludmFsaWRhdGVkLgotICAgICAg
ICBBZGRpdGlvbmFsbHksIHRoZSByZXBsaWNhdGlvbiBtYW5hZ2VtZW50IGZ1bmN0aW9ucwotICAg
ICAgICA8bGluayBsaW5rZW5kPSJwZy1yZXBsaWNhdGlvbi1zbG90LWFkdmFuY2UiPgotICAgICAg
ICA8ZnVuY3Rpb24+cGdfcmVwbGljYXRpb25fc2xvdF9hZHZhbmNlPC9mdW5jdGlvbj48L2xpbms+
LAotICAgICAgICA8bGluayBsaW5rZW5kPSJwZy1sb2dpY2FsLXNsb3QtZ2V0LWNoYW5nZXMiPgot
ICAgICAgICA8ZnVuY3Rpb24+cGdfbG9naWNhbF9zbG90X2dldF9jaGFuZ2VzPC9mdW5jdGlvbj48
L2xpbms+LCBhbmQKLSAgICAgICAgPGxpbmsgbGlua2VuZD0icGctbG9naWNhbC1zbG90LXBlZWst
Y2hhbmdlcyI+Ci0gICAgICAgIDxmdW5jdGlvbj5wZ19sb2dpY2FsX3Nsb3RfcGVla19jaGFuZ2Vz
PC9mdW5jdGlvbj48L2xpbms+LAotICAgICAgICB3aGVuIHVzZWQgd2l0aCBsb2dpY2FsIGZhaWxv
dmVyIHNsb3RzLCB3aWxsIGJsb2NrIHVudGlsIGFsbAotICAgICAgICBwaHlzaWNhbCBzbG90cyBz
cGVjaWZpZWQgaW4gPHZhcm5hbWU+c3luY2hyb25pemVkX3N0YW5kYnlfc2xvdHM8L3Zhcm5hbWU+
IGhhdmUKLSAgICAgICAgY29uZmlybWVkIFdBTCByZWNlaXB0LgotICAgICAgIDwvcGFyYT4KLSAg
ICAgICA8cGFyYT4KLSAgICAgICAgVGhlIHN0YW5kYnlzIGNvcnJlc3BvbmRpbmcgdG8gdGhlIHBo
eXNpY2FsIHJlcGxpY2F0aW9uIHNsb3RzIGluCi0gICAgICAgIDx2YXJuYW1lPnN5bmNocm9uaXpl
ZF9zdGFuZGJ5X3Nsb3RzPC92YXJuYW1lPiBtdXN0IGNvbmZpZ3VyZQotICAgICAgICA8bGl0ZXJh
bD5zeW5jX3JlcGxpY2F0aW9uX3Nsb3RzID0gdHJ1ZTwvbGl0ZXJhbD4gc28gdGhleSBjYW4gcmVj
ZWl2ZQotICAgICAgICBsb2dpY2FsIGZhaWxvdmVyIHNsb3QgY2hhbmdlcyBmcm9tIHRoZSBwcmlt
YXJ5LgotICAgICAgIDwvcGFyYT4KLSAgICAgIDwvbGlzdGl0ZW0+Ci0gICAgIDwvdmFybGlzdGVu
dHJ5PgotCiAgICAgIDwvdmFyaWFibGVsaXN0PgogICAgIDwvc2VjdDI+CiAKQEAgLTQ5MDksNiAr
NDg3MCw0NSBAQCBBTlkgPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPm51bV9zeW5jPC9y
ZXBsYWNlYWJsZT4gKCA8cmVwbGFjZWFibGUgY2xhc3M9IgogICAgICAgICBmaWxlIG9yIG9uIHRo
ZSBzZXJ2ZXIgY29tbWFuZCBsaW5lLgogICAgICAgIDwvcGFyYT4KICAgICAgIDwvbGlzdGl0ZW0+
CisKKyAgICAgPC92YXJsaXN0ZW50cnk+CisgICAgIDx2YXJsaXN0ZW50cnkgaWQ9Imd1Yy1zeW5j
aHJvbml6ZWQtc3RhbmRieS1zbG90cyIgeHJlZmxhYmVsPSJzeW5jaHJvbml6ZWRfc3RhbmRieV9z
bG90cyI+CisgICAgICA8dGVybT48dmFybmFtZT5zeW5jaHJvbml6ZWRfc3RhbmRieV9zbG90czwv
dmFybmFtZT4gKDx0eXBlPnN0cmluZzwvdHlwZT4pCisgICAgICA8aW5kZXh0ZXJtPgorICAgICAg
IDxwcmltYXJ5Pjx2YXJuYW1lPnN5bmNocm9uaXplZF9zdGFuZGJ5X3Nsb3RzPC92YXJuYW1lPiBj
b25maWd1cmF0aW9uIHBhcmFtZXRlcjwvcHJpbWFyeT4KKyAgICAgIDwvaW5kZXh0ZXJtPgorICAg
ICAgPC90ZXJtPgorICAgICAgPGxpc3RpdGVtPgorICAgICAgIDxwYXJhPgorICAgICAgICBBIGNv
bW1hLXNlcGFyYXRlZCBsaXN0IG9mIHN0cmVhbWluZyByZXBsaWNhdGlvbiBzdGFuZGJ5IHNlcnZl
ciBzbG90IG5hbWVzCisgICAgICAgIHRoYXQgbG9naWNhbCBXQUwgc2VuZGVyIHByb2Nlc3NlcyB3
aWxsIHdhaXQgZm9yLiBMb2dpY2FsIFdBTCBzZW5kZXIgcHJvY2Vzc2VzCisgICAgICAgIHdpbGwg
c2VuZCBkZWNvZGVkIGNoYW5nZXMgdG8gcGx1Z2lucyBvbmx5IGFmdGVyIHRoZSBzcGVjaWZpZWQg
cmVwbGljYXRpb24KKyAgICAgICAgc2xvdHMgY29uZmlybSByZWNlaXZpbmcgV0FMLiBUaGlzIGd1
YXJhbnRlZXMgdGhhdCBsb2dpY2FsIHJlcGxpY2F0aW9uCisgICAgICAgIGZhaWxvdmVyIHNsb3Rz
IGRvIG5vdCBjb25zdW1lIGNoYW5nZXMgdW50aWwgdGhvc2UgY2hhbmdlcyBhcmUgcmVjZWl2ZWQK
KyAgICAgICAgYW5kIGZsdXNoZWQgdG8gY29ycmVzcG9uZGluZyBwaHlzaWNhbCBzdGFuZGJ5cy4g
SWYgYQorICAgICAgICBsb2dpY2FsIHJlcGxpY2F0aW9uIGNvbm5lY3Rpb24gaXMgbWVhbnQgdG8g
c3dpdGNoIHRvIGEgcGh5c2ljYWwgc3RhbmRieQorICAgICAgICBhZnRlciB0aGUgc3RhbmRieSBp
cyBwcm9tb3RlZCwgdGhlIHBoeXNpY2FsIHJlcGxpY2F0aW9uIHNsb3QgZm9yIHRoZQorICAgICAg
ICBzdGFuZGJ5IHNob3VsZCBiZSBsaXN0ZWQgaGVyZS4gTm90ZSB0aGF0IGxvZ2ljYWwgcmVwbGlj
YXRpb24gd2lsbCBub3QKKyAgICAgICAgcHJvY2VlZCBpZiB0aGUgc2xvdHMgc3BlY2lmaWVkIGlu
IHRoZQorICAgICAgICA8dmFybmFtZT5zeW5jaHJvbml6ZWRfc3RhbmRieV9zbG90czwvdmFybmFt
ZT4gZG8gbm90IGV4aXN0IG9yIGFyZSBpbnZhbGlkYXRlZC4KKyAgICAgICAgQWRkaXRpb25hbGx5
LCB0aGUgcmVwbGljYXRpb24gbWFuYWdlbWVudCBmdW5jdGlvbnMKKyAgICAgICAgPGxpbmsgbGlu
a2VuZD0icGctcmVwbGljYXRpb24tc2xvdC1hZHZhbmNlIj4KKyAgICAgICAgPGZ1bmN0aW9uPnBn
X3JlcGxpY2F0aW9uX3Nsb3RfYWR2YW5jZTwvZnVuY3Rpb24+PC9saW5rPiwKKyAgICAgICAgPGxp
bmsgbGlua2VuZD0icGctbG9naWNhbC1zbG90LWdldC1jaGFuZ2VzIj4KKyAgICAgICAgPGZ1bmN0
aW9uPnBnX2xvZ2ljYWxfc2xvdF9nZXRfY2hhbmdlczwvZnVuY3Rpb24+PC9saW5rPiwgYW5kCisg
ICAgICAgIDxsaW5rIGxpbmtlbmQ9InBnLWxvZ2ljYWwtc2xvdC1wZWVrLWNoYW5nZXMiPgorICAg
ICAgICA8ZnVuY3Rpb24+cGdfbG9naWNhbF9zbG90X3BlZWtfY2hhbmdlczwvZnVuY3Rpb24+PC9s
aW5rPiwKKyAgICAgICAgd2hlbiB1c2VkIHdpdGggbG9naWNhbCBmYWlsb3ZlciBzbG90cywgd2ls
bCBibG9jayB1bnRpbCBhbGwKKyAgICAgICAgcGh5c2ljYWwgc2xvdHMgc3BlY2lmaWVkIGluIDx2
YXJuYW1lPnN5bmNocm9uaXplZF9zdGFuZGJ5X3Nsb3RzPC92YXJuYW1lPiBoYXZlCisgICAgICAg
IGNvbmZpcm1lZCBXQUwgcmVjZWlwdC4KKyAgICAgICA8L3BhcmE+CisgICAgICAgPHBhcmE+Cisg
ICAgICAgIFRoZSBzdGFuZGJ5cyBjb3JyZXNwb25kaW5nIHRvIHRoZSBwaHlzaWNhbCByZXBsaWNh
dGlvbiBzbG90cyBpbgorICAgICAgICA8dmFybmFtZT5zeW5jaHJvbml6ZWRfc3RhbmRieV9zbG90
czwvdmFybmFtZT4gbXVzdCBjb25maWd1cmUKKyAgICAgICAgPGxpdGVyYWw+c3luY19yZXBsaWNh
dGlvbl9zbG90cyA9IHRydWU8L2xpdGVyYWw+IHNvIHRoZXkgY2FuIHJlY2VpdmUKKyAgICAgICAg
bG9naWNhbCBmYWlsb3ZlciBzbG90IGNoYW5nZXMgZnJvbSB0aGUgcHJpbWFyeS4KKyAgICAgICA8
L3BhcmE+CisgICAgICA8L2xpc3RpdGVtPgogICAgICA8L3Zhcmxpc3RlbnRyeT4KIAogICAgICA8
L3ZhcmlhYmxlbGlzdD4KLS0gCjIuNTEuMgoK
--0000000000004c8d7406490b876d--