`pg_restore --if-exists` clarification - Mailing list pgsql-docs

From PG Doc comments form
Subject `pg_restore --if-exists` clarification
Date
Msg-id 169590536647.3727336.11070254203649648453@wrigleys.postgresql.org
Whole thread Raw
Responses Re: `pg_restore --if-exists` clarification
List pgsql-docs
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/app-pgrestore.html
Description:

Good Morning,

In the `pg_restore` docs
(https://www.postgresql.org/docs/current/app-pgrestore.html), `--if-exists`
states that it is to

> Use conditional commands (i.e., add an IF EXISTS clause) 
> to drop database objects. This option is not valid unless 
> --clean is also specified.", but not being a SQL expert, 
> I'm having a hard time deciphering this.

Suggestion: Would you consider adding the sentence (or something similar)?

> "--clean makes pg_restore drop all objects first,
> and --if-exists prevents that non-existent objects
> cause a failure." 
Source: https://stackoverflow.com/a/75136163/1498178

This is succinct, and tells exactly what one needs to know. Thank you and
have a great day!

Appreciatively,
Attila

pgsql-docs by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: Hyperlinks for source file references
Next
From: Bruce Momjian
Date:
Subject: Re: Make SSPI documentation clearer