MIME-Version: 1.0
References: 
 <176789124328.1470667.14491036876449669285@wrigleys.postgresql.org>
In-Reply-To: 
 <176789124328.1470667.14491036876449669285@wrigleys.postgresql.org>
From: "David G. Johnston" <david.g.johnston@gmail.com>
Date: Tue, 24 Feb 2026 18:10:56 -0700
Message-ID: 
 <CAKFQuwbNUP0WU+N_s9P8xJi0uiiosMOHVk43Xar_FgbONRUYgg@mail.gmail.com>
Subject: Re: Documentation/Behavior: Systemd Type=notify failure with pg_ctl
 on Debian 12
To: virtualtengfei@163.com, pgsql-docs@lists.postgresql.org
Content-Type: multipart/alternative; boundary="00000000000050574f064b9bafec"
Archived-At: 
 <https://www.postgresql.org/message-id/CAKFQuwbNUP0WU%2BN_s9P8xJi0uiiosMOHVk43Xar_FgbONRUYgg%40mail.gmail.com>
Precedence: bulk

--00000000000050574f064b9bafec
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

These forms submit plain text - submitting markdown makes them more
difficult to review. In particular the link format doesn't play well with
my mail reader's link auto-detection.

On Fri, Jan 9, 2026 at 1:10=E2=80=AFAM PG Doc comments form <noreply@postgr=
esql.org>
wrote:

> The documentation regarding Systemd integration (specifically when using
> `pg_ctl` combined with `Type=3Dnotify`) might be incomplete.
>

Such documentation is nonexistent, not incomplete.  The provided unit file
for systemd doesn't use pg_ctl, I suppose presumably for this or a similar
reason.  It uses the postgres binary directly.

Such, I'm not seeing a bug here (I suppose a comment pointing out that/why
pg_ctl is not used might be in order).  I'm not opposed to possibly adding
more detail or alternatives to this part of the documentation - though the
number of people doing their own unit files is few compared to those using
ones bundled in a package - but the lack or responders seems to suggest
such effort is not high on anyone's list.

David J.

--00000000000050574f064b9bafec
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div class=3D"gmail_default" style=3D"fon=
t-family:arial,helvetica,sans-serif"><span style=3D"font-family:Arial,Helve=
tica,sans-serif">These forms submit plain text - submitting markdown makes =
them more difficult to review. In particular the link format doesn&#39;t pl=
ay well with my mail reader&#39;s link auto-detection.</span></div><div cla=
ss=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-serif"><span=
 style=3D"font-family:Arial,Helvetica,sans-serif"><br></span></div><div cla=
ss=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-serif"><span=
 style=3D"font-family:Arial,Helvetica,sans-serif">On Fri, Jan 9, 2026 at 1:=
10=E2=80=AFAM PG Doc comments form &lt;<a href=3D"mailto:noreply@postgresql=
.org">noreply@postgresql.org</a>&gt; wrote:</span></div></div><div class=3D=
"gmail_quote gmail_quote_container"><blockquote class=3D"gmail_quote" style=
=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding=
-left:1ex"><span class=3D"gmail_default" style=3D"font-family:arial,helveti=
ca,sans-serif"></span>The documentation regarding Systemd integration (spec=
ifically when using<br>
`pg_ctl` combined with `Type=3Dnotify`) might be incomplete.<br></blockquot=
e><div><br></div><div class=3D"gmail_default" style=3D"font-family:arial,he=
lvetica,sans-serif">Such documentation is nonexistent, not incomplete.=C2=
=A0 The provided unit file for systemd doesn&#39;t use pg_ctl, I suppose pr=
esumably for this or a similar reason.=C2=A0 It uses the postgres binary di=
rectly.</div><div class=3D"gmail_default" style=3D"font-family:arial,helvet=
ica,sans-serif"><br></div><div class=3D"gmail_default" style=3D"font-family=
:arial,helvetica,sans-serif">Such, I&#39;m not seeing a bug here (I suppose=
 a comment pointing out that/why pg_ctl is not used might be in order).=C2=
=A0 I&#39;m not opposed to possibly adding more=C2=A0detail or alternatives=
 to this part of the documentation - though the number of people doing thei=
r own unit files is few compared to those using ones bundled in a package -=
 but the lack or responders seems to suggest such effort is not high on any=
one&#39;s list.</div><div class=3D"gmail_default" style=3D"font-family:aria=
l,helvetica,sans-serif"><br></div><div class=3D"gmail_default" style=3D"fon=
t-family:arial,helvetica,sans-serif">David J.</div><div class=3D"gmail_defa=
ult" style=3D"font-family:arial,helvetica,sans-serif"><br></div></div></div=
>

--00000000000050574f064b9bafec--