From: Peter Eisentraut <peter_e@gmx.net>
Date: Tue, 2 May 2017 14:34:49 +0000 (-0400)
Subject: doc: Update ALTER SEQUENCE claims about changes being nontransactional
X-Git-Tag: REL_10_BETA1~121
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a35ac7c4e3ccf93876b4652d94a418fc82e0eda3;p=postgresql

doc: Update ALTER SEQUENCE claims about changes being nontransactional

Clarify that all changes except RESTART are transactional (since
1753b1b027035029c2a2a1649065762fafbf63f3).

Reported-by: Michael Paquier <michael.paquier@gmail.com>
---

diff --git a/doc/src/sgml/ref/alter_sequence.sgml b/doc/src/sgml/ref/alter_sequence.sgml
index 5c912ab892..3fb3400d6b 100644
--- a/doc/src/sgml/ref/alter_sequence.sgml
+++ b/doc/src/sgml/ref/alter_sequence.sgml
@@ -180,6 +180,14 @@ ALTER SEQUENCE [ IF EXISTS ] <replaceable class="parameter">name</replaceable> S
         the start value that was recorded by <command>CREATE SEQUENCE</>
         or last set by <command>ALTER SEQUENCE START WITH</>.
        </para>
+
+       <para>
+        Like a <function>setval</function> call, a <literal>RESTART</literal>
+        operation on a sequence is never rolled back, to avoid blocking of
+        concurrent transactions that obtain numbers from the same sequence.
+        (The other clauses cause ordinary catalog updates that can be rolled
+        back.)
+       </para>
       </listitem>
      </varlistentry>
 
@@ -281,15 +289,6 @@ ALTER SEQUENCE [ IF EXISTS ] <replaceable class="parameter">name</replaceable> S
  <refsect1>
   <title>Notes</title>
 
-  <para>
-   To avoid blocking of concurrent transactions that obtain numbers from the
-   same sequence, <command>ALTER SEQUENCE</command>'s effects on the sequence
-   generation parameters are never rolled back; those changes take effect
-   immediately and are not reversible.  However, the <literal>OWNED BY</>,
-   <literal>OWNER TO</>, <literal>RENAME TO</>, and <literal>SET SCHEMA</>
-   clauses cause ordinary catalog updates that can be rolled back.
-  </para>
-
   <para>
    <command>ALTER SEQUENCE</command> will not immediately affect
    <function>nextval</> results in backends,