Re: BUG #18952: pg_restore --help and document have strange description: Dump something

From: Fujii Masao <masao(dot)fujii(at)oss(dot)nttdata(dot)com>
To: harukat(at)sraoss(dot)co(dot)jp, pgsql-bugs(at)lists(dot)postgresql(dot)org
Subject: Re: BUG #18952: pg_restore --help and document have strange description: Dump something
Date: 2025-06-11 01:04:24
Message-ID: df4a3f45-3559-4fa0-9ae9-d1fbb1b4bb42@oss.nttdata.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-bugs

On 2025/06/10 16:35, PG Bug reporting form wrote:
> The following bug has been logged on the website:
>
> Bug reference: 18952
> Logged by: TAKATSUKA Haruka
> Email address: harukat(at)sraoss(dot)co(dot)jp
> PostgreSQL version: 18beta1
> Operating system: any
> Description:
>
> pg_restore --help has strange description like "Dump .....":
> [dbhost]$ LANG=C pg_restore --help
> pg_restore restores PostgreSQL databases from archives created by pg_dump or
> pg_dumpall.
> Usage:
> pg_restore [OPTION]... [FILE]
> (snip)
> --with-data dump the data
> --with-schema dump the schema
> --with-statistics dump the statistics
> Connection options:
> -h, --host=HOSTNAME database server host or socket directory
> (snip)
> https://www.postgresql.org/docs/18/app-pgrestore.html also have the
> following description.
> --with-data
> Dump data. This is the default.
> --with-schema
> Dump schema (data definitions). This is the default.
> --with-statistics
> Dump statistics. This is the default.

Thanks for the report!

Are you suggesting that "dump" in the help message and docs should be "restore"?
If so, does the attached patch address that correctly?

Regards,

--
Fujii Masao
NTT DATA Japan Corporation

Attachment Content-Type Size
v1-0001-pg_restore-Fix-wrong-descriptions-of-with-schema-.patch text/plain 3.0 KB

In response to

Responses

Browse pgsql-bugs by date

  From Date Subject
Next Message Hayato Kuroda (Fujitsu) 2025-06-11 01:45:19 RE: Logical replication 'invalid memory alloc request size 1585837200' after upgrading to 17.5
Previous Message Michael Paquier 2025-06-11 00:03:31 Re: BUG #18947: TRAP: failed Assert("len_to_wrt >= 0") in pg_stat_statements