From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: robert@interactive.co.uk
Subject: PostgreSQL 12: Cryptic documentation
Date: Sat, 15 Aug 2020 12:23:08 +0000
Message-ID: <159749418850.14322.216503677134569752@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/12/app-pgbasebackup.html
Description:
The pg_basebackup page says that the --waldir parameter "Specifies the
location for the write-ahead log directory. waldir must be an absolute path.
The write-ahead log directory can only be specified when the backup is in
plain mode." But it says nothing at all about what it is actually used
for.
You may think it is obvious. And I thought I could guess - it would be the
directory containing the WAL files for the database, right? But my attempt
to use it was met with "error: directory "/var/lib/pgsql/Walfiles" exists
but is not empty". But WAL files are part of the normal operation of the
database, aren't they? And so the directory _must_ exist, and it is not
surprising it has got something in it! But that seems to be a problem.
Which makes me realise I must have been completely wrong and I have no idea
what it for.
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: noreply@postgresql.org, pgsql-docs@lists.postgresql.org, robert@interactive.co.uk
Subject: Re: PostgreSQL 12: Cryptic documentation
In-Reply-To: <159749418850.14322.216503677134569752@wrigleys.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox