diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml
index 3c1223b3243..4df3d756de7 100644
--- 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 .
@@ -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.