Doc: copy-editing for CREATE INDEX reference page.

Justin Pryzby, Jonathan S. Katz, and myself.

Discussion: https://postgr.es/m/20181006134249[email protected]

diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml
index 3c1223b32432d883acd974eb5cda79909c334440..4df3d756de7e50f5c376b60d14e78abd0391fdd7 100644 (file)
--- a/doc/src/sgml/ref/create_index.sgml
+++ b/doc/src/sgml/ref/create_index.sgml
@@ -612,11 +612,12 @@ Indexes:
 
    
     Regular index builds permit other regular index builds on the
-    same table to occur in parallel, but only one concurrent index build
-    can occur on a table at a time.  In both cases, no other types of schema
-    modification on the table are allowed meanwhile.  Another difference
-    is that a regular CREATE INDEX command can be performed within
-    a transaction block, but CREATE INDEX CONCURRENTLY cannot.
+    same table to occur simultaneously, but only one concurrent index build
+    can occur on a table at a time.  In either case, schema modification of the
+    table is not allowed while the index is being built.  Another difference is
+    that a regular CREATE INDEX command can be performed
+    within a transaction block, but CREATE INDEX CONCURRENTLY
+    cannot.
    
   
  
@@ -650,7 +651,7 @@ Indexes:
    ordering. For example, we might want to sort a complex-number data
    type either by absolute value or by real part. We could do this by
    defining two operator classes for the data type and then selecting
-   the proper class when making an index.  More information about
+   the proper class when creating an index.  More information about
    operator classes is in  and in 
    linkend="xindex"/>.
   
@@ -668,12 +669,13 @@ Indexes:
    will be determined as if no index name had been specified in the
    command.
    If the ONLY option is specified, no recursion
-   is done, and the index is marked invalid
-   (ALTER INDEX ... ATTACH PARTITION turns the index
-   valid, once all partitions acquire the index.)  Note, however, that
-   any partition that is created in the future using
+   is done, and the index is marked invalid.
+   (ALTER INDEX ... ATTACH PARTITION marks the index
+   valid, once all partitions acquire matching indexes.)  Note, however,
+   that any partition that is created in the future using
    CREATE TABLE ... PARTITION OF will automatically
-   contain the index regardless of whether this option was specified.
+   have a matching index, regardless of whether ONLY is
+   specified.