Re: pg_dump/pg_dumpall help synopses and terminology - Mailing list pgsql-hackers

From Ashutosh Bapat
Subject Re: pg_dump/pg_dumpall help synopses and terminology
Date
Msg-id CAExHW5um8FYYo_qeHsgwrAFiBq+FaE7Ry+1MeTv8hx8==CDKCQ@mail.gmail.com
Whole thread Raw
In response to pg_dump/pg_dumpall help synopses and terminology  (Peter Eisentraut <peter@eisentraut.org>)
Responses Re: pg_dump/pg_dumpall help synopses and terminology
List pgsql-hackers
Hi Peter,

On Tue, Jun 10, 2025 at 12:29 PM Peter Eisentraut <peter@eisentraut.org> wrote:
How about this to bring it all together:

pg_dump --help:
pg_dump exports a PostgreSQL database as an SQL script or to other formats.

pg_dumpall --help:
pg_dumpall exports a PostgreSQL database cluster as an SQL script or to
other formats.

(Note: Uses the verb "export", to align with commit 4f29394ea94.)

pg_restore --help: [unchanged]
pg_restore restores PostgreSQL databases from archives created by
pg_dump or pg_dumpall.

man pages:
pg_dump - export a PostgreSQL database as an SQL script or to other formats
pg_dumpall - export a PostgreSQL database cluster as an SQL script or to
other formats

pg_restore - restore PostgreSQL databases from archives created by
pg_dump or pg_dumpall

Since we are using "a PostgreSQL database" and "a PostgreSQL cluster" with pg_dump and pg_dumpall respectively, it makes sense to use the same wording for pg_restore. Th description at [1] already does that, except it needs small tweaks like below:

pg_restore - restore a PostgreSQL database or a PostgreSQL cluster from an archive created by
pg_dump or pg_dumpall respectively.


--
Best Wishes,
Ashutosh Bapat

pgsql-hackers by date:

Previous
From: Ashutosh Bapat
Date:
Subject: Re: Changing shared_buffers without restart
Next
From: Jim Jones
Date:
Subject: Re: Feature: psql - display current search_path in prompt