Re: Pg_dumpall - Mailing list pgsql-docs

From Jonathan S. Katz
Subject Re: Pg_dumpall
Date
Msg-id 903C7F7F-C143-47A2-8CF3-0EC48E2390B2@postgresql.org
Whole thread Raw
In response to Pg_dumpall  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: Pg_dumpall  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
Hi,

> On Apr 7, 2018, at 10:55 AM, PG Doc comments form <noreply@postgresql.org> wrote:
>
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/10/static/backup-dump.html
> Description:
>
> "The basic usage of this command is:
>
> pg_dumpall > outfile
> The resulting dump can be restored with psql:
>
> psql -f infile postgres
> (Actually, you can specify any existing database name to..."
>
> Should this not read :
> psql-f outfile postgres

Technically it is correct: you’re dumping data to an output file,
and reading the data in from an input file.  The documentation
also makes reference to what the “outfile” and “infile” represent.

That being said, I can see how it can be confusing particularly
if you are reading through the documentation quickly.  Perhaps
a name like “dumpfile” would be more clear?

Jonathan



pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Pg_dumpall
Next
From: Tom Lane
Date:
Subject: Re: Pg_dumpall