9.3 release notes: Add links to SGML sections
authorBruce Momjian
Fri, 3 May 2013 23:40:23 +0000 (19:40 -0400)
committerBruce Momjian
Fri, 3 May 2013 23:40:23 +0000 (19:40 -0400)
doc/src/sgml/release-9.3.sgml

index a6bc1b343f64d29471c63f7f8a5fc193813a8c1d..e705ed8647e04df2d61fcb33476c110d29c848f2 100644 (file)
@@ -81,8 +81,9 @@
 
       
        
-        Add configuration variable lock_timeout to limit lock
-        wait duration (Zoltán Böszörményi)
+        Add configuration variable 
+        linkend="guc-lock-timeout">lock_timeout to limit
+        lock wait duration (Zoltán Böszörményi)
        
       
 
 
       
        
-        Add SP-GiST support for range data types (Alexander Korotkov)
+        Add SP-GiST
+        support for range data types (Alexander Korotkov)
        
       
 
       
        
-        Allow unlogged GiST indexes (Jeevan Chalke)
+        Allow unlogged GiST indexes
+        (Jeevan Chalke)
        
       
 
 
       
        
-        Collect and use histograms for range types (Alexander Korotkov)
+        Collect and use histograms for range
+        types (Alexander Korotkov)
        
       
 
 
       
        
-        Add COPY FREEZE option to avoid the overhead of later
-        marking tuples as committed (Simon Riggs, Jeff Davis)
+        Add COPY FREEZE
+        option to avoid the overhead of later marking tuples as committed
+        (Simon Riggs, Jeff Davis)
        
       
 
       
        
-        Improve performance of NUMERIC calculations (Kyotaro Horiguchi)
+        Improve performance of 
+        linkend="datatype-numeric">NUMERIC calculations
+        (Kyotaro Horiguchi)
        
       
 
       
        
-        Improve grouping of sessions waiting for commit_delay
+        Improve grouping of sessions waiting for 
+        linkend="guc-commit-delay">commit_delay
         (Peter Geoghegan)
        
 
        
 
        
-        Users who have set work_mem based on the previous
-        behavior should revisit that setting.
+        Users who have set 
+        linkend="guc-work-mem">work_mem based on the
+        previous behavior should revisit that setting.
        
       
 
 
       
        
-        Improve performance of the CREATE TEMPORARY TABLE
-        ... ON COMMIT DELETE ROWS clause by only issuing delete if
+        Improve performance of the 
+        linkend="SQL-CREATETABLE">CREATE TEMPORARY TABLE ... ON
+        COMMIT DELETE ROWS clause by only issuing delete if
         the temporary table was accessed (Heikki Linnakangas)
        
       
 
       
        
-        Split pgstat file into per-database and global files (Tomas Vondra)
+        Split the 
+        linkend="guc-stats-temp-directory">pg_stat_tmp
+        statistics file into per-database and global files (Tomas Vondra)
        
 
        
 
       
        
-        Add optional ability to checksum data pages and report corruption
-        (Simon Riggs, Jeff Davis, Greg Smith, Ants Aasma)
+        Add optional ability to 
+        linkend="app-initdb-data-checksums">checksum data pages and
+        report corruption (Simon Riggs, Jeff Davis, Greg Smith, Ants Aasma)
        
 
        
-        The checksum option can be set during initdb.
+        The checksum option can be set during 
+        linkend="APP-INITDB">initdb.
        
       
 
       
        
-        Allow pg_terminate_backend() to terminate other
-        backends with the same role (Dan Farina)
+        Allow 
+        linkend="functions-admin-signal-table">pg_terminate_backend()
+        to terminate other backends with the same role (Dan Farina)
        
 
        
 
       
        
-        Allow the statistics collector to operate properly in cases where
-        the system clock goes backwards (Tom Lane)
+        Allow the 
+        linkend="runtime-config-statistics-collector">statistics
+        collector to operate properly in cases where the system
+        clock goes backwards (Tom Lane)
        
 
        
 
       
        
-        Improve <acronym>LDAP error reporting and documentation
-        (Peter Eisentraut)
+        Improve <link linkend="auth-ldap">LDAP error
+        reporting and documentation (Peter Eisentraut)
        
       
 
 
       
        
-        Change the ssl_ciphers parameter to start with
-        DEFAULT, rather than ALL, then remove
-        insecure ciphers (Magnus Hagander)
+        Change the 
+        linkend="guc-ssl-ciphers">ssl_ciphers parameter
+        to start with DEFAULT, rather than ALL,
+        then remove insecure ciphers (Magnus Hagander)
        
 
        
 
       
        
-        Parse/load pg_ident.conf once, not during each
-        connection (Amit Kapila)
+        Parse and load 
+        linkend="auth-username-maps">pg_ident.conf
+        once, not during each connection (Amit Kapila)
        
 
        
