Doc: update v13 release notes through today, do a copy-editing pass.
authorTom Lane
Thu, 10 Sep 2020 21:43:16 +0000 (17:43 -0400)
committerTom Lane
Thu, 10 Sep 2020 21:43:16 +0000 (17:43 -0400)
Also set the release date ... hopefully we won't have to change that.

doc/src/sgml/release-13.sgml

index afeec3e953e8e3b020e030b4df72271bd89e2871..0d2a928e0ed5bd16229345c1d3bca8e67f6d92e4 100644 (file)
@@ -6,7 +6,7 @@
 
   
    Release date:
-   2020-XX-XX, CURRENT AS OF 2020-08-09
+   2020-09-24
   
 
   
@@ -88,10 +88,13 @@ Author: Tom Lane 
 
      
       This new behavior matches the SQL specification.
-      Previously this caused the escape to be set to the default backslash
-      character.  The previous behavior has been retained in old views
-      by keeping the original function unchanged.  This also applies to
-      substring(text FROM pattern ESCAPE text).
+      Previously a null ESCAPE value was taken to mean
+      using the default escape string (a backslash character).  This also
+      applies to substring(text
+      FROM pattern
+      ESCAPE text).  The previous
+      behavior has been retained in old views by keeping the original
+      function unchanged.
      
     
 
@@ -102,21 +105,10 @@ Author: Tom Lane 
 -->
 
      
-      Have 
-      linkend="textsearch-functions-table">jsonb_to_tsvector()
-      properly check "string" parameter (Dominik Czarnota)
-     
-    
-
-    
-
-
-     
-      In , when using adjacent asterisks with braces,
-      e.g., ".*{2}.*{3}", properly interpret that as ".*{5}" (Nikita Glukhov)
+      Make 
+      linkend="textsearch-functions-table">json[b]_to_tsvector()
+      fully check the spelling of its string option
+      (Dominik Czarnota)
      
     
 
@@ -133,13 +125,13 @@ Author: Thomas Munro 
      
 
      
-      Previously, this value was adjusted before effecting the number of
-      concurrent requests.  This value is now used directly.  Conversion of
+      Previously, this value was adjusted before setting the number of
+      concurrent requests.  The value is now used directly.  Conversion of
       old values to new ones can be done using:
      
 
 
-SELECT round(sum(OLD / n::float)) FROM generate_series(1, OLD) s(n);
+SELECT round(sum(OLDVALUE / n::float)) FROM generate_series(1, OLDVALUE) s(n);
 
     
 
@@ -192,7 +184,7 @@ Author: Fujii Masao 
      
 
      
-      Previously it returned ALTER TABLE, but now returns
+      Previously it returned ALTER TABLE; now it returns
       ALTER FOREIGN TABLE.
      
     
@@ -210,7 +202,7 @@ Author: Fujii Masao 
      
 
      
-      Previously it returned ALTER TABLE, but now returns
+      Previously it returned ALTER TABLE; now it returns
       ALTER MATERIALIZED VIEW.
      
     
@@ -227,8 +219,9 @@ Author: Fujii Masao 
      
 
      
-      This determines how much WAL to retain for the standby server,
-      specified in megabytes rather than number of files. If you
+      This determines how much WAL to retain for standby servers.
+      It is specified in megabytes, rather than number of files as with
+      the old parameter. If you
       previously used wal_keep_segments,
       the following formula will give you an approximately equivalent setting:
 
@@ -306,6 +299,20 @@ Author: Tom Lane 
 
     
 
+
+     
+      In , when an lquery pattern
+      contains adjacent asterisks with braces,
+      e.g., *{2}.*{3}, properly interpret that
+      as *{5} (Nikita Glukhov)
+     
+    
+
+    
+
@@ -347,8 +354,8 @@ Author: Alvaro Herrera 
 -->
 
        
-        Improve cases where 
-        linkend="ddl-partition-pruning">pruning of partitions can happen
+        Allow pruning of
+        partitions to happen in more cases
         (Yuzuko Hosoya, Amit Langote, Álvaro Herrera)
        
       
@@ -380,13 +387,14 @@ Author: Alvaro Herrera 
 -->
 
        
-        Allow BEFORE row-level 
+        Support row-level BEFORE 
         linkend="triggers">triggers on partitioned tables (Álvaro
         Herrera)
        
 
        
-        These triggers cannot change which partition is the destination.
+        However, such a trigger is not allowed to change which partition
+        is the destination.
        
       
 
@@ -404,14 +412,15 @@ Author: Peter Eisentraut 
        
 
        
-        Previously, partitions had to be replicated individually.  Now
-        partitioned tables can be published explicitly causing all partitions
-        to be automatically published.  Addition/removal of partitions from
-        partitioned tables are automatically added/removed from publications.
+        Previously, partitions had to be replicated individually.  Now a
+        partitioned table can be published explicitly, causing all its
+        partitions to be published automatically.  Addition/removal of a
+        partition causes it to be likewise added to or removed from the
+        publication.
         The CREATE
         PUBLICATION option
         publish_via_partition_root controls whether changes
-        to partitions are published as their own or their ancestor's.
+        to partitions are published as their own changes or their parent's.
        
       
 
