Add doc links to 9.4 release notes, and add major features list
authorBruce Momjian
Mon, 5 May 2014 20:26:27 +0000 (16:26 -0400)
committerBruce Momjian
Mon, 5 May 2014 20:26:33 +0000 (16:26 -0400)
doc/src/sgml/datatype.sgml
doc/src/sgml/release-9.4.sgml

index cc458b4753f43554bfde8f50a406efb5582e45b2..828ed9e0927b0469fd73046710159e579c9773a4 100644 (file)
@@ -3155,7 +3155,7 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
     
    
 
-   
+    id="datatype-line">
     Lines
 
     
@@ -3187,7 +3187,7 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
     
    
 
-   
+    id="datatype-lseg">
     Line Segments
 
     
@@ -3302,7 +3302,7 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
     
    
 
-   
+    id="datatype-polygon">
     Polygons
 
     
@@ -3335,7 +3335,7 @@ SELECT person.name, holidays.num_weeks FROM person, holidays
     
    
 
-   
+    id="datatype-circle">
     Circles
 
     
index 9fbadbd38bc7951af930003a7a2b41887c8a61c7..4cb394b7d21f7041fd17879eeca5bbd06970ae67 100644 (file)
 
    
 
-    
-     
-     
-    
+     
+      
+       Allow materialized views to be refreshed without blocking reads
+      
+     
+
+     
+      
+       Logical change-set extraction allows database
+       changes to be optionally recorded in logical format
+      
+     
+
+     
+      
+        Allow background workers
+        to be dynamically registered, started and terminated
+      
+     
+
+     
+      
+       Add structured (non-text) data type (
+       linkend="datatype-json">JSONB) for storing
+       JSON data
+      
+     
+
+     
+      
+       Add SQL-level command 
+       linkend="SQL-ALTERSYSTEM">ALTER SYSTEM command
+       to edit the postgresql.conf configuration file
+      
+     
 
    
 
 
     
      
-      Cause consecutive whitespace in to_timestamp() and to_date() format strings to consume a corresponding number of characters in the input
-      string (whitespace or not), then conditionally additional adjacent whitespace if not in FX mode (Jeevan Chalke)
+      Cause consecutive whitespace in 
+      linkend="functions-formatting-table">to_timestamp()
+      and to_date() format strings to consume a corresponding
+      number of characters in the input string (whitespace or not), then
+      conditionally additional adjacent whitespace if not in FX
+      mode (Jeevan Chalke)
      
 
      
-      Previously consecutive whitespace characters in a non-FX format string behaved like a single whitespace character and consumed all
-      adjacent whitespace in the input string.  For example, previously format string space-space-space would consume only the first space in ' 12', while it will not consume all three characters.
+      Previously consecutive whitespace characters in a non-FX
+      format string behaved like a single whitespace character and consumed
+      all adjacent whitespace in the input string.  For example, previously
+      format string space-space-space would consume only the first space in
+      ' 12', while it will not consume all three characters.
      
     
 
     
      
-      Tighten checks for multi-dimensional array input (Bruce Momjian)
+      Tighten checks for multi-dimensional 
+      linkend="arrays">array input (Bruce Momjian)
      
 
      
-      Previously an input array string that started with a single-element array dimension could later contain multi-dimensional
-      segments.
+      Previously an input array string that started with a single-element
+      array dimension could later contain multi-dimensional segments,
+      e.g. '{{1}, {2,3}}'::int[].
      
     
 
     
      
-      Change empty arrays returned by intarray to be zero-dimensional arrays (Bruce Momjian)
+      Change empty arrays returned by intarray to be
+      zero-dimensional arrays (Bruce Momjian)
      
 
      
-      Previously empty arrays were returned as one-dimensional empty arrays whose text representation looks the same as
-      zero-dimensional arrays.  intarray's behavior in this area now matches the built-in array operators.
+      Previously empty arrays were returned as one-dimensional empty arrays
+      whose text representation looked the same as zero-dimensional arrays
+      ({}).  intarray's behavior in this area
+      now matches the built-in array operators.
      
     
 
     
      
