Re: pg_dump/pg_dumpall help synopses and terminology

2025-06-19 Thread Peter Eisentraut
On 18.06.25 22:57, Robert Treat wrote: I also wondered why you differentiated SQL script file vs archive in the change here: - of a cluster into an archive. The archive contains + of a cluster into an SQL script file or an archive. The output contains but then did not differentiate them h

Re: pg_dump/pg_dumpall help synopses and terminology

2025-06-18 Thread Robert Treat
On Tue, Jun 17, 2025 at 3:32 AM Peter Eisentraut wrote: > On 10.06.25 13:51, Ashutosh Bapat wrote: > > 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

Re: pg_dump/pg_dumpall help synopses and terminology

2025-06-17 Thread Peter Eisentraut
pg_dump/pg_dumpall help synopses and terminology Increase consistency of --help and man page synopses between pg_dump and pg_dumpall. These should now be very similar, as pg_dumpall can now also produce non-text dump output. But actually, they have drifted further apart. - Use verb "e

Re: pg_dump/pg_dumpall help synopses and terminology

2025-06-17 Thread Peter Eisentraut
On 10.06.25 13:51, Ashutosh Bapat wrote: 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_

Re: pg_dump/pg_dumpall help synopses and terminology

2025-06-10 Thread Ashutosh Bapat
Hi Peter, On Tue, Jun 10, 2025 at 12:29 PM Peter Eisentraut 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 scri

pg_dump/pg_dumpall help synopses and terminology

2025-06-10 Thread Peter Eisentraut
The pg_dump and pg_dumpall help synopses could use some refinements. PG17: pg_dump --help: pg_dump dumps a database as a text file or to other formats. pg_dumpall --help: pg_dumpall extracts a PostgreSQL database cluster into an SQL script file. man pages: pg_dump - extract a PostgreSQL databa