-        This is similar to how pg_hba.conf is processed.
+        This is similar to how 
+        linkend="auth-pg-hba-conf">pg_hba.conf
+        is processed.
        
       
 
 
       
        
-        Dramatically reduce System V shared memory usage (Robert Haas)
+        Dramatically reduce System V shared
+        memory usage (Robert Haas)
        
 
        
 
        
         This renames configuration parameter
-        unix_socket_directory to
-        unix_socket_directories, which accepts a list of
-        directories.
+        unix_socket_directory to 
+        linkend="guc-unix-socket-directories">unix_socket_directories,
+        which accepts a list of directories.
        
       
 
        
 
        
-        The directory is specified as include_dir in server
+        The directory is specified as 
+        linkend="config-includes">include_dir in server
         configuration file.
        
       
 
       
        
-        Increase the maximum initdb-configured value for
-        shared_buffers to 128MB (Robert Haas)
+        Increase the maximum 
+        linkend="APP-INITDB">initdb-configured value for 
+        linkend="guc-shared-buffers">shared_buffers
+        to 128MB (Robert Haas)
        
 
        
-        This is the maximum value initdb attempts to set in
-        postgresql.conf;  the previous value was 32MB.
+        This is the maximum value initdb attempts to set in 
+        linkend="config-setting-configuration-file">postgresql.conf;
+        the previous value was 32MB.
        
       
 
       
        
-        Require superuser privileges to set commit_delay
+        Require superuser privileges to set 
+        linkend="guc-commit-delay">commit_delay
         because it can now potentially delay other sessions (Simon Riggs)
         BACKWARD COMPATIBILITY
        
 
       
        
-        Remove the external PID file on postmaster exit
-        (Peter Eisentraut)
+        Remove the external
+        PID file on postmaster exit (Peter Eisentraut)
        
       
 
       
        
-        Have session id (%c) in
-        log_line_prefix always output four hex digits after
-        the period (Bruce Momjian) COMPATIBILITY
+        Have session id (%c) in 
+        linkend="guc-log-line-prefix">log_line_prefix
+        always output four hex digits after the period (Bruce Momjian)
+        COMPATIBILITY
        
       
 
 
       
        
-        Allow a streaming replication standbys to follow a timeline switch
+        Allow a streaming replication standbys to 
+        linkend="protocol-replication">follow a timeline switch
         (Heikki Linnakangas)
        
 
 
       
        
-        Add SQL functions pg_backup_in_progress()
+        Add SQL functions 
+        linkend="functions-admin-backup">pg_is_in_backup()
         and pg_backup_start_time() (Gilles Darold)
        
 
 
       
        
-        Improve performance of streaming log shipping with
-        synchronous_commit disabled (Andres Freund)
+        Improve performance of streaming log shipping with 
+        linkend="guc-synchronous-commit">synchronous_commit
+        disabled (Andres Freund)
        
       
 
 
       
        
-        Add the last checkpoint's redo location to
-        pg_controldata's output (Fujii Masao)
+        Add the last checkpoint's redo location to 
+        linkend="APP-PGCONTROLDATA">pg_controldata's
+        output (Fujii Masao)
        
 
        
 
       
        
-        Allow tooling like pg_receivexlog to run on computers with different
-        architectures (Heikki Linnakangas)
+        Allow tooling like 
+        linkend="app-pgreceivexlog">pg_receivexlog
+        to run on computers with different architectures (Heikki
+        Linnakangas)
        
       
 
       
        
