public inbox for pgsql-docs@postgresql.org  

help / color / mirror / Atom feed

From: David G. Johnston <david.g.johnston@gmail.com>
To: dario_d_s@unitech.com.ar
To: pgsql-docs@lists.postgresql.org
Subject: Re: Regarding the archive_command in "continuois archiving" chapter.
Date: Tue, 5 May 2026 11:33:04 -0700
Message-ID: <CAKFQuwYyLjzwVxOh4QkfFrE0STzaVq0FUcjSqTaEVuWRzxVu3w@mail.gmail.com> (raw)
In-Reply-To: <177799183569.798.92791159894803781@wrigleys.postgresql.org>
References: <177799183569.798.92791159894803781@wrigleys.postgresql.org>

On Tue, May 5, 2026 at 11:19 AM PG Doc comments form <noreply@postgresql.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.

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: david.g.johnston@gmail.com, dario_d_s@unitech.com.ar, pgsql-docs@lists.postgresql.org
  Subject: Re: Regarding the archive_command in "continuois archiving" chapter.
  In-Reply-To: <CAKFQuwYyLjzwVxOh4QkfFrE0STzaVq0FUcjSqTaEVuWRzxVu3w@mail.gmail.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