Do a round of copy-editing on the 9.5 release notes.
authorTom Lane
Thu, 12 Nov 2015 00:19:14 +0000 (19:19 -0500)
committerTom Lane
Thu, 12 Nov 2015 00:19:14 +0000 (19:19 -0500)
Also fill in the previously empty "major enhancements" list.  YMMV as to
which items should make the cut, but it's past time we had something more
than a placeholder here.

(I meant to get this done before beta2 was wrapped, but got distracted by
PDF build problems.  Better late than never.)

doc/src/sgml/release-9.5.sgml

index 64057c3f8a3ae56f4b0146062a2546f41501de76..110ba40c4dfcc55d7eaad148f02b94f2798d7590 100644 (file)
 
     
      
-      ... to be filled in ...
+      Allow INSERTS
+      that would generate constraint conflicts to be turned into
+      UPDATEs or ignored
+     
+    
+
+    
+     
+      Add GROUP BY analysis functions 
+      linkend="queries-grouping-sets">GROUPING SETS,
+      CUBE and
+      ROLLUP
+     
+    
+
+    
+     
+      Add row-level security control
+     
+    
+
+    
+     
+      Allow labeling of
+      the origin of logical replication changes, and provide mechanisms
+      for tracking the progress of replication
+     
+    
+
+    
+     
+      Add Block Range Indexes (BRIN)
+     
+    
+
+    
+     
+      Substantial performance improvements for sorting
+     
+    
+
+    
+     
+      Substantial performance improvements for multi-CPU machines
      
     
 
       Change pg_ctl's default shutdown mode from
       smart to fast (Bruce Momjian)
      
+
+     
+      This means the default behavior will be to forcibly cancel existing
+      database sessions, not simply wait for them to exit.
+     
     
 
     
@@ -255,8 +303,10 @@ max_wal_size = (3 * checkpoint_segments) * 16MB
        
 
        
-        BRIN indexes are very compact and cheap to update by
-        storing min/max values for a range of heap blocks.
+        BRIN indexes store only summary data (such as minimum
+        and maximum values) for ranges of heap blocks.  They are therefore
+        very compact and cheap to update; but if the data is naturally
+        clustered, they can still provide substantial speedup of searches.
        
       
 
@@ -273,9 +323,9 @@ max_wal_size = (3 * checkpoint_segments) * 16MB
 
        
         Previously, a common table expression was required to return a
-        large number of rows ordered by bounding-box distance, and then
-        filtered further with a more accurate non-bounding-box distance
-        calculation.
+        large number of rows ordered by bounding-box distance, and the
+        result then had to be filtered further with a more accurate
+        non-bounding-box distance calculation.
        
       
 
@@ -335,9 +385,9 @@ Add GUC and storage parameter to set the maximum size of GIN pending list.
 2015-05-13 [78efd5c] Robert..: Extend abbreviated key infrastructure to datum ..
 -->
        
-        Improve the speed of sorting VARCHAR, TEXT,
-        and NUMERIC fields (Peter Geoghegan, Andrew Gierth,
-        Robert Haas)
+        Improve the speed of sorting of varchar, text,
+        and numeric fields via abbreviated keys
+        (Peter Geoghegan, Andrew Gierth, Robert Haas)
        
       
 
@@ -358,10 +408,9 @@ Add GUC and storage parameter to set the maximum size of GIN pending list.
 2014-09-10 [45f6240] Heikki..: Pack tuples in a hash join batch densely, to sa..
 2014-09-12 [8cce08f] Robert..: Change NTUP_PER_BUCKET to 1 to improve hash joi..
 2014-10-13 [30d7ae3] Kevin ..: Increase number of hash join buckets for undere..
-FIXME: bad description? Should talk about hash joins
 -->
        
-        Improve in-memory hash performance (Tomas Vondra, Robert Haas)
+        Improve performance of hash joins (Tomas Vondra, Robert Haas)
        
       
 
@@ -369,11 +418,10 @@ FIXME: bad description? Should talk about hash joins
 
        
         Improve concurrency of shared buffer replacement
-        (Robert Haas, Amit Kapila)
+        (Robert Haas, Amit Kapila, Andres Freund)
        
       
 
@@ -397,12 +445,8 @@ FIXME: Add Andres
 2015-01-19 [2d115e4] Andres..: Fix various shortcomings of the new PrivateRefC..
 -->
        
