Doc: document more incompatible pg_restore option pairs.

Most of the pairs of incompatible options (such as --file and --dbname)
are pretty obvious and need no explanation.  But it may not be obvious
that --single-transaction cannot be used together with --create or
multiple jobs, so let's mention that in the documentation.

Author: Ashutosh Bapat <ashutosh.bapat.oss@gmail.com>
Reviewed-by: Laurenz Albe <laurenz.albe@cybertec.at>
Discussion: https://postgr.es/m/CAExHW5ti5igDwOOde6shgfS7JPtCY9gNrkB3xNr=FuGTYVDSjQ@mail.gmail.com
This commit is contained in:
Tom Lane 2026-03-29 14:06:50 -04:00
parent e7b809ae75
commit d4cb9c3776

View file

@ -190,6 +190,11 @@ PostgreSQL documentation
<command>CREATE DATABASE</command> commands. All data is restored into the <command>CREATE DATABASE</command> commands. All data is restored into the
database name that appears in the archive. database name that appears in the archive.
</para> </para>
<para>
This option cannot be used together
with <option>--single-transaction</option>.
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -600,6 +605,8 @@ PostgreSQL documentation
ensures that either all the commands complete successfully, or no ensures that either all the commands complete successfully, or no
changes are applied. This option implies changes are applied. This option implies
<option>--exit-on-error</option>. <option>--exit-on-error</option>.
It cannot be used together with <option>--create</option>, nor with
multiple jobs (<option>--jobs</option>).
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>