From 975d3a6fc08d58538f8160c33ce8cc3ed01e062e Mon Sep 17 00:00:00 2001
From: "David G. Johnston" <David.G.Johnston@Gmail.com>
Date: Wed, 28 Jan 2026 15:07:47 -0700
Subject: [PATCH v9 2/2] diff over v8


diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index b19d30761d1..f5ce556dafd 100644
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -204,8 +204,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       For inheritance setups, a descendant column is removed only if all the
-      following are true: ONLY is not specified, no other parent defines the
-      column, and the column is not marked as having been independent.
+      following are true: <literal>ONLY</literal> is not specified, no other
+      parent defines the column, and the column is not marked as having been independent.
       Otherwise, the descendant column is instead marked as having been independent.
      </para>
     </listitem>
@@ -256,7 +256,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       in the table to change.
      </para>
      <para>
-      When applied to a partitioned table, the default value is propagated
+      When applied to a partitioned table, the default value propagates
       to all partitions unless <literal>ONLY</literal> is specified.
      </para>
     </listitem>
@@ -314,8 +314,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       is not necessary because such columns never have statistics.
      </para>
      <para>
-      When applied to a partitioned table, the generation expression is
-      propagated to all partitions unless <literal>ONLY</literal>
+      When applied to a partitioned table, the generation expression
+      propagates to all partitions unless <literal>ONLY</literal>
       is specified.
      </para>
     </listitem>
@@ -340,9 +340,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, the generation expression is
-      dropped from the partitioned table definition and from all
-      partitions. Specifying <literal>ONLY</literal> is not allowed, and
-      this command cannot be used on individual partitions.
+      removed from all partitions. Specifying <literal>ONLY</literal> is not
+      allowed, and this command cannot be used on individual partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -367,8 +366,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       notice is issued instead.
      </para>
      <para>
-      When applied to a partitioned table, the identity property is defined
-      on the partitioned table and is applied to all partitions.
+      When applied to a partitioned table, the action propagates to all partitions.
       Specifying <literal>ONLY</literal> is not allowed, and these forms
       cannot be used on individual partitions.
      </para>
@@ -386,9 +384,9 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       as <literal>INCREMENT BY</literal>.
      </para>
      <para>
-      When applied to a partitioned table, these forms alter the sequence
+      When applied to a partitioned table, these forms alter the sequences
       associated with the identity column on the partitioned table
-      and all individual partitions. Specifying <literal>ONLY</literal>
+      and those on individual partitions. Specifying <literal>ONLY</literal>
       is not allowed, and these forms cannot be used on individual
       partitions.
      </para>
@@ -416,8 +414,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       <literal>SHARE UPDATE EXCLUSIVE</literal> lock.
      </para>
      <para>
-      For partitioned tables, this action applies to the partitioned table
-      and all of its partitions unless <literal>ONLY</literal> is specified.
+      For partitioned tables, this action propagates to all partitions
+      unless <literal>ONLY</literal> is specified.
      </para>
     </listitem>
    </varlistentry>
@@ -455,8 +453,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      these forms must be applied separately to the partitioned table and/or to
-      individual partitions.
+      these forms must be applied separately to the parent table and partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -493,7 +490,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       See <xref linkend="storage-toast"/> for more information.
      </para>
      <para>
-      When applied to a partitioned table, the storage setting is propagated
+      When applied to a partitioned table, the storage setting propagates
       to all existing partitions unless <literal>ONLY</literal> is specified.
      </para>
     </listitem>
@@ -528,8 +525,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      the compression method must be applied separately to the partitioned table
-      and/or to individual partitions.
+      the compression method must be applied separately to the parent table
+      and partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -643,8 +640,8 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       this fashion, but see below.
      </para>
      <para>
-      When applied to a partitioned table, the constraint is altered on the
-      partitioned table definition and implicitly applied to all partitions.
+      When applied to a partitioned table, the constraint alterations
+      propagate to all partitions.
       Specifying <literal>ONLY</literal> is not allowed, and this command
       cannot be used on individual partitions.
      </para>
@@ -690,11 +687,10 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       This command acquires a <literal>SHARE UPDATE EXCLUSIVE</literal> lock.
      </para>
      <para>
-      When applied to a partitioned table, the constraint is validated on the
-      partitioned table and on all partitions. Unlike most constraint-related
-      sub-commands, individual partitions may validate the constraint
-      independently of the partitioned table, so long as the partitioned
-      table itself is not yet validated.
+      When applied to a partitioned table, validation propogates to all partitions.
+      Unlike most constraint-related sub-commands, individual partitions may
+      validate the constraint independently of the partitioned table,
+      so long as the partitioned table itself is not yet validated.
      </para>
     </listitem>
    </varlistentry>
@@ -710,7 +706,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, the constraint is dropped from
-      all existing partitions unless <literal>ONLY</literal> is specified.
+      all partitions unless <literal>ONLY</literal> is specified.
       Dropping an inherited constraint from an individual partition is not allowed.
      </para>
     </listitem>
@@ -787,8 +783,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      these forms must be applied separately to the partitioned table
-      and/or to individual partitions.
+      these forms must be applied separately to the parent table and individual partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -807,8 +802,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      these forms must be applied separately to the partitioned table and/or to
-      individual partitions.
+      these forms must be applied separately to the parent table and individual partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -827,8 +821,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      this form must be applied separately to the partitioned table and/or to
-      individual partitions.
+      this form must be applied separately to the parent table and individual partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -897,7 +890,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
       only the default for newly created partitions is changed.
       Specifying <literal>DEFAULT</literal> removes a previously set access method,
       causing future partitions to use <varname>default_table_access_method</varname>.
-      Individual partitions are affected just like any other regular table.
+      Individual partitions are affected just like a regular table.
      </para>
     </listitem>
    </varlistentry>
@@ -1080,8 +1073,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      this form must be applied separately to the partitioned table and/or to
-      individual partitions.
+      this form must be applied separately to the parent table and individual partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -1142,8 +1134,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
 
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      this form must be applied independently to the partitioned table and/or
-      to individual partitions.
+      this form must be applied independently to the parent table and individual partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -1183,8 +1174,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
      </para>
      <para>
       When applied to a partitioned table, <literal>ONLY</literal> is implicit,
-      this form must be applied independently to the partitioned table and/or
-      to individual partitions.
+      this form must be applied independently to the parent table and individual partitions.
      </para>
     </listitem>
    </varlistentry>
@@ -1575,7 +1565,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
         Note that for partitioned tables, <literal>ONLY</literal> does not control
         recursion for all <command>ALTER TABLE</command> actions. Some actions
         apply only to the partitioned table itself, regardless of whether
-        <literal>ONLY</literal> is specified, while others are propagated to
+        <literal>ONLY</literal> is specified, while others propagate to
         partitions. The exact behavior depends on the specific action being
         performed.
        </para>
-- 
2.43.0