-        Make backend local tracking of buffer pins memory efficient (Andres Freund)
-       
-
-       
-        Previously each session allocated an array with space for every buffer
-        in shared_buffers.
+        Make per-backend tracking of buffer pins more memory-efficient
+        (Andres Freund)
        
       
 
@@ -425,8 +469,8 @@ FIXME: Add Andres
 2014-07-15 [f15821e] Tom Lane: Allow join removal in some cases involving a le..
 -->
        
-        Allow the optimizer to remove unnecessary references to left
-        outer join subqueries (David Rowley)
+        Allow the optimizer to remove unnecessary references to left-joined
+        subqueries (David Rowley)
        
       
 
@@ -435,7 +479,7 @@ FIXME: Add Andres
 2014-06-27 [d222585] Tom Lane: Allow pushdown of WHERE quals into subqueries w..
 -->
        
-        Allow pushdown of query restrictions into 
+        Allow pushdown of query restrictions into subqueries with 
         linkend="functions-window">window functions, where appropriate
         (David Rowley)
        
@@ -498,19 +542,20 @@ FIXME: Add Andres
       
 
       
-       
 
-        Speed up CREATE INDEX by avoiding unnecessary memory copies (Robert Haas)
+       
+        Speed up CREATE INDEX by avoiding unnecessary memory
+        copies (Robert Haas)
        
       
 
       
-       
 
+       
         Increase the number of buffer mapping partitions (Amit Kapila,
         Andres Freund, Robert Haas)
        
@@ -534,12 +579,9 @@ FIXME: Add Andres
 2015-04-03 [4ff695b1] Alvaro..: Add log_min_autovacuum_duration per-table option
 -->
        
-        Add per-table autovacuum logging control via
-        log_min_autovacuum_duration (Michael Paquier)
-       
-
-       
-        NOT DOCUMENTED?
+        Add per-table autovacuum logging control via new
+        log_min_autovacuum_duration storage parameter
+        (Michael Paquier)
        
       
 
@@ -677,17 +719,6 @@ FIXME: Add docs about restartpoint behaviour change
 
       
 
-       
-        Add configuration parameter  to
-        control compression of full page images stored in WAL
-        (Rahila Syed, Michael Paquier)
-       
-      
-
-      
-
        
@@ -736,7 +767,7 @@ FIXME: Add docs about restartpoint behaviour change
        
         This means that assertions can no longer be turned
         off if they were enabled at compile time, allowing for more
-        efficient code optimization.  This change also removed the 
+        efficient code optimization.  This change also removes the 
         linkend="app-postgres-options">postgres 
        
       
@@ -789,7 +820,8 @@ FIXME: Add docs about restartpoint behaviour change
        
         Add pending_restart to the system view 
         linkend="view-pg-settings">pg_settings to
-        indicate a change is pending a restart (Peter Eisentraut)
+        indicate a change has been made but will not take effect until a
+        database restart (Peter Eisentraut)
        
       
 
@@ -804,7 +836,8 @@ FIXME: Add docs about restartpoint behaviour change
        
 
        
-        This command removes the setting from postgresql.auto.conf.
+        This command removes the specified setting
+        from postgresql.auto.conf.
        
       
 
@@ -881,6 +914,23 @@ FIXME: Add docs about restartpoint behaviour change
 
       
 
+       
+        Allow compression of full-page images stored in WAL
+        (Rahila Syed, Michael Paquier)
+       
+
+       
+        This feature reduces WAL volume, at the cost of more CPU time spent
+        on WAL logging and WAL replay.  It is controlled by a new
+        configuration parameter , which
+        currently is off by default.
+       
+      
+
+      
+
        
@@ -910,12 +960,11 @@ FIXME: Add docs about restartpoint behaviour change
       
 
        
         Allow labeling of
-        the origin progress of logical replication changes (Andres Freund)
+        the origin of logical replication changes, and provide mechanisms
+        for tracking the progress of replication (Andres Freund)
        
 
        
@@ -926,7 +975,6 @@ FIXME: Correct description
       
 
        
         Report the processes holding replication slots in 
@@ -1013,7 +1061,7 @@ FIXME: Correct description
 2014-10-07 [df630b0] Alvaro..: Implement SKIP LOCKED for row-level locks
 -->
        
-        Add new SELECT option
+        Add SELECT option
         SKIP LOCKED to skip locked rows (Thomas Munro)
        
 
