postgres.git / summary / log / commit / refs

commit    d4cb9c37765a3d07784602679a1e7af7ecf15f1d
Author:   Tom Lane <tgl@sss.pgh.pa.us>
Date:     Sun Mar 29 18:06:50 2026 +0000

    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


 doc/src/sgml/ref/pg_restore.sgml | 7 +++++++
 1 file changed, 7 insertions(+)

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


[parent: e7b809ae7586]