-      NULL VARIADIC function arguments are now disallowed (Pavel Stehule)
+      NULL 
+      linkend="xfunc-sql-variadic-functions">VARIADIC
+      function arguments are now disallowed (Pavel Stehule)
      
 
      
 
     
      
-      SHOW TIME ZONE now outputs constant time zone offsets in POSIX-style zone format (Tom Lane)
+      SHOW TIME ZONE now
+      outputs constant time zone offsets in POSIX-style zone
+      format (Tom Lane)
      
 
      
-      Previously it was returned in INTERVAL format.  The new format can be passed to SET TIME ZONE.
+      Previously it was returned in 
+      linkend="datatype-interval-output">INTERVAL format.
+      The new format can be passed to SET TIME ZONE.
      
     
 
     
      
-      Rename EXPLAIN ANALYZE's "total runtime" output to "execution time" (Tom Lane)
+      Rename EXPLAIN
+      ANALYZE's "total runtime" output to "execution time"
+      (Tom Lane)
      
 
      
 
     
      
-      Fix ts_rank_cd() to ignore stripped lexemes (Alex Hill)
+      Fix 
+      linkend="textsearch-functions-table">ts_rank_cd()
+      to ignore stripped lexemes (Alex Hill)
      
 
      
-      Previously, stripped lexemes got a default location and could be considered if mixed with non-stripped lexemes.
+      Previously, stripped lexemes got a default location and could be
+      considered if mixed with non-stripped lexemes.
      
     
 
     
      
-      Prevent CHECK constraints from referencing system columns, except tableoid (Amit Kapila)
+      Prevent 
+      linkend="ddl-constraints-check-constraints">CHECK
+      constraints from referencing system columns, except
+      tableoid (Amit Kapila)
      
 
      
 
     
      
-      Use the last specified recovery_target if multiple are specified (Heikki Linnakangas)
+      Use the last specified 
+      linkend="recovery-target">recovery_target if
+      multiple are specified (Heikki Linnakangas)
      
     
 
     
      
-      Remove system column pg_class.reltoastidxid (Michael Paquier)
+      Remove system column 
+      linkend="catalog-pg-class">pg_class.reltoastidxid
+      (Michael Paquier)
      
     
 
     
      
-      Remove support for native krb5 authentication (Magnus Hagander)
+      Remove support for native krb5 authentication
+      (Magnus Hagander)
      
 
      
-      The proper way to use Kerberos authentication is with GSSAPI.
+      The proper way to use Kerberos authentication is
+      with GSSAPI.
      
     
 
     
      
-      Have libpq's PQconnectdbParams() and PQpingParams() functions accept "" as default (Adrian Vondendriesch)
+      Have libpq's 
+      linkend="libpq-pqconnectdbparams">PQconnectdbParams()
+      and 
+      linkend="libpq-pqpingparams">PQpingParams()
+      functions process zero-length strings as defaults (Adrian
+      Vondendriesch)
      
 
      
-      Previously, these functions treated "" option values as defaults only in some cases.
+      Previously, these functions treated zero-length string values as
+      defaults only in some cases.
      
     
 
     
      
-      Remove system column pg_rewrite.ev_attr (Kevin Grittner)
+      Remove system column 
+      linkend="catalog-pg-rewrite">pg_rewrite.ev_attr
+      (Kevin Grittner)
      
 
      
-      Per-column rules have not been supported since 7.3.
+      Per-column rules have not been supported since
+      PostgreSQL 7.3.
      
     
 
     
      
-      Pg_upgrade now uses 
+      Pg_upgrade now
+      uses 
      
 
      
-      Previously, 
-      tools.
+      Previously, 
+      Also spell the long option as 
+      consistency with other tools.
      
     
 
 
       
        
-        Have VACUUM properly report dead but not removable rows to the statistics collector (Hari Babu)
+        Have VACUUM properly
+        report dead but not removable rows to the statistics collector
+        (Hari Babu)
        
 
        
         Previously these were reported as live rows.
        
       
-
       
        
-        Allow background workers to be dynamically registered, started and terminated (Robert Haas)
+        Allow background workers to be
+        dynamically registered, started and terminated (Robert Haas)
        
 
        
