From: Daniel Gustafsson <daniel@yesql.se>
Message-Id: <8D4EF043-0DA9-4DF1-A28C-E3598167D1D2@yesql.se>
Content-Type: multipart/mixed;
	boundary="Apple-Mail=_562600B5-9997-4A07-B06F-426F6D274975"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3776.700.51.11.12\))
Subject: Re: Fix data checksum progress reporting docs
Date: Thu, 9 Jul 2026 10:28:18 +0200
In-Reply-To: 
 <CAHGQGwEv-C9ia+rBYyePzO8F=5FVvS412ZqcOupazuOb5RafNg@mail.gmail.com>
Cc: "pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
To: Fujii Masao <masao.fujii@gmail.com>
References: 
 <CAHGQGwHJHJYAkYZBi3_O13np-Rou9UL637=hB3Y_-qdCgcZn-w@mail.gmail.com>
 <E5A7D80B-A691-4DDE-9E90-19CC0ED0BFF5@yesql.se>
 <CAHGQGwEv-C9ia+rBYyePzO8F=5FVvS412ZqcOupazuOb5RafNg@mail.gmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/8D4EF043-0DA9-4DF1-A28C-E3598167D1D2%40yesql.se>
Precedence: bulk


--Apple-Mail=_562600B5-9997-4A07-B06F-426F6D274975
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=utf-8

> On 9 Jul 2026, at 02:17, Fujii Masao <masao.fujii@gmail.com> wrote:
>=20
> On Wed, Jul 8, 2026 at 10:24=E2=80=AFPM Daniel Gustafsson =
<daniel@yesql.se> wrote:
>> The proposed changes all look good to me, thanks!
>=20
> Thanks for the review! I've pushed the patch.
>=20
> BTW, this is a separate issue, but also related to the data checksums =
docs,
> I found that the glossary entry for "Auxiliary process" includes
> the data checksums worker and data checksums worker launcher.
> However, their own glossary entries describe them as background =
workers,
> and they are implemented as dynamic background workers.
>=20
> This seems inconsistent. Other dynamic background workers, such as
> logical replication apply workers, are not listed as auxiliary =
processes.
> I don't see why the data checksums worker and launcher should be =
treated
> differently.
>=20
> Wouldn't it be better to remove the data checksums worker and data
> checksums worker launcher from the "Auxiliary process" entry?

You are absolutely right.  And when looking at it I think we can =
simplify the
entry a bit as well to make it fit the style of the page better.  What =
do you
think about the attached?

--
Daniel Gustafsson


--Apple-Mail=_562600B5-9997-4A07-B06F-426F6D274975
Content-Disposition: attachment;
	filename=0001-doc-Fix-glossary-entry-for-data-checksums-workers.patch
Content-Type: application/octet-stream;
	x-unix-mode=0644;
	name="0001-doc-Fix-glossary-entry-for-data-checksums-workers.patch"
Content-Transfer-Encoding: quoted-printable