@@ -1216,12 +1264,11 @@ FIXME: Correct description
        
 
        
-        Commands include ALTER
-        USER,
-       ALTER
+        This includes ALTER
+        USER, ALTER
         GROUP, ALTER
         ROLE, GRANT,
-        and various ALTER OBJECT / OWNER TO commands.
+        and various ALTER object OWNER TO commands.
        
       
 
@@ -1256,8 +1303,8 @@ FIXME: Correct description
        
 
        
-        Previously only UPDATE, DELETE, and
-        TRUNCATE privileges allowed this.
+        Previously this required UPDATE, DELETE, or
+        TRUNCATE privileges.
        
       
 
@@ -1440,7 +1487,7 @@ FIXME: Better description?
 2014-09-09 [57b1085] Peter ..: Allow empty content in xml type
 -->
       
-       Allow the XML data type
+       Allow the xml data type
        to accept empty or all-whitespace values (Peter Eisentraut)
       
 
@@ -1455,7 +1502,7 @@ FIXME: Better description?
 2014-10-21 [6f04368] Peter ..: Allow input format xxxx-xxxx-xxxx for macaddr ..
 -->
       
-       Allow MACADDR input
+       Allow macaddr input
        using the format xxxx-xxxx-xxxx (Herwin Weststrate)
       
      
@@ -1467,7 +1514,7 @@ FIXME: Add more specifics?
 -->
       
        Tighten syntax of 
-       linkend="datatype-interval-input">INTERVAL precision
+       linkend="datatype-interval-input">interval precision
        specifications (Bruce Momjian)
       
 
@@ -1483,12 +1530,26 @@ FIXME: Add more specifics?
 -->
       
        Add selectivity estimators for 
-       linkend="datatype-inet">INET/
-       linkend="datatype-cidr">CIDR operators and improve
+       linkend="datatype-inet">inet/
+       linkend="datatype-cidr">cidr operators and improve
        estimators for text search functions (Emre Hasegeli, Tom Lane)
       
      
 
+     
+
+      
+       Add data
+       types regrole
+       and regnamespace
+       that simplify pretty-printing the OID of a role or
+       namespace (Kyotaro Horiguchi)
+      
+     
+
     
 
     
@@ -1515,8 +1576,8 @@ FIXME: Add more specifics?
 2014-12-12 [7e354ab] Andrew..: Add several generator functions for jsonb that ..
 -->
        
-        Add several generator functions for JSONB that already
-        existed for JSON (Andrew Dunstan)
+        Add several generator functions for jsonb that already
+        existed for json (Andrew Dunstan)
        
 
        
@@ -1541,8 +1602,8 @@ FIXME: Add more specifics?
 -->
        
         Reduce casting requirements to/from 
-        linkend="datatype-json">JSON and 
-        linkend="datatype-json">JSONB (Tom Lane)
+        linkend="datatype-json">json and 
+        linkend="datatype-json">jsonb (Tom Lane)
        
       
 
@@ -1551,9 +1612,9 @@ FIXME: Add more specifics?
 2015-06-11 [908e234] Andrew..: Rename jsonb - text[] operator to #- to avoid a..
 -->
        
-        Allow TEXT, TEXT array, and INTEGER
+        Allow text, text array, and integer
         values to be subtracted
-        from JSONB documents (Dmitry Dolgov, Andrew Dunstan)
+        from jsonb documents (Dmitry Dolgov, Andrew Dunstan)
        
       
 
@@ -1562,8 +1623,8 @@ FIXME: Add more specifics?
 2015-05-12 [c694701] Andrew..: Additional functions and operators for jsonb
 -->
        
-        Add JSONB 
-        linkend="functions-jsonb-op-table">operator ||
+        Add jsonb 
+        linkend="functions-jsonb-op-table">|| operator
         (Dmitry Dolgov, Andrew Dunstan)
        
       
@@ -1577,7 +1638,7 @@ FIXME: Add more specifics?
         linkend="functions-json-processing-table">json_strip_nulls()
         and 
         linkend="functions-json-processing-table">jsonb_strip_nulls()
-        functions to remove JSON null values from documents
+        functions to remove json null values from documents
         (Andrew Dunstan)
        
       
@@ -1599,7 +1660,7 @@ FIXME: Add more specifics?
 -->
        
         Add generate_series()
-        for NUMERIC values (Plato Malugin)
+        for numeric values (Plato Malugin)
        
       
 