@@ -439,8 +448,9 @@ Author: Tom Lane 
 -->
 
        
-        Allow ROW values
-        to be used as partitioning expressions (Amit Langote)
+        Allow whole-row variables (that
+        is, table.*) to be
+        used in partitioning expressions (Amit Langote)
        
       
 
@@ -461,17 +471,17 @@ Author: Peter Geoghegan 
 
        
         More efficiently store 
-        linkend="btree-deduplication">duplicates in btree indexes
+        linkend="btree-deduplication">duplicates in B-tree indexes
         (Anastasia Lubennikova, Peter Geoghegan)
        
 
        
-        This allows efficient btree indexing of low cardinality columns
+        This allows efficient B-tree indexing of low-cardinality columns
         by storing duplicate keys only once.  Users upgrading with 
         linkend="pgupgrade">pg_upgrade
         will need to use 
-        linkend="sql-reindex">REINDEX to make use
-        of this feature.
+        linkend="sql-reindex">REINDEX to make an
+        existing index use this feature.
        
       
 
@@ -485,8 +495,9 @@ Author: Alexander Korotkov 
 
        
         Allow GiST and 
-        linkend="spgist">SP-GiST indexes for 
-        linkend="datatype-line">box/point distance lookups (Nikita
+        linkend="spgist">SP-GiST indexes on box
+        columns to support ORDER BY box
+        <-> point queries (Nikita
         Glukhov)
        
       
@@ -499,7 +510,8 @@ Author: Alexander Korotkov 
 
        
         Allow GIN indexes to
-        more efficiently handle NOT restrictions (Nikita
+        more efficiently handle ! (NOT) clauses
+        in tsquery searches (Nikita
         Glukhov, Alexander Korotkov, Tom Lane, Julien Rouhaud)
        
       
@@ -549,8 +561,9 @@ Author: Tom Lane 
        
 
        
-        The index and column collations must now match so the index's
-        uniqueness matches the column's uniqueness.
+        The index's collation must match that of the underlying column,
+        but ALTER TABLE previously failed to check
+        this.
        
       
 
@@ -584,7 +597,7 @@ Author: Tomas Vondra 
 -->
 
        
-        Allow setting statistics target
+        Allow setting the statistics target
         for extended statistics
         (Tomas Vondra)
        
@@ -636,8 +649,8 @@ Author: Tom Lane 
 -->
 
        
-        Allow functions in FROM clauses to be moved to their
-        reference sites if they evaluate to constants (Alexander Kuzmenkov,
+        Allow functions in FROM clauses to be pulled up
+        (inlined) if they evaluate to constants (Alexander Kuzmenkov,
         Aleksandr Parfenov)
        
       
@@ -665,9 +678,15 @@ Author: Peter Eisentraut 
        
 
        
-        If a result is already sorted by several leading keys, this
-        allows for batch sorting of additional trailing keys because the
-        previous keys are already equal.  This is controlled by 
+        If an intermediate query result is known to be sorted by
+        one or more leading keys of a required sort ordering, the
+        additional sorting can be done considering only the remaining
+        keys, if the rows are sorted in batches that have equal leading
+        keys.
+       
+
+       
+        If necessary, this can be controlled using 
         linkend="guc-enable-incremental-sort"/>.
        
       
@@ -696,7 +715,6 @@ Author: Peter Geoghegan 
 
        
         Allow hash aggregation
-        and grouping sets
         to use disk storage for large aggregation result sets (Jeff Davis)
        
 
@@ -709,9 +727,11 @@ Author: Peter Geoghegan 
        
 
        
-        This behavior is normally preferable to the old behavior.  But if
-        it is inferior for a particular query, behavior similar to
-        previous Postgres releases can be obtained by
+        This behavior is normally preferable to the old behavior, in which
+        once hash aggregation had been chosen, the hash table would be
+        kept in memory no matter how large it got — which could be
+        very large if the planner had misestimated.  If necessary,
+        behavior similar to that can be obtained by
         increasing hash_mem_multiplier.
        
       
@@ -723,14 +743,16 @@ Author: David Rowley 
 -->
 
        
-        Allow inserts to trigger autovacuum
-        activity (Laurenz Albe, Darafei Praliaskouski)
+        Allow inserts, not only updates and deletes, to
+        trigger autovacuum activity
+        (Laurenz Albe, Darafei Praliaskouski)
        
 
        
-        This new behavior reduces the work necessary when the table needs to
-        be frozen and allows pages to be set as all-visible.  All-visible pages
-        allow index-only scans to access fewer heap rows.
+        This new behavior reduces the work that will be necessary later
+        when the table needs to be frozen, and it allows pages to be
+        marked as all-visible sooner.  All-visible pages allow index-only
+        scans to access fewer heap rows.
        
       
 
@@ -770,24 +792,12 @@ Author: Noah Misch 
 
       
 
-
-       
-        Enable Unix-domain sockets
-        support on Windows (Peter Eisentraut)
-       
-      
-
-      
-
 
        
-        Improve the performance when replaying 
+        Improve performance when replaying 
         linkend="sql-dropdatabase">DROP DATABASE
         commands when many tablespaces are in use (Fujii Masao)
        
@@ -812,16 +822,16 @@ Author: Tomas Vondra 
 -->
 
        
-        Improve speed of 
-        linkend="storage-toast">TOAST decompression
-        and the retrieval of only the leading bytes of TOAST
-        values (Binguo Bao, Andrey Borodin)
+        Improve retrieval of the leading bytes of 
+        linkend="storage-toast">TOAST'ed values
+        (Binguo Bao, Andrey Borodin)
        
 
        
-        Previously, TOAST values were fully fetched and
-        only the requested leading bytes were decompressed and returned.
-        Now, only the requested bytes are fetched.
+        Previously, compressed out-of-line TOAST values
+        were fully fetched even when it's known that only some leading
+        bytes are needed.  Now, only enough data to produce the result is
+        fetched.
        
       
 
@@ -831,24 +841,14 @@ Author: Tom Lane 
 2019-09-10 [bca6e6435] Reduce overhead of scanning the backend[] array in LISTE
 Author: Tom Lane 
 2019-09-22 [51004c717] Make some efficiency improvements in LISTEN/NOTIFY.
--->
-
-       
-        Improve performance of 
-        linkend="sql-listen">LISTEN/NOTIFY
-        (Martijn van Oosterhout)
-       
-      
-
-      
-
 
        
-        Improve the efficiency of removing duplicate 
-        linkend="sql-notify">NOTIFY events (Tom Lane)
+        Improve performance of 
+        linkend="sql-listen">LISTEN/NOTIFY
+        (Martijn van Oosterhout, Tom Lane)
        
       
 
@@ -859,7 +859,7 @@ Author: Andrew Gierth 
 -->
 
        
-        Use lookup tables to speed up integer to text conversion (David Fetter)
+        Speed up conversions of integers to text (David Fetter)
        
       
 
@@ -870,8 +870,8 @@ Author: Tom Lane 
 -->
 
        
-        Reduce memory usage for query strings that contain multiple
-        SQL statements (Amit Langote)
+        Reduce memory usage for query strings and extension scripts that
+        contain many SQL statements (Amit Langote)
        
       
 
@@ -910,13 +910,15 @@ Author: Tomas Vondra 
 -->
 
        
-        Allow a sample of statements to be logged (Adrien Nayrat)
+        Allow a sample of SQL statements, rather than all statements, to
+        be logged (Adrien Nayrat)
        
 
        
-        A  ratio of statements
-        taking over  duration
-        will be logged.
+        A  fraction of
+        those statements taking more than
+         duration will be
+        logged.
        
       
 
@@ -949,22 +951,10 @@ Author: Tom Lane 
        
         The GUC setting 
         linkend="guc-log-parameter-max-length"/> controls the maximum length
-        of parameter values output during statement non-error logging, and
-         does the
-        same for error statement logging.  Previously, prepared statement
-        parameters were not logged during errors.
-       
-      
-
-      
-
-
-       
-        Make vacuum buffer counters 64-bits
-        wide to avoid overflow (Álvaro Herrera)
+        of parameter values output during logging of non-error statements,
+        while  does
+        the same for logging of statements with errors.  Previously,
+        prepared statement parameters were never logged during errors.
        
       
 
@@ -977,31 +967,25 @@ Author: Peter Eisentraut 
 -->
 
        
-        Allow function call backtraces of errors to be logged (Peter
+        Allow function call backtraces to be logged after errors (Peter
         Eisentraut, Álvaro Herrera)
        
 
        
-        Server variable  specifies
+        The new parameter  specifies
         which C functions should generate backtraces on error.
        
       
 
       
 
 
        
-        Add min() and
-        max() aggregates for 
-        linkend="datatype-pg-lsn">pg_lsn (Fabrízio
-        de Royes Mello)
-       
-
-       
-        This is useful for monitoring queries.
+        Make vacuum buffer counters 64-bits
+        wide to avoid overflow (Álvaro Herrera)
        
       
 
@@ -1049,7 +1033,7 @@ Author: Alvaro Herrera 
        
         Add system view 
         linkend="monitoring-stats-dynamic-views-table">pg_stat_progress_analyze
-        to report analyze progress
+        to report ANALYZE progress
         (Álvaro Herrera, Tatsuro Yamada, Vinayak Pokale)
        
       
@@ -1074,9 +1058,9 @@ Author: Tomas Vondra 
 -->
 
        
-        Create 
+        Add system view 
         linkend="monitoring-stats-views-table">pg_stat_slru
-        system view to monitor internal SLRU caches
+        to monitor internal SLRU caches
         (Tomas Vondra)
        
       
@@ -1088,8 +1072,8 @@ Author: Robert Haas 
 -->
 
        
-        Allow  to be set up
-        to 1MB (Vyacheslav Makarov)
+        Allow  to be set as
+        high as 1MB (Vyacheslav Makarov)
        
 
        
@@ -1113,8 +1097,8 @@ Author: Thomas Munro 
 -->
 
        
-        Add wait event for posix_fallocate() (Thomas
-        Munro)
+        Report a wait event while creating a DSM segment
+        with posix_fallocate() (Thomas Munro)
        
       
 
@@ -1187,7 +1171,7 @@ Author: Fujii Masao 
 -->
 
        
-        Only allow superusers to view the 
+        Allow only superusers to view the 
         linkend="guc-ssl-passphrase-command"/> setting (Insung Moon)
        
 
@@ -1208,7 +1192,8 @@ Author: Peter Eisentraut 
        
 
        
-        This is controlled by .
+        This choice can be controlled by
+        .
        
       
 
@@ -1228,13 +1213,13 @@ Author: Robert Haas 
 -->
 
        
-        Tighten rules on which utility commands are possible in 
-        linkend="guc-default-transaction-read-only"/> mode (Robert Haas)
+        Tighten rules on which utility commands are allowed in
+        read-only transaction mode (Robert Haas)
        
 
        
-        This also increases the number of utility commands that can run in
-        parallel queries.
+        This change also increases the number of utility commands that can
+        run in parallel queries.
        
       
 
@@ -1269,6 +1254,18 @@ Author: Peter Eisentraut 
        
       
 
+      
+
+
+       
+        Enable Unix-domain sockets
+        support on Windows (Peter Eisentraut)
+       
+      
+
      
 
     
@@ -1307,8 +1304,9 @@ Author: Alvaro Herrera 
 -->
 
       
-       Allow WAL receivers use a temporary replication slot
-       if a permanent one is not specified (Peter Eisentraut, Sergei Kornilov)
+       Allow WAL receivers to use a temporary
+       replication slot when a permanent one is not specified (Peter
+       Eisentraut, Sergei Kornilov)
       
 
       
@@ -1324,12 +1322,13 @@ Author: Alvaro Herrera 
 -->
 
       
-       Allow replication slot storage to be limited by 
-       linkend="guc-max-slot-wal-keep-size"/> (Kyotaro Horiguchi)
+       Allow WAL storage for replication slots to be limited by
+       linkend="guc-max-slot-wal-keep-size"/> (Kyotaro Horiguchi)
       
 
       
-       Replication slots that exceed this value are invalidated.
+       Replication slots that would require exceeding this value are
+       marked invalid.
       
      
 
@@ -1363,8 +1362,8 @@ Author: Peter Eisentraut 
       
 
       
-       Previously, the end of the WAL would promote the
-       standby, even if the target was not reached.
+       Previously, a standby would promote itself upon reaching the end
+       of WAL, even if the target was not reached.
       
      
 
@@ -1458,10 +1457,10 @@ Author: Tom Lane 
 -->
 
       
-       HavCREATE TABLE
-       LIKE propagate CHECK's NO
-       INHERIT property to created tables (Ildar Musin, Chris
-       Travers)
+       MakCREATE TABLE
+       LIKE propagate CHECK
+       constraint's NO INHERIT property to the created
+       table (Ildar Musin, Chris Travers)
       
      
 
@@ -1498,8 +1497,9 @@ Author: Peter Eisentraut 
 
       
        Add ALTER
-       TABLE clause DROP EXPRESSION
-       to remove generated properties from columns (Peter Eisentraut)
+       TABLE ... DROP EXPRESSION
+       to allow removing the GENERATED
+       property from a column (Peter Eisentraut)
       
      
 
@@ -1510,8 +1510,16 @@ Author: Tom Lane 
 -->
 
       
-       Fix bugs in ALTER TABLE when later clauses overlap
-       changes made by earlier clauses in the same command (Tom Lane)
+       Fix bugs in multi-step ALTER TABLE commands (Tom
+       Lane)
+      
+
+      
+       IF NOT EXISTS clauses now work as expected, in
+       that derived actions (such as index creation) do not execute if the
+       column already exists.  Also, certain cases of combining related
+       actions into one ALTER TABLE now work when they
+       did not before.
       
      
 
@@ -1527,8 +1535,9 @@ Author: Fujii Masao 
       
 
       
-       This was previously possible only using ALTER TABLE RENAME
-       COLUMN.
+       Renaming view columns was already possible, but one had to
+       write ALTER TABLE RENAME COLUMN, which is
+       confusing.
       
      
 
@@ -1540,8 +1549,8 @@ Author: Tom Lane 
 
       
        Add ALTER TYPE
-       options useful for extensions, like TOAST and I/O
-       functions control (Tomas Vondra, Tom Lane)
+       options to modify a base type's TOAST properties
+       and support functions (Tomas Vondra, Tom Lane)
       
      
 
@@ -1558,7 +1567,7 @@ Author: Peter Eisentraut 
       
 
       
-       This combines existing options LC_COLLATE and
+       This combines the existing options LC_COLLATE and
        LC_CTYPE into a single option.
       
      
@@ -1571,12 +1580,12 @@ Author: Amit Kapila 
 
       
        Allow DROP
-       DATABASE to disconnect users so drop succeeds (Pavel
-       Stehule, Amit Kapila)
+       DATABASE to disconnect sessions using the target
+       database, allowing the drop to succeed (Pavel Stehule, Amit Kapila)
       
 
       
-       This is enabled by WITH FORCE.
+       This is enabled by the FORCE option.
       
      
 
@@ -1587,9 +1596,10 @@ Author: Peter Eisentraut 
 -->
 
       
-       Add structure member 
+       Add structure member 
        linkend="trigger-interface">tg_updatedcols
-       to record updated columns to C triggers (Peter Eisentraut)
+       to allow C-language update triggers to know which column(s) were updated
+       (Peter Eisentraut)
       
      
 
@@ -1615,8 +1625,9 @@ Tom Lane 
 
       
        The new data types are 
-       linkend="datatype-pseudotypes-table">anycompatible,
-       anycompatiblearray, anycompatiblenonarray, and anycompatiblerange.
+       linkend="datatype-pseudotypes-table">anycompatible,
+       anycompatiblearrayanycompatiblenonarray,
+       and anycompatiblerange.
       
      
 
@@ -1628,13 +1639,13 @@ Author: Thomas Munro 
 
       
        Add SQL data type 
-       linkend="datatype-oid">xid8 to expose FullTransactionId
-       (Thomas Munro)
+       linkend="datatype-oid">xid8 to expose
+       FullTransactionId (Thomas Munro)
       
 
       
-       The xid data type is only four bytes so does not show the transaction
-       epoch.
+       The existing xid data type is only four bytes so it
+       does not provide the transaction epoch.
       
      
 
@@ -1645,8 +1656,10 @@ Author: Peter Eisentraut 
 -->
 
       
-       Add data type regcollation and
-       helper functions for system collations (Julien Rouhaud)
+       Add data
+       type regcollation
+       and associated functions, to represent OIDs of collation objects
+       (Julien Rouhaud)
       
      
 
@@ -1657,13 +1670,13 @@ Author: Thomas Munro 
 -->
 
       
-       Use the glibc version in some cases as the 
-       linkend="collation">collation version (Thomas Munro)
+       Use the glibc version in some cases as a 
+       linkend="collation">collation version identifier (Thomas Munro)
       
 
       
-       If the glibc version changes, a warning will be issued when a
-       mismatching collation is used.
+       If the glibc version changes, a warning will be issued about
+       possible corruption of collation-dependent indexes.
       
      
 
@@ -1685,12 +1698,13 @@ Author: Tom Lane 
 -->
 
       
-       Allow ROW values
-       values to have their members extracted with suffix notation (Tom Lane)
+       Allow ROW
+       expressions to have their members extracted with suffix
+       notation (Tom Lane)
       
 
       
-       For example, (ROW(4, 5.0)).f1 returns 4.
+       For example, (ROW(4, 5.0)).f1 now returns 4.
       
      
 
@@ -1711,15 +1725,16 @@ Author: Andrew Dunstan 
 
       
        Add alternate version of 
-       linkend="functions-json-processing-table">jsonb_setI()
-       with special NULL handling (Andrew Dunstan)
+       linkend="functions-json-processing-table">jsonb_set()
+       with improved NULL handling (Andrew Dunstan)
       
 
       
-       The new function, jsonb_set_lax(), allows null
-       new values to either set the specified key to JSON
-       null, delete the key, raise exception, or ignore the operation.
-       IS 'return_target' CLEAR?
+       The new function, jsonb_set_lax(), handles a
+       NULL new value by either setting the specified
+       key to a JSON null, deleting the key, raising an
+       exception, or returning the jsonb value unmodified, as
+       requested.
       
      
 
@@ -1737,9 +1752,10 @@ Author: Alexander Korotkov 
       
 
       
-       This allows json values to be converted to timestamps, which can
-       then be processed in jsonpath expressions.  This also adds jsonpath
-       functions that support time zone-aware output.
+       This function allows JSON values to be converted
+       to timestamps, which can then be processed in jsonpath
+       expressions.  This change also adds jsonpath functions
+       that support time-zone-aware output.
       
      
 
@@ -1761,19 +1777,35 @@ Author: Peter Eisentraut 
 
      
 
 
       
-       Allow Unicode
-       escapes, e.g., E'\u####', U&'\####', to specify any
-       character available in the database encoding, even when the database
-       encoding is not UTF-8 (Tom Lane)
+       Add min() and
+       max() aggregates for 
+       linkend="datatype-pg-lsn">pg_lsn (Fabrízio
+       de Royes Mello)
       
 
       
-       The Unicode characters must be available in the database encoding.
+       These are particularly useful in monitoring queries.
+      
+     
+
+     
+
+
+      
+       Allow Unicode
+       escapes,
+       e.g., E'\unnnn'
+       or U&'\nnnn', to
+       specify any character available in the database encoding, even when
+       the database encoding is not UTF-8 (Tom Lane)
       
      
 
@@ -1793,7 +1825,7 @@ Author: Tom Lane 
       
        The names recognized are the same as those output by 
        linkend="functions-formatting">to_char()
-       with the same format codes.
+       with the same format patterns.
       
      
 
@@ -1804,9 +1836,10 @@ Author: Alexander Korotkov 
 -->
 
       
-       Add format specifications FF1-FF6 to control display of 1-6 subsecond
-       digits (Alexander Korotkov, Nikita Glukhov, Teodor Sigaev, Oleg
-       Bartunov)
+       Add datetime format patterns FF1
+       – FF6 to specify input or output of
+       1 to 6 fractional-second digits (Alexander
+       Korotkov, Nikita Glukhov, Teodor Sigaev, Oleg Bartunov)
       
 
       
@@ -1823,8 +1856,8 @@ Author: Alexander Korotkov 
 -->
 
       
-       Add SSSSS time format specification as an
-       SQL standard alias for SSSS
+       Add SSSSS datetime format pattern as an
+       SQL-standard alias for SSSS
        (Nikita Glukhov, Alexander Korotkov)
       
      
@@ -1838,12 +1871,12 @@ Author: Peter Eisentraut 
       
        Add function 
        linkend="functions-uuid">gen_random_uuid()
-       to generate version 4 UUIDs (Peter Eisentraut)
+       to generate version-4 UUIDs (Peter Eisentraut)
       
 
       
        Previously UUID generation functions were only
-       available via external modules  and 
+       available in the external modules  and 
        linkend="pgcrypto"/>.
       
      
@@ -1855,9 +1888,10 @@ Author: Dean Rasheed 
 -->
 
       
-       Add greatest-common-denominator (
-       linkend="functions-math-func-table">gcd) and
-       least-common-multiple (lcm) functions (Vik Fearing)
+       Add greatest-common-denominator
+       (gcd)
+       and least-common-multiple (lcm) functions (Vik
+       Fearing)
       
      
 
@@ -1870,9 +1904,10 @@ Author: Dean Rasheed 
 -->
 
       
-       Improve the performance and accuracy of 
-       linkend="functions-math-func-table">square root and natural log
-       (ln) output (Dean Rasheed)
+       Improve the performance and accuracy of the numeric
+       type's square root
+       (sqrt) and natural log
+       (ln) functions (Dean Rasheed)
       
      
 
@@ -1885,9 +1920,9 @@ Author: Tom Lane 
       
        Add function 
        linkend="functions-math-func-table">min_scale()
-       that returns the number of digits to the right the decimal point
-       that is required to represent the numeric value with full precision
-       (Pavel Stehule)
+       that returns the number of digits to the right of the decimal point
+       that are required to represent a numeric value with
+       full accuracy (Pavel Stehule)
       
      
 
@@ -1900,8 +1935,8 @@ Author: Tom Lane 
       
        Add function 
        linkend="functions-math-func-table">trim_scale()
-       to reduce the scale of a number by removing trailing zeros (Pavel
-       Stehule)
+       to reduce the scale of a numeric value by removing
+       trailing zeros (Pavel Stehule)
       
      
 
@@ -1917,8 +1952,10 @@ Author: Alexander Korotkov 
       
 
       
-       For example, previously only point <-> line was supported,
-       now line <-> point works too.
+       For example, previously only point
+       <-> line was supported,
+       now line <-> point
+       works too.
       
      
 
@@ -1929,14 +1966,14 @@ Author: Thomas Munro 
 -->
 
       
-       Create xid8 versions of all 
-       linkend="functions-pg-snapshot">transaction id functions
+       Create xid8 versions of all 
+       linkend="functions-pg-snapshot">transaction ID functions
        (Thomas Munro)
       
 
       
-       The old function names were kept for backward compatibility.  DO WE
-       HAVE NEW NAMES?
+       The old xid-based functions still exist, for backward
+       compatibility.
       
      
 
@@ -1949,8 +1986,8 @@ Author: Tom Lane 
       
        Allow 
        linkend="functions-binarystring-other">get_bit()
-       and set_bit() to set bits beyond 256MB of bytea
-       data (Movead Li)
+       and set_bit() to set bits beyond the first
+       256MB of a bytea value (Movead Li)
       
      
 
@@ -1983,7 +2020,6 @@ Author: Alvaro Herrera 
       
      
 
-
     
 
    
@@ -2012,7 +2048,7 @@ Author: Tom Lane 
 -->
 
       
-       Improve the performance of PL/pgSQL functions that use immutable
+       Improve performance of PL/pgSQL functions that use immutable
        expressions (Konstantin Knizhnik)
       
      
@@ -2056,8 +2092,8 @@ Author: Tom Lane 
 -->
 
       
-       Add libpq connection parameters to control the min/max
-       TLS version for encrypted connections
+       Add libpq connection parameters to control the minimum and maximum
+       TLS version allowed for an encrypted connection
        (Daniel Gustafsson)
       
 
@@ -2072,30 +2108,18 @@ Author: Tom Lane 
 
      
 
-
-      
-       Tighten libpq's overlength-line handling and comment detection for 
-       linkend="libpq-pgpass">.pgpass files (Fujii Masao)
-      
-     
-
-     
-
 
       
-       Allow specification of passwords to unlock client certificates (Craig
+       Allow use of passwords to unlock client certificates (Craig
        Ringer, Andrew Dunstan)
       
 
       
-       This is specified by the 
-       connection option.
+       This is enabled by libpq's 
+       connection parameter.
       
      
 
@@ -2106,8 +2130,8 @@ Author: Andrew Dunstan 
 -->
 
       
-       Allow DER-encoded client certificates (Craig Ringer,
-       Andrew Dunstan)
+       Allow libpq to use DER-encoded client
+       certificates (Craig Ringer, Andrew Dunstan)
       
      
 
@@ -2150,9 +2174,9 @@ Author: Michael Paquier 
 -->
 
        
-        Add the transaction status (%x) to the default 
-        linkend="app-psql-prompting">psql
-        prompts (Vik Fearing)
+        Add transaction status (%x)
+        to psql's default
+        prompts (Vik Fearing)
        
       
 
@@ -2163,12 +2187,13 @@ Author: Thomas Munro 
 -->
 
        
-        Allow the secondary psql prompt to be same
-        number of spaces as the primary prompt (Thomas Munro)
+        Allow the secondary psql prompt to be
+        blank but the same width as the primary prompt (Thomas Munro)
        
 
        
-        This is accomplished by setting PROMPT2 to %w.
+        This is accomplished by setting PROMPT2
+        to %w.
        
       
 
@@ -2179,13 +2204,16 @@ Author: Tom Lane 
 -->
 
        
-        Allow \g and \gx to
-        change any \pset output
-        options for a single command (Tom Lane)
+        Allow psql's
+        \g
+        and \gx commands to
+        change \pset output
+        options for the duration of that single command (Tom Lane)
        
 
        
-        This allows syntax like \g (expand=on), which is equivalent to \gx.
+        This feature allows syntax like \g (expand=on),
+        which is equivalent to \gx.
        
       
 
@@ -2196,14 +2224,16 @@ Author: Alexander Korotkov 
 -->
 
        
-        Add psql commands to report operator
+        Add psql commands to display operator
         classes and operator families (Sergey Cherkashin, Nikita Glukhov,
         Alexander Korotkov)
        
 
        
         The new commands are 
-        linkend="app-psql-meta-commands">\dAc, \dAf, \dAo, and \dAp.
+        linkend="app-psql-meta-commands">\dAc,
+        \dAf\dAo,
+        and \dAp.
        
       
 
@@ -2215,8 +2245,8 @@ Author: Tom Lane 
 
        
         Show table persistence in psql's 
-        linkend="app-psql-meta-commands">\dt+ and related commands
-        (David Fetter)
+        linkend="app-psql-meta-commands">\dt+
+        and related commands (David Fetter)
        
 
        
@@ -2232,9 +2262,9 @@ Author: Tom Lane 
 -->
 
        
-        Improve output of psql 
-        linkend="app-psql-meta-commands">\d for TOAST>
-        tables (Justin Pryzby)
+        Improve output of psql's 
+        linkend="app-psql-meta-commands">\d>
+        for TOAST tables (Justin Pryzby)
        
       
 
@@ -2245,13 +2275,15 @@ Author: Tom Lane 
 -->
 
        
-        Adjust display of psql's 
-        linkend="app-psql-meta-commands">\e query (Tom Lane)
+        Fix redisplay after psql's 
+        linkend="app-psql-meta-commands">\e
+        command (Tom Lane)
        
 
        
         When exiting the editor, if the query doesn't end with a semicolon
-        or \g, the query buffer contents will now be displayed.
+        or \g, the query buffer contents will now be
+        displayed.
        
       
 
@@ -2262,13 +2294,14 @@ Author: Tom Lane 
 -->
 
        
-        Add \warn command to
-        psql (David Fetter)
+        Add 
+        linkend="app-psql-meta-commands">\warn
+        command to psql (David Fetter)
        
 
        
-        This is like \echo except that the text is sent to stderr instead
-        of stdout.
+        This is like \echo except that the text is sent
+        to stderr instead of stdout.
        
       
 
@@ -2300,7 +2333,8 @@ Author: Amit Kapila 
 -->
 
        
-        Allow pgbench to partition its 'accounts' table (Fabien Coelho)
+        Allow pgbench to partition its accounts table
+        (Fabien Coelho)
        
 
        
@@ -2315,8 +2349,9 @@ Author: Michael Paquier 
 -->
 
        
-        Add pgbench command \aset, which behaves like \gset, but for multiple
-        queries (Fabien Coelho)
+        Add pgbench command \aset, which behaves
+        like \gset, but for multiple queries (Fabien
+        Coelho)
        
       
 
@@ -2327,8 +2362,8 @@ Author: Fujii Masao 
 -->
 
        
-        Allow pgbench to generate its data server-side, rather than client side
-        (Fabien Coelho)
+        Allow pgbench to generate its initial data server-side, rather
+        than client-side (Fabien Coelho)
        
       
 
@@ -2339,7 +2374,7 @@ Author: Thomas Munro 
 -->
 
        
-        Allow pgbench to dump script contents using
+        Allow pgbench to show script contents using option
          (Fabien Coelho)
        
       
@@ -2390,9 +2425,10 @@ Author: Author: Fujii Masao 
       
        This computation allows 
        linkend="monitoring-stats-dynamic-views-table">pg_stat_progress_basebackup
-       to show progress, and can be disabled by using the
-        option.  Previously, this
-       computation happened only if  was used.
+       to show progress.  If that is not needed, it can be disabled by
+       using the  option.  Previously,
+       this computation happened only if the 
+       option was used.
       
      
 
@@ -2403,9 +2439,9 @@ Author: Alvaro Herrera 
 -->
 
       
-       Add 
+       Add an option to 
        linkend="app-pgrewind">pg_rewind
-       option to configure standbys (Paul Guo, Jimmy Yih, Ashwin Agrawal)
+       to configure standbys (Paul Guo, Jimmy Yih, Ashwin Agrawal)
       
 
       
@@ -2456,8 +2492,8 @@ Author: Fujii Masao 
 -->
 
       
-       Increase PREPARE
-       TRANSACTION information reported by
+       Increase the PREPARE
+       TRANSACTION-related information reported by
        pg_waldump (Fujii Masao)
       
      
@@ -2530,8 +2566,9 @@ Author: Amit Kapila 
 -->
 
       
-       Allow dropdb to force disconnections
-       so the drop succeeds (Pavel Stehule)
+       Allow dropdb to disconnect
+       sessions using the target database, allowing the drop to succeed
+       (Pavel Stehule)
       
 
       
@@ -2552,7 +2589,7 @@ Author: Author: Michael Paquier 
       
 
       
-       The long-supported options for this are called
+       The long-supported preferred options for this are called
         and .
       
      
@@ -2566,8 +2603,8 @@ Author: Peter Eisentraut 
       
        Use the directory of the 
        linkend="pgupgrade">pg_upgrade
-       binary as the default new 'bindir' location when running
-       pg_upgrade (Daniel Gustafsson)
+       program as the default  setting when
+       running pg_upgrade (Daniel Gustafsson)
       
      
 
@@ -2601,7 +2638,7 @@ Author: Tom Lane 
 
       
        Reformat tables containing function
-       information for better clarity (Tom Lane)
+       and operator information for better clarity (Tom Lane)
       
      
 
@@ -2728,31 +2765,19 @@ Author: Michael Paquier 
 
-
-      
-       Remove support option
-        (Peter Eisentraut)
-      
-
-      
-       This was needed for previously supported version-zero functions.
-      
-     
-
-     
-
 
       
-       Remove configure option 
-       (Peter Eisentraut)
+       Remove configure options
+       
+       and  (Peter Eisentraut)
       
 
       
-       This was needed for previously supported version-zero functions.
+       These were needed for compatibility with some version-zero C
+       functions, but those are no longer supported.
       
      
 
@@ -2763,7 +2788,7 @@ Author: Fujii Masao 
 -->
 
       
-       Add the query string to planner hook functions (Pascal Legrand,
+       Pass the query string to planner hook functions (Pascal Legrand,
        Julien Rouhaud)
       
      
@@ -2822,7 +2847,7 @@ Author: Peter Eisentraut 
 -->
 
       
-       Use operating system functions to cleanly erase memory that contains
+       Use operating system functions to reliably erase memory that contains
        sensitive information (Peter Eisentraut)
       
 
@@ -2838,8 +2863,8 @@ Author: Author: Tom Lane 
 -->
 
       
-       Add "headerscheck" script to test C header-file compatibility
-       (Tom Lane)
+       Add headerscheck script to test C header-file
+       compatibility (Tom Lane)
       
      
 
@@ -2850,26 +2875,12 @@ Author: Tom Lane 
 -->
 
       
-       Implement internal lists as arrays, rather than a chain of structures
+       Implement internal lists as arrays, rather than a chain of cells
        (Tom Lane)
       
 
       
-       This improves performance for queries that access many object.
-       The internal List API has also been improved.
-      
-     
-
-     
-
-
-      
-       Update Windows build scripts
-       to use the modern  flag for
-       UUID libraries (Kyotaro Horiguchi)
+       This improves performance for queries that access many objects.
       
      
 
@@ -2913,8 +2924,9 @@ Author: Tom Lane 
       
 
       
-       Such extensions can be installed in a database by users with creation
-       rights, even if they are not superusers.  This change also removes
+       Such extensions can be installed in a database by users with
+       database-level CREATE privileges, even if they
+       are not superusers.  This change also removes
        the pg_pltemplate system catalog.
       
      
@@ -2926,7 +2938,7 @@ Author: Tom Lane 
 -->
 
       
-       Remove support for upgrading "unpackaged" extensions (Tom Lane)
+       Remove support for upgrading unpackaged (pre-9.1) extensions (Tom Lane)
       
      
 
@@ -2942,11 +2954,11 @@ Author: Andrew Dunstan 
       
 
       
-       Specifically, allow ALTER
-       USER MAPPING to set
-       password_required to false.  Care must still be
-       taken to avoid non-superusers from using superuser credentials to
-       connect to the foreign server.
+       Specifically, allow a superuser to set
+       password_required to false for
+       user mapping.  Care
+       must still be taken to prevent non-superusers from using superuser
+       credentials to connect to the foreign server.
       
      
 
@@ -3000,8 +3012,8 @@ Author: Andrew Gierth 
 
       
        Have  treat SELECT
-       ... FOR UPDATE  as distinct from those without FOR
-       UPDATE (Andrew Gierth, Vik Fearing)
+       ... FOR UPDATE commands as distinct from those
+       without FOR UPDATE (Andrew Gierth, Vik Fearing)
       
      
 
@@ -3061,7 +3073,7 @@ Author: Tom Lane 
 -->
 
       
-       Add option to  extension to ignore the sign
+       Add an option to  to ignore the sign
        of integers (Jeff Janes)
       
      
@@ -3102,7 +3114,7 @@ Author: Peter Geoghegan 
 -->
 
       
-       Add btree index de-duplication processing columns to pageinspect output
+       Add B-tree index de-duplication processing columns to pageinspect output
        (Peter Geoghegan)