doc: PG 12 wording improvments

Reported-by: Justin Pryzby
Discussion: https://postgr.es/m/20190510001335.GJ3925@telsasoft.com

diff --git a/doc/src/sgml/release-12.sgml b/doc/src/sgml/release-12.sgml
index 54f66e13dca79ed3560fa164a3cc31c016846239..ef761c9c4b29a2f1af09d436885c2d39138aa614 100644 (file)
--- a/doc/src/sgml/release-12.sgml
+++ b/doc/src/sgml/release-12.sgml
@@ -119,7 +119,7 @@ Do not allow multiple different recovery_target* specifications (Peter Eisentrau
 </para>
 
 <para>
-Previously multiple different recovery_target* variables could be specified, and the last one specified was honored.  Now, only one can be specified, though the same one can
+Previously, multiple different recovery_target* variables could be specified, and the last one specified was honored.  Now, only one can be specified, though the same one can
 be specified multiple times and the last specification is honored.
 </para>
 </listitem>
@@ -131,7 +131,7 @@ Author: Peter Eisentraut <peter@eisentraut.org>
 -->
 
 <para>
-Cause recovery to recover to the latest timeline by default (Peter Eisentraut)
+Cause recovery to advance to the latest timeline by default (Peter Eisentraut)
 </para>
 
 <para>
@@ -204,7 +204,7 @@ Change XML functions like xpath() to never pretty-print their output (Tom Lane)
 </para>
 
 <para>
-Previously this happened in some rare cases.  ACCURATE?  HOW TO GET PRETTY PRINT OUTPUT?
+Previously, this happened in some rare cases.  ACCURATE?  HOW TO GET PRETTY PRINT OUTPUT?
 </para>
 </listitem>
 
@@ -226,7 +226,7 @@ Author: Alvaro Herrera <alvherre@alvh.no-ip.org>
 -->
 
 <para>
-Require pg_restore to use "-f -" to output the dump contents to stdout (Euler Taveira)
+Require specification of "-f -" to send the dump contents to stdout (Euler Taveira)
 </para>
 
 <para>
@@ -400,7 +400,7 @@ Allow partitions bounds to be any expression (Kyotaro Horiguchi, Tom Lane, Amit
 </para>
 
 <para>
-Expressions are evaluated at table partitioned table creation time.  Previously only constants were allowed as partitions bounds.
+Expressions are evaluated at table partitioned table creation time.  Previously, only constants were allowed as partitions bounds.
 </para>
 </listitem>
 
@@ -531,7 +531,7 @@ Allow parallel query when in SERIALIZABLE isolation mode (Thomas Munro)
 </para>
 
 <para>
-Previously parallelism was disabled when in this mode.
+Previously, parallelism was disabled when in this mode.
 </para>
 </listitem>
 
@@ -824,7 +824,7 @@ Store statistics using the collation defined for each column (Tom Lane)
 </para>
 
 <para>
-Previously the default collation was used for all statistics storage.  This potentially gives better optimizer behavior for columns with non-default collations.
+Previously, the default collation was used for all statistics storage.  This potentially gives better optimizer behavior for columns with non-default collations.
 </para>
 </listitem>
 
@@ -1093,7 +1093,7 @@ Add tracking of global objects in system view pg_stat_database (Julien Rouhaud)
 </para>
 
 <para>
-The system view row's datoid is reported as zero.
+Global objects have a pg_stat_database.datoid value of zero.
 </para>
 </listitem>
 
@@ -1149,7 +1149,7 @@ Author: Peter Eisentraut <peter@eisentraut.org>
 -->
 
 <para>
-Allow viewers of pg_stat_ssl to only see their own rows (Peter Eisentraut)
+Restrict visibility of rows in pg_stat_ssl by unprivileged users (Peter Eisentraut)
 </para>
 </listitem>
 
@@ -1233,7 +1233,7 @@ Author: Tom Lane <tgl@sss.pgh.pa.us>
 -->
 
 <para>
-Allow more comparisons with information_schema text columns to use indexes (Tom Lane)
+Allow more use of indexes for text columns comparisons with information_schema columns (Tom Lane)
 </para>
 </listitem>
 
@@ -1297,7 +1297,7 @@ Author: Magnus Hagander <magnus@hagander.net>
 -->
 
 <para>
-Allow the clientcert pg_hba.conf option to check the database user name matches the certificate common name (Julian Markwort, Marius Timmer)
+Allow the clientcert pg_hba.conf option to check that the database user name matches the certificate common name (Julian Markwort, Marius Timmer)
 </para>
 
 <para>
@@ -1545,7 +1545,7 @@ Allow the streaming replication timeout to be set per connection (Tsunakawa Taka
 </para>
 
 <para>
-Previously this could only be set cluster-wide.
+Previously, this could only be set cluster-wide.
 </para>
 </listitem>
 
@@ -1840,7 +1840,7 @@ Use all column names when creating default foreign key constraint names (Peter E
 </para>
 
 <para>
-Previously only the first column name was used.
+Previously, only the first column name was used.
 </para>
 </listitem>
 
@@ -2344,7 +2344,7 @@ Allow control of log file rotation via pg_ctl (Kyotaro Horiguchi, Alexander Kuzm
 </para>
 
 <para>
-Previously this was only possible via an SQL function or a process signal.
+Previously, this was only possible via an SQL function or a process signal.
 </para>
 </listitem>
 
@@ -2729,7 +2729,7 @@ Properly honor WITH CHECK OPTION on views that reference postgres_fdw tables (Et
 
 <para>
 While CHECK OPTIONs on postgres_fdw tables are ignored (because the reference is foreign), views on such tables are considered local, so this release enforces CHECK
-OPTIONs on them.  Previously only INSERTs and UPDATEs with RETURNING clauses that returned CHECK OPTION values were validated.
+OPTIONs on them.  Previously, only INSERTs and UPDATEs with RETURNING clauses that returned CHECK OPTION values were validated.
 </para>
 </listitem>