@@ -1759,7 +1820,7 @@ FIXME: Add more specifics?
        
 
        
-        This represents the last time the snapshot files was written to
+        This represents the last time the snapshot file was written to
         the file system.
        
       
@@ -1774,18 +1835,6 @@ FIXME: Add more specifics?
         to compute multi-xid age (Bruce Momjian)
        
       
-
-      
-
-       
-        Add data types 
-        linkend="datatype-oid-table">regrole regnamespace that returns
-        the OID of a role (Kyotaro Horiguchi)
-       
-      
      
 
     
@@ -1800,9 +1849,9 @@ FIXME: Add more specifics?
 2014-08-28 [6c40f83] Tom Lane: Add min and max aggregates for inet/cidr data t..
 -->
        
-        Add MIN()/MAX() aggregates
-        for INET/
-        linkend="datatype-cidr">CIDR data types (Haribabu
+        Add min()/max() aggregates
+        for inet/
+        linkend="datatype-cidr">cidr data types (Haribabu
         Kommi)
        
       
@@ -1813,8 +1862,8 @@ FIXME: Add more specifics?
 2015-03-20 [959277a] Andres..: Use 128-bit math to accelerate some aggregation..
 -->
        
-        Use 128-bit integers, where supported, as aggregate accumulators
-        (Andreas Karlsson)
+        Use 128-bit integers, where supported, as accumulators for some
+        aggregate functions (Andreas Karlsson)
        
       
 
@@ -1851,7 +1900,7 @@ FIXME: Add more specifics?
 -->
       
        Reduce lossiness of 
-       linkend="plpython">PL/Python floating value
+       linkend="plpython">PL/Python floating-point value
        conversions (Marko Kreen)
       
      
@@ -1943,6 +1992,11 @@ FIXME: Add more specifics?
        and pg_xlogdump
        from contrib to src/bin (Peter Eisentraut)
       
+
+      
+       This should result in these programs being installed by default in
+       most installations.
+      
      
 
      
@@ -1977,14 +2031,14 @@ FIXME: Add more specifics?
 2014-11-18 [c4f99d2] Fujii ..: Add ––synchronous option to pg_receivexlog, for..
 -->
       
-       Allow the 
+       Allow 
        linkend="app-pgreceivexlog">pg_receivexlog
-       to synchronously flush WAL to storage using
-       
+       to synchronously flush WAL to storage using new
+       
       
 
       
-       Without this, WAL files are fsynced only on close.
+       Without this, WAL files are fsync'ed only on close.
       
      
 
@@ -1994,7 +2048,7 @@ FIXME: Add more specifics?
 -->
       
        Allow vacuumdb to
-       vacuum in parallel using  (Dilip Kumar)
+       vacuum in parallel using new  (Dilip Kumar)
       
      
 
@@ -2084,9 +2138,9 @@ FIXME: Add more specifics?
 2014-09-02 [51bb795] Andres..: Add psql PROMPT variable showing which line of ..
 -->
         
-         Add psql 
-         linkend="APP-PSQL-variables">PROMPT variables option
-         (%l) to display the multiline statement line number
+         Add new option %l in psql's 
+         linkend="APP-PSQL-variables">PROMPT variables
+         to display the current multiline statement line number
          (Sawada Masahiko)
         
        
@@ -2153,7 +2207,7 @@ FIXME: Add more specifics?
         
 
         
-         variables outputs psql variables
+         variables shows psql's special variables
          and options shows command-line options.
          \? commands is the default output. This help
          information can also be output via --help=section.
@@ -2249,9 +2303,8 @@ FIXME: Add more specifics?
        
         The remote snapshot must have been exported by
         pg_export_snapshot() or logical replication slot
-        creation.  This can be used by another pg_dump to
-        use a share a consistent snapshot across pg_dump
-        processes.
+        creation.  This can be used to share a consistent snapshot
+        across multiple pg_dump processes.
        
       
 
@@ -2480,6 +2533,16 @@ FIXME: Improve description, link
 
       
 
+       
+        Improve the representation of transaction commit and abort WAL
+        records (Andres Freund)
+       
+      
+
+      
+
        
@@ -2666,8 +2729,8 @@ FIXME: Improve description, link
 2014-07-12 [8d9a0e8] Magnus..: Support ––with-extra-version equivalent functi..
 -->
        
-        Allow configure's
-        
+        Allow configure's
+        
         MSVC build (Michael Paquier)