doc: update PG 11 release notes, mostly typo fixes

bmomjian · bmomjian · commit 2d502b81289f · 2018-06-23T17:15:34.000-04:00
Discussion: https://postgr.es/m/CAJnrtny0mYCMoRanZ1wvGqcPV-UDBoPetavDM1SqxnGVfZRV3g@mail.gmail.com Author: Brad DeJong
diff --git a/doc/src/sgml/release-11.sgml b/doc/src/sgml/release-11.sgml
@@ -1315,7 +1315,7 @@ same commits as above
 -->
 
        <para>
-        Add default roles which controls file system access (Stephen Frost)
+        Add default roles which control file system access (Stephen Frost)
        </para>
 
        <para>
@@ -1325,7 +1325,7 @@ same commits as above
         <literal>pg_execute_server_program</literal>.  These roles now also
         control who can use <command>COPY</command> and extension <link
         linkend="file-fdw"><application>file_fdw</application></link>.
-        Previously only super-users could use these functions, and that
+        Previously only superusers could use these functions, and that
         is still the default behavior.
        </para>
       </listitem>
@@ -1338,7 +1338,7 @@ same commits as above
        <para>
         Allow access to file system functions to be controlled by
         <command>GRANT</command>/<command>REVOKE</command> permissions,
-        rather than super-user checks (Stephen Frost)
+        rather than superuser checks (Stephen Frost)
        </para>
 
        <para>
@@ -1364,7 +1364,7 @@ same commits as above
        </para>
 
        <para>
-        Previously super users were exclusively granted to access these
+        Previously, superusers were exclusively granted access to these
         functions.
        </para>
 
@@ -1387,10 +1387,10 @@ same commits as above
        </para>
 
        <para>
-        <productname>PostgreSQL</productname> only allows super-users to
+        <productname>PostgreSQL</productname> only allows superusers to
         access <application>postgres_fdw</application> tables without
         passwords, e.g. via <literal>peer</literal>.  Previously the
-        session owner had to be a super-user to allow such access;  now
+        session owner had to be a superuser to allow such access;  now
         the view owner is checked instead.
        </para>
       </listitem>
@@ -1424,7 +1424,7 @@ same commits as above
        <para>
         Add server setting <link
         linkend="guc-ssl-passphrase-command"><varname>ssl_passphrase_command</varname></link>
-        to allow supplying of the the passphrase for <acronym>SSL</acronym>
+        to allow supplying of the passphrase for <acronym>SSL</acronym>
         key files (Peter Eisentraut)
        </para>
 
@@ -1467,7 +1467,7 @@ same commits as above
 
        <para>
         The new unit is "B".  This is in addition to "kB", "MB", "GB"
-        and "TB", which were accepted previously.
+        and "TB".
        </para>
 
       </listitem>
@@ -1567,7 +1567,7 @@ same commits as above
 -->
 
        <para>
-        Exclude unlogged, temporary tables, and
+        Exclude unlogged tables, temporary tables, and
         <filename>pg_internal.init</filename> files from streaming base
         backups (David Steele)
        </para>
@@ -1726,8 +1726,8 @@ same commits as above
 
        <para>
         Also, if any table mentioned in <command>VACUUM</command> uses
-        a column list, then <command>ANALYZE</command> keyword must be
-        supplied;  previously <command>ANALYZE</command> was implied in
+        a column list, then the <command>ANALYZE</command> keyword must be
+        supplied; previously, <command>ANALYZE</command> was implied in
         such cases.
        </para>
       </listitem>
@@ -1760,7 +1760,7 @@ same commits as above
        </para>
 
        <para>
-        This is useful for allowing aggregate functions be optimized and
+        This is useful for allowing aggregate functions to be optimized and
         to work as window functions.
        </para>
 
@@ -1803,7 +1803,7 @@ same commits as above
        </para>
 
        <para>
-        Also allow PL/PL/Perl, PL/Python, and PL/Tcl to handle
+        Also allow PL/Perl, PL/Python, and PL/Tcl to handle
         composite-domain function arguments and results.  Also improve
         PL/Python domain handling.
        </para>
@@ -1896,7 +1896,7 @@ same commits as above
        <para>
         Add text search function <link
         linkend="textsearch-functions-table"><function>websearch_to_tsquery()</function></link>
-        that supports a queries syntax similar to that used by web search
+        that supports a query syntax similar to that used by web search
         engines (Victor Drobny, Dmitry Ivanov)
        </para>
       </listitem>
@@ -1909,7 +1909,7 @@ same commits as above
        <para>
         Add function <link
         linkend="textsearch-functions-table"><function>json(b)_to_tsvector()</function></link>
-        to create text search query for matching
+        to create a text search query for matching
         <type>JSON</type>/<type>JSONB </type>values (Dmitry Dolgov)
        </para>
 
@@ -2309,7 +2309,7 @@ same commits as above
 -->
 
        <para>
-        Add approximated Zipfian-distributed random generator to
+        Add an approximated Zipfian-distributed random generator to
         <application>pgbench</application> (Alik Khilazhev)
        </para>
       </listitem>
@@ -2379,16 +2379,16 @@ same commits as above
 -->
 
        <para>
-        Add <link
+        Add an option to <link
         linkend="app-pgbasebackup"><application>pg_basebackup</application></link>
-        option to create a named replication slot (Michael Banck)
+        that creates a named replication slot (Michael Banck)
        </para>
 
        <para>
         The option <option>--create-slot</option> creates
         the named replication slot (<option>--slot</option>)
         when the <acronym>WAL</acronym> streaming method
-        (<option>-wal-method=stream</option>) is used.
+        (<option>--wal-method=stream</option>) is used.
        </para>
 
        <para>
@@ -2560,7 +2560,7 @@ same commits as above
        </para>
 
        <para>
-        This is useful if the system to be loaded has a different collation
+        This is useful if the system to be loaded has different collation
         definitions or endianness, requiring the rows to be stored in
         different partitions.
        </para>
@@ -2572,7 +2572,7 @@ same commits as above
 -->
 
        <para>
-        Add ability to suppress dumping and restoring of comments
+        Add an option to suppress dumping and restoring comments
         (Robins Tharakan)
        </para>
 
@@ -2884,7 +2884,7 @@ same commits as above
        </para>
 
        <para>
-        Previously only super-users could call adminpack functions;
+        Previously only superusers could call adminpack functions;
         now role permissions are checked.
        </para>
       </listitem>