-        Have pg_basebackup 
-        output a minimal recovery.conf (Zoltán
+        Have 
+        linkend="app-pgbasebackup">pg_basebackup
+        
+        minimal recovery.conf (Zoltán
         Böszörményi, Magnus Hagander)
        
 
 
       
        
-        Allow pg_receivexlog and
-        pg_basebackup 
-        streaming timeline switches (Heikki Linnakangas)
+        Allow 
+        linkend="app-pgreceivexlog">pg_receivexlog
+        and 
+        linkend="app-pgbasebackup">pg_basebackup
+        
+        (Heikki Linnakangas)
        
       
 
       
        
-        Add wal_receiver_timeout parameter to control the WAL
-        receiver timeout (Amit Kapila)
+        Add 
+        linkend="guc-wal-receiver-timeout">wal_receiver_timeout
+        parameter to control the WAL receiver timeout
+        (Amit Kapila)
        
 
        
-        This allows more rapid detection of connection failure. No longer set
-        wal_receiver_status_interval?
+        This allows more rapid detection of
+        connection failure. No longer set 
+        linkend="guc-wal-receiver-status-interval">wal_receiver_status_interval?
        
       
 
       
        
-        Rename replication_timeout to wal_sender_timeout (Amit Kapila)
+        Rename replication_timeout to 
+        linkend="guc-wal-sender-timeout">wal_sender_timeout
+        (Amit Kapila)
        
 
        
      
 
     
-     Write-Ahead Log (<acronym>WAL</>)
+     <link linkend="wal">Write-Ahead Log</link></div> <div class="diff add">+     (<acronym>WAL</>)
 
      
 
 
       
        
-        Implement SQL-standard LATERAL for
+        Implement SQL-standard 
+        linkend="queries-lateral">LATERAL for
         FROM-clause subqueries and function calls (Tom Lane)
        
 
 
       
        
-        Add support for piping COPY and psql
-        \copy to/from an external program (Etsuro Fujita)
+        Add support for piping 
+        linkend="SQL-COPY">COPY and 
+        linkend="APP-PSQL">psql \copy
+        to/from an external program (Etsuro Fujita)
        
       
 
 
       
        
-        Add support to event triggers (Dimitri Fontaine, Robert Haas,
-        Álvaro Herrera)
+        Add support to event triggers
+        (Dimitri Fontaine, Robert Haas, Álvaro Herrera)
        
 
        
 
       
        
-        Allow a multi-row VALUES clause in rules to reference
-        OLD/NEW (Tom Lane)
+        Allow a multi-row 
+        linkend="SQL-VALUES">VALUES clause in rules
+        to reference OLD/NEW (Tom Lane)
        
       
 
       
        
-        Add <command>CREATE SCHEMA ... IF NOT EXISTS clause (Fabrízio de
-        Royes Mello)
+        Add <link linkend="SQL-CREATESCHEMA">CREATE SCHEMA ... IF
+        NOT EXISTS clause (Fabrízio de Royes Mello)
        
       
 
 
       
        
-        Have REASSIGN OWNED also change ownership of shared
-        objects (Álvaro Herrera)
+        Have REASSIGN
+        OWNED also change ownership of shared objects
+        (Álvaro Herrera)
        
       
 
 
       
        
-        Change ON UPDATE SET NULL/SET DEFAULT foreign key
-        actions to affect all referenced columns, not just those referenced
-        in the UPDATE (Tom Lane)
+        Change ON UPDATE
+        SET NULL/SET DEFAULT foreign key actions to affect
+        all referenced columns, not just those referenced in the
+        UPDATE (Tom Lane)
        
 
        
 
       
        
-        Provide clients with constraint violation details as separate fields
-        (Pavel Stehule)
+        Provide clients with 
+        linkend="libpq-pqresulterrorfield">constraint violation details
+        as separate fields (Pavel Stehule)
        
 
        
         This allows clients to retrieve table, column, data type, or constraint
-        name error details. Previously such information had to be extracted from
-        error strings. Client language support is required to access these
+        name error details.  Previously such information had to be extracted from
+        error strings.  Client language support is required to access these
         fields.
        
       
 
        
         These were previously stored as "<unspecified>".
-        This changes the value stored in system column
-        pg_constraint.confmatchtype.  BACKWARD COMPATIBILITY
-        CHANGE
+        This changes the value stored in system column 
+        linkend="catalog-pg-constraint">pg_constraint.confmatchtype.
+        BACKWARD COMPATIBILITY CHANGE
        
       
 
 
       
        
-        Add the ALTER TYPE ... IF NOT EXISTS clause when
-        adding enumerated type labels (Andrew Dunstan)
+        Add the ALTER TYPE ... IF
+        NOT EXISTS clause when adding enumerated type labels
+        (Andrew Dunstan)
        
 
        
 
       
        
-        Add <command>ALTER ROLE ALL SET to add settings to all users
-        (Peter Eisentraut)
+        Add <link linkend="SQL-ALTERROLE">ALTER ROLE ALL
+        SET to add settings to all users (Peter Eisentraut)
        
 
        
-        This allows settings to apply to all users in all
-        databases. ALTER DATABASE SET already allowed
-        addition of settings for all users in a single database.
-        postgresql.conf has a similar effect.
+        This allows settings to apply to all users in all databases. 
+        linkend="SQL-ALTERDATABASE">ALTER DATABASE SET
+        already allowed addition of settings for all users in a single
+        database.  postgresql.conf has a similar effect.
        
       
 
       
        
-        Add support for ALTER RULE ... RENAME (Ali Dar)
+        Add support for ALTER RULE
+        ... RENAME (Ali Dar)
        
       
 
 
       
        
-        Add a materialized view relations (Kevin Grittner)
+        Add a materialized
+        view relations (Kevin Grittner)
        
 
        
 
       
        
-        Make simple views auto-updatable (Dean Rasheed)
+        Make simple views 
+        linkend="SQL-CREATEVIEW-updatable-views">auto-updatable
+        (Dean Rasheed)
        
 
        
-        Simple views that reference some or all columns from a single base table
-        are now updatable by default. More complex views can be made updatable
-        using INSTEAD OF triggers or INSTEAD rules.
+        Simple views that reference some or all columns from a
+        single base table are now updatable by default. More
+        complex views can be made updatable using 
+        linkend="SQL-CREATETRIGGER">INSTEAD OF triggers
+        or INSTEAD rules.
        
       
 
 
       
        
-        Add CREATE RECURSIVE VIEW syntax (Peter Eisentraut)
+        Add CREATE RECURSIVE
+        VIEW syntax (Peter Eisentraut)
        
 
        
 
       
        
-        Increase the maximum length of large objects from 2GB to 4TB (Nozomi
-        Anzai, Yugo Nagata)
+        Increase the maximum length of large
+        objects from 2GB to 4TB (Nozomi Anzai, Yugo Nagata)
        
 
        
 
       
        
-        Allow text timezone designations, e.g. America/Chicago
-        when using the ISO T timestamptz format (Bruce
-        Momjian)
+        Allow text timezone
+        designations, e.g. America/Chicago when using
+        the ISO T timestamptz format (Bruce Momjian)
        
       
 
     
 
    
-    <<span class="marked">type>JSON</</span>>
+    <<span class="marked">link linkend="datatype-json"><type>JSON</></link</span>>
 
     
 
       
        
-        Add operators and functions to extract values from JSON data strings
-        (Andrew Dunstan)
+        Add operators and functions
+        to extract values from JSON data strings (Andrew Dunstan)
        
       
 
       
        
-        Allow JSON data strings to be converted into records (Andrew Dunstan)
+        Allow JSON data strings to be 
+        linkend="functions-json-table">converted into records
+        (Andrew Dunstan)
        
       
 
       
        
-        Add functions to convert values, records, and hstore data to
-        JSON (Andrew Dunstan)
+        Add functions
+        to convert values, records, and hstore data to JSON
+        (Andrew Dunstan)
        
       
 
 
       
        
-        Add array_remove() and array_replace()
+        Add 
+        linkend="array-functions-table">array_remove()
+        and 
+        linkend="array-functions-table">array_replace()
         functions (Marco Nenciarini, Gabriele Bartolini)
        
       
 
       
        
-        Allow concat() and format() to properly
-        expand VARIADIC-labeled arguments (Pavel Stehule)
+        Allow 
+        linkend="functions-string-other">concat()
+        and 
+        linkend="functions-string-format">format()
+        to properly expand VARIADIC-labeled arguments
+        (Pavel Stehule)
        
       
 
       
        
-        Improve format() to handle field width and left/right
-        alignment (Pavel Stehule)
+        Improve 
+        linkend="functions-string-format">format()
+        to handle field width and left/right alignment (Pavel Stehule)
        
       
 
       
        
-        Have to_char(), to_date(), and
-        to_timestamp() properly handle negative century
-        designations (CC) (Bruce Momjian)
+        Have 
+        linkend="functions-formatting-table">to_char(),
+        
+        linkend="functions-formatting-table">to_date(),
+        and 
+        linkend="functions-formatting-table">to_timestamp()
+        properly handle negative century designations (CC)
+        (Bruce Momjian)
        
 
        
 
       
        
-        Have to_date() and to_timestamp()
+        Have 
+        linkend="functions-formatting-table">to_date()
+        and 
+        linkend="functions-formatting-table">to_timestamp()
         return proper results when mixing ISO and Gregorian
         week/day designations (Bruce Momjian)
        
 
       
        
-        Cause pg_get_viewdef() to default to wrapping after
-        every SELECT target list and FROM entry
-        (Marko Tiikkaja)
+        Cause 
+        linkend="functions-info-catalog-table">pg_get_viewdef()
+        to default to wrapping after every 
+        linkend="SQL-SELECT">SELECT target list and
+        FROM entry (Marko Tiikkaja)
        
 
        
-        This causes view output, like from pg_dump,
-        to be more narrow.
+        This causes view output, like from 
+        linkend="APP-PGDUMP">pg_dump, to be
+        more narrow.
        
       
 
       
        
         Have map_sql_value_to_xml_value() properly expand
-        domains (Pavel Stehule)
+        domains (Pavel Stehule)  WHAT IS THE USER-VISIBLE AFFECT HERE?
+        map_sql_value_to_xml_value IS A C FUNCTION
        
       
 
       
        
-        Force cached functions to be replanned if the search_path changes (Tom Lane)
+        Force cached functions to be replanned if the 
+        linkend="guc-search-path">search_path changes
+        (Tom Lane)
        
 
        
 
       
        
-        Allow SPI functions to access the number of rows
-        processed by COPY (Pavel Stehule)
+        Allow SPI
+        functions to access the number of rows processed by
+        COPY (Pavel Stehule)
        
       
 
       
        
         Allow PL/pgSQL to access the number of rows processed by
-        <command>COPY> (Pavel Stehule)
+        <link linkend="SQL-COPY">COPY> (Pavel Stehule)
        
 
        
-        The command is GET DIAGNOSTICS x = ROW_COUNT.
+        The command is 
+        linkend="plpgsql-statements-diagnostics">GET DIAGNOSTICS
+        x = ROW_COUNT.
        
       
 
 
       
        
-        Have PL/Python convert oid values to a proper Python numeric type (Peter Eisentraut)
+        Have PL/Python convert oid values to a proper Python numeric type
+        (Peter Eisentraut)
        
       
 
       
        
-        Handle <acronym>SPI errors raised explicitly with PL/Python's
-        RAISE the same as as internal SPI errors
-        (Oskari Saarenmaa and Jan Urbanski)
+        Handle <link linkend="spi">SPI errors raised
+        explicitly with PL/Python's RAISE the same as as
+        internal SPI errors (Oskari Saarenmaa and Jan Urbanski)
        
       
 
 
       
        
-        Add command-line utility pg_isready to check if
-        the server is ready to accept connections (Phil Sorber)
+        Add command-line utility 
+        linkend="app-pg-isready">pg_isready to
+        check if the server is ready to accept connections (Phil Sorber)
        
       
 
       
        
-        Support multiple 
-        pg_restore, clusterdb,
-        reindexdb, and vacuumdb (Josh
-        Kupershmidt)
+        Support multiple