MIME-Version: 1.0
References: <177799183569.798.92791159894803781@wrigleys.postgresql.org>
In-Reply-To: <177799183569.798.92791159894803781@wrigleys.postgresql.org>
From: "David G. Johnston" <david.g.johnston@gmail.com>
Date: Tue, 5 May 2026 11:33:04 -0700
Message-ID: 
 <CAKFQuwYyLjzwVxOh4QkfFrE0STzaVq0FUcjSqTaEVuWRzxVu3w@mail.gmail.com>
Subject: Re: Regarding the archive_command in "continuois archiving" chapter.
To: dario_d_s@unitech.com.ar, pgsql-docs@lists.postgresql.org
Content-Type: multipart/alternative; boundary="0000000000006028df065116499e"
Archived-At: 
 <https://www.postgresql.org/message-id/CAKFQuwYyLjzwVxOh4QkfFrE0STzaVq0FUcjSqTaEVuWRzxVu3w%40mail.gmail.com>
Precedence: bulk

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

On Tue, May 5, 2026 at 11:19=E2=80=AFAM PG Doc comments form <noreply@postg=
resql.org>
wrote:

> The cp command in Linux should be treated as a stub;


The documentation says as much:

 (This is an example, not a recommendation, and might not work on all
platforms.)


> This what would look like (I've used ai to help me that this gets written
> in
> proper english)
>

Getting it to update the sgml and produce a real diff file would be
considerably more helpful.


I do think the point here is to be so simple as to be obviously incomplete
and thus encourage the reader to find a proven backup system to plug into
here instead of writing their own script.

PostgreSQL consistently tries to avoid being inherently too platform and
process dependent and this is one of the key places where the community,
interested in their platforms and operating systems, are expected to
largely step in.

That all said, patching this part of the documentation isn't off the table.
(Though given prior comments like this exist and it hasn't been updated
suggests a low priority if nothing else - especially without a concrete
sgml patch.)

David J.

--0000000000006028df065116499e
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">On Tue, May 5, 2026 at 11:19=E2=80=AFAM PG Doc comments fo=
rm &lt;<a href=3D"mailto:noreply@postgresql.org">noreply@postgresql.org</a>=
&gt; wrote:</span><span style=3D"font-family:Arial,Helvetica,sans-serif">=
=C2=A0</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-l=
eft:1px solid rgb(204,204,204);padding-left:1ex">The cp command in Linux sh=
ould be treated as a stub;</blockquote><div><br></div><div class=3D"gmail_d=
efault" style=3D"font-family:arial,helvetica,sans-serif">The documentation =
says as much:</div><div class=3D"gmail_default" style=3D"font-family:arial,=
helvetica,sans-serif"><br></div><div class=3D"gmail_default" style=3D"font-=
family:arial,helvetica,sans-serif">=C2=A0(This is an example, not a recomme=
ndation, and might not work on all platforms.)</div><div class=3D"gmail_def=
ault" style=3D"font-family:arial,helvetica,sans-serif"><br></div><blockquot=
e class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px s=
olid rgb(204,204,204);padding-left:1ex">
<br>
This what would look like (I&#39;ve used ai to help me that this gets writt=
en in<br>
proper english)<br></blockquote><div><br></div><div class=3D"gmail_default"=
 style=3D"font-family:arial,helvetica,sans-serif">Getting it to update the =
sgml and produce a real diff file would be considerably more helpful.</div>=
<div class=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-seri=
f"><br></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"><br></div><div class=3D"gmail_default" style=
=3D"font-family:arial,helvetica,sans-serif">I do think the point here is to=
 be so simple as to be obviously incomplete and thus encourage the reader t=
o find a proven backup system to plug into here instead of writing their ow=
n script.</div><div class=3D"gmail_default" style=3D"font-family:arial,helv=
etica,sans-serif"><br></div><div class=3D"gmail_default" style=3D"font-fami=
ly:arial,helvetica,sans-serif">PostgreSQL consistently tries to avoid being=
 inherently=C2=A0too platform and process dependent and this is one of the =
key places where the community, interested in their platforms and operating=
 systems, are expected to largely step in.</div><div class=3D"gmail_default=
" style=3D"font-family:arial,helvetica,sans-serif"><br></div><div class=3D"=
gmail_default" style=3D"font-family:arial,helvetica,sans-serif">That all=C2=
=A0said, patching this part of the documentation isn&#39;t off the table. (=
Though given prior comments like this exist and it hasn&#39;t been updated =
suggests a low priority if nothing else - especially without a concrete sgm=
l patch.)</div><div class=3D"gmail_default" style=3D"font-family:arial,helv=
etica,sans-serif"><br></div><div class=3D"gmail_default" style=3D"font-fami=
ly:arial,helvetica,sans-serif">David J.</div><div class=3D"gmail_default" s=
tyle=3D"font-family:arial,helvetica,sans-serif"><br></div></div></div>

--0000000000006028df065116499e--