-        worker_spi_launch() in worker_spi shows an example of its use.
+        worker_spi_launch() in worker_spi
+        shows an example of its use.
        
       
 
       
        
-        Allow dynamic allocation of shared memory segments (Robert Haas, Amit Kapila)
+        Allow dynamic allocation of shared memory segments (Robert Haas,
+        Amit Kapila)
+       
+
+       
+        This is illustrated in 
+        linkend="test-shm-mq">test_shm_mq.
        
       
 
       
        
-        Improve SSL renegotiation handling (Álvaro Herrera)
+        Improve SSL renegotiation handling (Álvaro
+        Herrera)
        
       
 
       
        
-        During immediate shutdown, send uncatchable termination signals to child processes that have not already shutdown (MauMau,
+        During immediate shutdown, send uncatchable termination signals
+        to child processes that have not already shutdown (MauMau,
         Álvaro Herrera)
        
 
        
-        This reduces the likelihood of orphaned child processes after postmaster shutdown.
+        This reduces the likelihood of orphaned child processes after
+        postmaster
+        shutdown.
        
       
 
 
       
        
-        Improve speed of multi-key GIN lookups (Alexander Korotkov, Heikki Linnakangas)
+        Improve speed of multi-key 
+        linkend="GIN">GIN lookups (Alexander Korotkov,
+        Heikki Linnakangas)
        
       
 
       
        
-        Reduce GIN index size (Alexander Korotkov, Heikki Linnakangas)
+        Reduce GIN index size
+        (Alexander Korotkov, Heikki Linnakangas)
        
 
        
-        Indexes upgraded via pg_upgrade will work fine but will use the old larger GIN format;  REINDEX will recreate the index in the new
-        format.
+        Indexes upgraded via 
+        linkend="pgupgrade">pg_upgrade will work
+        fine but will use the old larger GIN format; 
+        linkend="SQL-REINDEX">REINDEX will recreate
+        the index in the new format.
        
       
 
       
        
-        Add GiST index support for INET and CIDR data types (Emre Hasegeli)
+        Add GiST index support
+        for INET and
+        CIDR data types
+        (Emre Hasegeli)
        
 
        
-        Such indexes improve subnet and supernet lookups and ordering comparisons.
+        Such indexes improve 
+        linkend="cidr-inet-operators-table">subnet and supernet
+        lookups and ordering comparisons.
        
       
 
 
       
        
-        Make the handling of interrupted B-tree page splits more robust (Heikki Linnakangas)
+        Make the handling of interrupted B-tree page splits more robust
+        (Heikki Linnakangas)
        
       
 
 
       
        
-        Allow multiple backends to simultaneously insert into WAL buffers (Heikki Linnakangas)
+        Allow multiple backends to simultaneously insert into 
+        linkend="wal">WAL buffers (Heikki Linnakangas)
        
 
        
 
       
        
-        Conditionally write only the modified portion of updated rows to WAL (Amit Kapila)
+        Conditionally write only the modified portion of updated rows to
+        WAL (Amit Kapila)
        
       
 
       
        
-        Improve performance of WINDOW aggregate functions (David Rowley, Florian Pflug, Tom Lane)
+        Improve performance of 
+        linkend="syntax-window-functions">WINDOW
+        aggregate functions (David Rowley, Florian Pflug, Tom Lane)
        
       
 
       
        
-        Improve speed of aggregates which use NUMERICs (Hadi Moshayedi)
+        Improve speed of aggregates which use 
+        linkend="datatype-numeric">NUMERICs (Hadi
+        Moshayedi)
        
 
        
-        These include sum(), avg(), stddev(), and variance().
+        These include SUM(), AVG(), 
+        linkend="functions-aggregate-statistics-table">STDDEV(),
+        and VARIANCE().
        
       
 
       
        
-        Freeze tuples when tables are written with CLUSTER or VACUUM FULL (Robert Haas, Andres Freund)
+        Freeze
+        tuples when tables are written with 
+        linkend="SQL-CLUSTER">CLUSTER or 
+        linkend="SQL-VACUUM">VACUUM FULL (Robert Haas,
+        Andres Freund)
        
 
        
 
       
        
-        Improve speed of COPY with DEFAULT nextval() columns (Simon Riggs)
+        Improve speed of COPY
+        with DEFAULT 
+        linkend="functions-sequence-table">nextval()
+        columns (Simon Riggs)
        
       
 
       
        
-        Improve speed of accesessing many different sequences in the same session (David Rowley)
+        Improve speed of accesessing many different 
+        linkend="SQL-CREATESEQUENCE">sequences in the same session
+        (David Rowley)
        
       
 
       
        
-        Allow sorting and btree index builds to use over four gigabytes of memory (Noah Misch)
+        Allow sorting and B-tree index
+        builds to use over four gigabytes of memory (Noah Misch)
        
       
 
       
        
-        Reduce memory allocated by DO blocks (Tom Lane)
+        Reduce memory allocated by 
+        linkend="SQL-DO">DO blocks (Tom Lane)
        
       
 
       
        
-        Have the optimizer be more aggressive in creating restrictions from mixed AND/OR clauses (Tom Lane)
+        Have the optimizer be more aggressive in creating restrictions
+        from mixed AND/OR clauses (Tom Lane)
        
       
 
        
 
        
-        This reduces memory consumption for backends accessing only a few tables, and improves performance for backend accessing many
-        tables.
+        This reduces memory consumption for backends accessing only a few
+        tables, and improves performance for backend accessing many tables.
        
       
 
 
       
        
-        Expose the estimation of number of changed tuples since last analyze (Mark Kirkwood)
+        Expose the estimation of number of changed tuples since last 
+        linkend="vacuum-for-statistics">analyze (Mark Kirkwood)
        
 
        
-        This appears in pg_stat_all_tables.n_mod_since_analyze.
+        This appears in 
+        linkend="pg-stat-all-tables-view">pg_stat_all_tables.n_mod_since_analyze.
        
       
 
       
        
-        Add pg_stat_archiver system view to report WAL archiver activity (Gabriele Bartolini)
+        Add 
+        linkend="pg-stat-archiver-view">pg_stat_archiver
+        system view to report WAL
+        archiver activity (Gabriele Bartolini)
        
       
 
       
        
-        Add xid and xmin to system views pg_stat_activity and pg_stat_replication (Christian Kruse)
+        Add xid and 
+        linkend="ddl-system-columns">xmin
+        to system views 
+        linkend="pg-stat-activity-view">pg_stat_activity
+        and 
+        linkend="pg-stat-replication-view">pg_stat_replication
+        (Christian Kruse)
        
       
 
 
       
        
-        Add support for SSL ECDH key exchange (Marko Kreen)
+        Add support for SSL ECDH key exchange
+        (Marko Kreen)
        
 
        
-        Such keys are faster and have improved security over previous options.  New variable ssl_ecdh_curve controls the curve that is
-        used.
+        Such keys are faster and have improved security
+        over previous options.  New variable 
+        linkend="guc-ssl-ecdh-curve">ssl_ecdh_curve
+        controls the curve that is used.
        
       
 
       
        
-        Improve the default ssl_ciphers ciphers (Marko Kreen)
+        Improve the default 
+        linkend="guc-ssl-ciphers">ssl_ciphers ciphers
+        (Marko Kreen)
        
       
 
       
        
-        Allow the server to specify the preferred SSL cipher order (Marko Kreen)
+        Allow the server to specify the preferred SSL cipher
+        order (Marko Kreen)
        
 
        
-        This is controlled by the new configuration parameter ssl_prefer_server_ciphers.
+        This is controlled by the new configuration parameter 
+        linkend="guc-ssl-prefer-server-ciphers">ssl_prefer_server_ciphers.
        
       
 
       
        
-        Have log_connections show SSL encryption information (Andreas Kunert)
+        Have 
+        linkend="guc-log-connections">log_connections
+        show SSL encryption information (Andreas Kunert)
        
       
 
 
       
        
-        Add SQL-level command ALTER SYSTEM command to edit the postgresql.conf configuration file (Amit Kapila)
+        Add SQL-level command 
+        linkend="SQL-ALTERSYSTEM">ALTER SYSTEM command
+        to edit the postgresql.conf configuration file
+        (Amit Kapila)
        
 
        
-        Previously postgresql.conf could only be edited at the file system level.
+        Previously postgresql.conf could only be edited at
+        the file system level.
        
       
 
       
        
-        Add huge_pages configuration parameter to use huge memory pages on Linux (Christian Kruse,
-        Richard Poole, Abhijit Menon-Sen)
+        Add huge_pages
+        configuration parameter to use huge memory pages on Linux
+        (Christian Kruse, Richard Poole, Abhijit Menon-Sen)
        
 
        
 
       
        
-        Show PIDs of lock holders and waiters and improve relation
-        information in log_lock_waits log messages (Christian Kruse)
+        Show PIDs of lock holders and
+        waiters and improve relation information in 
+        linkend="guc-log-lock-waits">log_lock_waits
+        log messages (Christian Kruse)
        
       
 
       
        
-        Add parameter autovacuum_work_mem to control the amount of memory used by autovacuum workers (Peter Geoghegan)
+        Add parameter 
+        linkend="guc-autovacuum-work-mem">autovacuum_work_mem
+        to control the amount of memory used by autovacuum workers
+        (Peter Geoghegan)
        
       
 
       
        
-        Add max_worker_processes to limit the number of background workers (Robert Haas)
+        Add 
+        linkend="guc-max-worker-processes">max_worker_processes
+        to limit the number of background workers (Robert Haas)
        
 
        
-        This is helpful in configuring the standby server to have the required same number of worker processes as the primary.
+        This is helpful in configuring the standby server to have the
+        required same number of worker processes as the primary.
        
       
 
       
        
-        Add configuration parameter wal_log_hints to enable logging of hint bits (Sawada Masahiko)
+        Add configuration parameter 
+        linkend="guc-wal-log-hints">wal_log_hints
+        to enable logging of hint bits (Sawada Masahiko)
        
 
        
-        Hint bits are not normally logged, except when checksums are enabled.  This is useful for tools like pg_rewind.
+        Hint bits are not normally logged, except when checksums are
+        enabled.  This is useful for tools like pg_rewind.
        
       
 
       
        
-        Allow printf-style space padding to be specified in log_line_prefix (David Rowley)
+        Allow printf-style space padding to be specified in 
+        linkend="guc-log-line-prefix">log_line_prefix
+        (David Rowley)
        
       
 
       
        
-        Add superuser-only session_preload_libraries configuration parameter to load libraries at session start (Peter Eisentraut)
+        Add superuser-only 
+        linkend="guc-session-preload-libraries">session_preload_libraries
+        configuration parameter to load libraries at session start
+        (Peter Eisentraut)
        
 
        
-        Such libraries are auto-LOAD'ed, unlike local_preload_libraries.
+        Such libraries are auto-
+        linkend="SQL-LOAD">LOAD'ed, unlike 
+        linkend="guc-local-preload-libraries">local_preload_libraries.
        
       
 
       
        
-        Reduce server logging level when loading shared libraries (Peter Geoghegan)
+        Reduce server logging level when loading shared libraries (Peter
+        Geoghegan)
        
 
        
-        The previous level was LOG, which was too verbose for per-session libraries.
+        The previous level was LOG, which was too verbose
+        for per-session libraries.
        
       
 
       
        
-        Auto-tune effective_cache_size to be four-times shared buffers (Bruce Momjian, Tom Lane)
+        Auto-tune 
+        linkend="guc-effective-cache-size">effective_cache_size
+        to be four-times shared buffers (Bruce Momjian, Tom Lane)
        
       
 
       
        
-        Increase work_mem and maintenance_work_mem defaults by four-times (Bruce Momjian)
+        Increase 
+        linkend="guc-work-mem">work_mem and 
+        linkend="guc-maintenance-work-mem">maintenance_work_mem
+        defaults by four-times (Bruce Momjian)
        
 
        
 
       
        
-        Allow terabyte units to be specified for configuration variable values (Simon Riggs)
+        Allow terabyte units to be specified for configuration variable
+        values (Simon Riggs)
        
       
 
       
        
-        Have Windows ASCII-encoded databases and server process (e.g. postmaster) emit messages in the LC_CTYPE-defined language (Alexander Law,
+        Have Windows ASCII-encoded databases and server process
+        (e.g.  postmaster) emit messages
+        in the LC_CTYPE-defined language (Alexander Law,
         Noah Misch)
        
 
        
-        Previously these messages were output using the Windows ANSI code page.
+        Previously these messages were output using the Windows
+        ANSI code page.
        
       
 
 
       
        
-        Allow recovery.conf parameter min_recovery_apply_delay to force delayed replication (Robert
-        Haas, Fabrízio de Royes Mello, Simon Riggs)
+        Allow 
+        linkend="recovery-config">recovery.conf
+        parameter 
+        linkend="min-recovery-apply-delay">min_recovery_apply_delay
+        to force delayed replication (Robert Haas, Fabrízio de
+        Royes Mello, Simon Riggs)
        
 
        
-        This is useful for delaying replaying of user errors on standby servers.
+        This is useful for delaying replaying of user errors on standby
+        servers.
        
       
 
       
        
-        Add recovery_target option 
-        pg_stop_backup() (MauMau,
-        Heikki Linnakangas)
+        Add 
+        linkend="recovery-target">recovery_target
+        option 
+        WAL stop
+        recovery when a consistent state is reached, i.e.  
+        linkend="functions-admin-backup-table">pg_stop_backup()
+        (MauMau, Heikki Linnakangas)
        
       
 
        
 
        
-        The timestamp reported by pg_last_xact_replay_timestamp() now shows information about committed records, not commits being
-        replayed.  Recovering to restore points now replay the restore point, rather than stop just before the restore point.
+        The timestamp reported by 
+        linkend="functions-recovery-info-table">pg_last_xact_replay_timestamp()
+        now shows information about committed records, not commits being
+        replayed.  Recovering to restore points now replay the restore
+        point, rather than stop just before the restore point.
        
       
 
       
        
-        pg_switch_xlog() now clears the trailing unused space in the WAL file (Heikki Linnakangas)
+        
+        linkend="functions-admin-backup-table">pg_switch_xlog()
+        now clears the trailing unused space in the WAL file
+        (Heikki Linnakangas)
        
 
        
 
       
        
-        Add replication slots to report the WAL activity on streaming standbys (Andres Freund, Robert Haas)
+        Add replication
+        slots to report the WAL activity on streaming
+        standbys (Andres Freund, Robert Haas)
        
 
        
-        Replication slots allow preservation of resources like WAL files on the
-        primary that are needed by standby servers.
+        Replication slots allow preservation of resources like
+        WAL files on the primary that are needed by standby
+        servers.
        
       
 
       
        
-        Reduce spinlock contention during WAL replay (Heikki Linnakangas)
+        Reduce spinlock contention during WAL replay (Heikki
+        Linnakangas)
        
       
 
       
        
-        Report failure return codes from external recovery commands (Peter Eisentraut)
+        Report failure return codes from 
+        linkend="archive-recovery-settings">external recovery commands
+        (Peter Eisentraut)
        
       
 
       
        
-        Write WAL records of running transactions more frequently (Andres Freund)
+        Write WAL records of running transactions more
+        frequently (Andres Freund)
        
 
        
      
 
      
-      <span class="marked">Logical Change-Set Extraction</span>
+      <span class="marked"><link linkend="logicaldecoding">Logical Change-Set Extraction</></span>
 
       
-       The new Logical change-set extraction feature allows database
+       Logical change-set extraction allows database
        changes to be optionally recorded in logical format
-       in the WAL.  This format can be easily processed by external tools.
-       In previous releases, only binary changes were recorded in the
-       WAL.  To implement this feature, the following changes were made:
+       in the WAL.  This format can
+       be easily processed by external tools.  In previous releases, only
+       binary changes were recorded in the WAL.  To implement
+       this feature, the following changes were made:
       
 
       
 
        
         
-         Add new "logical" wal_level to enable logical change-set encoding in WAL (Andres Freund)
+         Add new