Re: pg_dump/pg_dumpall help synopses and terminology

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 here (I guess it should say SQL
> script files or archives?)
> 
>     <refpurpose>
> -   restore a <productname>PostgreSQL</productname> database or cluster
> -   from an archive created by <application>pg_dump</application> or
> +   restore <productname>PostgreSQL</productname> databases from archives
> +   created by <application>pg_dump</application> or
>      <application>pg_dumpall</application>
>     </refpurpose>

The second bit is from pg_restore, which does not restore SQL script 
files, only archives.

> I don't know if there is an official definition of an archive, but I
> don't tend to think of a single script (like default pg_dumpall) as an
> archive.

I agree.

> Granted, these are just minor tightening up at best; generally +1 to
> the clean up as a whole.

Committed.  Thanks for taking a look.