=46rom=20740c9c8e44dc7c419a2ceb0207c43f7588229e87=20Mon=20Sep=2017=20=
00:00:00=202001=0AFrom:=20Daniel=20Gustafsson=20=
<dgustafsson@postgresql.org>=0ADate:=20Thu,=209=20Jul=202026=2010:23:22=20=
+0200=0ASubject:=20[PATCH]=20doc:=20Fix=20glossary=20entry=20for=20data=20=
checksums=20workers=0A=0AThe=20glossary=20entry=20for=20data=20checksums=20=
workers=20incorrectly=20stated=20that=0Athey=20were=20auxiliary=20=
processes,=20but=20they=20are=20implementerd=20as=20background=0A=
workers.=20=20Fix,=20and=20while=20there,=20simplify=20the=20entry=20by=20=
combining=20the=0Aworker=20and=20launcher=20into=20a=20single=20glossary=20=
term.=0A=0AReported-by:=20Fujii=20Masao=20<masao.fujii@gmail.com>=0A=
Discussion:=20=
https://postgr.es/m/CAHGQGwEv-C9ia+rBYyePzO8F=3D5FVvS412ZqcOupazuOb5RafNg@=
mail.gmail.com=0A---=0A=20doc/src/sgml/glossary.sgml=20|=2032=20=
++++++++++++--------------------=0A=201=20file=20changed,=2012=20=
insertions(+),=2020=20deletions(-)=0A=0Adiff=20--git=20=
a/doc/src/sgml/glossary.sgml=20b/doc/src/sgml/glossary.sgml=0Aindex=20=
f7f69afc922..4f841fb5886=20100644=0A---=20a/doc/src/sgml/glossary.sgml=0A=
+++=20b/doc/src/sgml/glossary.sgml=0A@@=20-199,8=20+199,6=20@@=0A=20=20=20=
=20=20=20(but=20not=20the=20autovacuum=20workers),=0A=20=20=20=20=20=20=
the=20<glossterm=20linkend=3D"glossary-background-writer">background=20=
writer</glossterm>,=0A=20=20=20=20=20=20the=20<glossterm=20=
linkend=3D"glossary-checkpointer">checkpointer</glossterm>,=0A-=20=20=20=20=
=20the=20<glossterm=20linkend=3D"glossary-data-checksums-worker">data=20=
checksums=20worker</glossterm>,=0A-=20=20=20=20=20the=20<glossterm=20=
linkend=3D"glossary-data-checksums-worker-launcher">data=20checksums=20=
worker=20launcher</glossterm>,=0A=20=20=20=20=20=20the=20<glossterm=20=
linkend=3D"glossary-logger">logger</glossterm>,=0A=20=20=20=20=20=20the=20=
<glossterm=20linkend=3D"glossary-startup-process">startup=20=
process</glossterm>,=0A=20=20=20=20=20=20the=20<glossterm=20=
linkend=3D"glossary-wal-archiver">WAL=20archiver</glossterm>,=0A@@=20=
-236,8=20+234,9=20@@=0A=20=20=20=20=20=20which=20runs=20system-=20or=20=
user-supplied=20code.=0A=20=20=20=20=20=20Serves=20as=20infrastructure=20=
for=20several=20features=20in=0A=20=20=20=20=20=20=
<productname>PostgreSQL</productname>,=20such=20as=0A-=20=20=20=20=20=
<glossterm=20linkend=3D"glossary-replication">logical=20=
replication</glossterm>=0A-=20=20=20=20=20and=20<glossterm=20=
linkend=3D"glossary-parallel-query">parallel=20queries</glossterm>.=0A+=20=
=20=20=20=20<glossterm=20linkend=3D"glossary-replication">logical=20=
replication</glossterm>,=0A+=20=20=20=20=20<glossterm=20=
linkend=3D"glossary-parallel-query">parallel=20queries</glossterm>=20and=0A=
+=20=20=20=20=20<glossterm=20=
linkend=3D"glossary-data-checksums-process">data=20checksums=20=
processing</glossterm>.=0A=20=20=20=20=20=20In=20addition,=20<glossterm=20=
linkend=3D"glossary-extension">Extensions</glossterm>=20can=20add=0A=20=20=
=20=20=20=20custom=20background=20worker=20processes.=0A=20=20=20=20=
</para>=0A@@=20-588,24=20+587,17=20@@=0A=20=20=20=20<glosssee=20=
otherterm=3D"glossary-data-directory"=20/>=0A=20=20=20</glossentry>=0A=20=
=0A-=20=20<glossentry=20id=3D"glossary-data-checksums-worker">=0A-=20=20=20=
<glossterm>Data=20Checksums=20Worker</glossterm>=0A+=20=20<glossentry=20=
id=3D"glossary-data-checksums-process">=0A+=20=20=20<glossterm>Data=20=
Checksums=20(process)</glossterm>=0A=20=20=20=20<glossdef>=0A=20=20=20=20=
=20<para>=0A-=20=20=20=20=20A=20<glossterm=20=
linkend=3D"glossary-background-worker">background=20worker</glossterm>=0A=
-=20=20=20=20=20which=20enables=20data=20checksums=20in=20a=20specific=20=
database.=0A-=20=20=20=20</para>=0A-=20=20=20</glossdef>=0A-=20=20=
</glossentry>=0A-=0A-=20=20<glossentry=20=
id=3D"glossary-data-checksums-worker-launcher">=0A-=20=20=20=
<glossterm>Data=20Checksums=20Worker=20Launcher</glossterm>=0A-=20=20=20=
<glossdef>=0A-=20=20=20=20<para>=0A-=20=20=20=20=20A=20<glossterm=20=
linkend=3D"glossary-background-worker">background=20worker</glossterm>=0A=
-=20=20=20=20=20which=20starts=20<glossterm=20=
linkend=3D"glossary-data-checksums-worker">=20data=0A-=20=20=20=20=20=
checksum=20worker</glossterm>=20processes=20for=20enabling=20data=20=
checksums=20in=20each=0A-=20=20=20=20=20database,=20or=20disables=20data=20=
checksums=20cluster-wide.=0A+=20=20=20=20=20A=20set=20of=0A+=20=20=20=20=20=
<glossterm=20linkend=3D"glossary-background-worker">background=20=
worker</glossterm>=0A+=20=20=20=20=20processes=20which=20can=20enable,=20=
or=20disable,=20data=20checksums=20in=20a=0A+=20=20=20=20=20running=20=
cluster.=20=20The=20process=20which=20coordinates=20the=20work=20is=20=
known=20as=20the=0A+=20=20=20=20=20<firstterm>data=20checksums=20worker=20=
launcher</firstterm>=20and=20the=20process=0A+=20=20=20=20=20which=20=
operate=20on=20the=20individual=20databases=20is=20known=20as=20the=0A+=20=
=20=20=20=20<firstterm>data=20checksums=20worker</firstterm>.=0A=20=20=20=
=20=20</para>=0A=20=20=20=20</glossdef>=0A=20=20=20</glossentry>=0A--=20=0A=
2.39.3=20(Apple=20Git-146)=0A=0A=

--Apple-Mail=_562600B5-9997-4A07-B06F-426F6D274975--