doc: Avoid too prominent use of "backup" on pg_dump man page

Peter Eisentraut <peter@eisentraut.org>

Commit: 4f29394ea941f688fd4faf7260d2c198931ca797
Author: Peter Eisentraut <peter@eisentraut.org>
Date: 2024-07-31T05:57:47Z
Releases: 18.0
doc: Avoid too prominent use of "backup" on pg_dump man page

Some users inadvertently rely on pg_dump as their primary backup tool,
when better solutions exist.  The pg_dump man page is arguably
misleading in that it starts with

"pg_dump is a utility for backing up a PostgreSQL database."

This tones this down a little bit, by replacing most uses of "backup"
with "export" and adding a short note that pg_dump is not a
general-purpose backup tool.

Discussion: https://www.postgresql.org/message-id/flat/70b48475-7706-4268-990d-fd522b038d96%40eisentraut.org

Files

PathChange+/−
doc/src/sgml/ref/pg_dump.sgml modified +8 −4
doc/src/sgml/ref/pg_restore.sgml modified +1 −1

Documentation touched

Discussion