Add links to documentation sections in 9.0 release notes.
authorBruce Momjian
Sun, 21 Mar 2010 00:43:40 +0000 (00:43 +0000)
committerBruce Momjian
Sun, 21 Mar 2010 00:43:40 +0000 (00:43 +0000)
Also update tagging instructions, and add id tags to a few documentation
sections.

doc/src/sgml/ref/psql-ref.sgml
doc/src/sgml/release-9.0.sgml
doc/src/sgml/release.sgml
doc/src/sgml/runtime.sgml

index e27df586be557fb214f6b0efc6ee3de38459bcc5..33c7488d64f44ffbfaa48b1b8a2371c870b9fefc 100644 (file)
@@ -1,5 +1,5 @@
 
 
@@ -627,7 +627,7 @@ testdb=>
     
   
 
-  
+   id="APP-PSQL-meta-commands">
     Meta-Commands
 
     
index 21ad61c44ef91e7fad56af349f30ddd74f212d80..80c716a6d2138fbe3277a90a9d8a824968a313fa 100644 (file)
@@ -1,4 +1,4 @@
-
+
 
 
  
 
       
         
-          Fix SIMILAR TO to match the SQL standard-specified behavior
-          by processing ? and {} the same way they are
-          processed in regular expressions (Tom)
+          Fix SIMILAR
+          TO to match the SQL standard-specified behavior
+          by processing ? and {} the same way
+          they are processed in regular expressions (Tom)
         
       
 
           
 
           
-            This behavior can be changed via the server variable
-            plpgsql.variable_conflict, or by the per-function option
-            #variable_conflict. The former behavior was to bind to
-            variable names over column names.
+            This behavior can be changed via the server variable 
+            linkend="plpgsql-var-subst">plpgsql.variable_conflict,
+            or by the per-function option #variable_conflict.
+            The former behavior was to bind to variable names over
+            column names.
           
         
 
           
 
           
-            Instead, use ALIAS, which can now alias any variable,
-            not just dollar sign variables, e.g. $1.
+            Instead, use 
+            linkend="plpgsql-declaration-parameters">ALIAS,
+            which can now alias any variable, not just dollar sign
+            variables, e.g. $1.
           
         
 
 
             
               This feature is called Hot Standby.  There are new
-              postgresql.conf and recovery.conf settings
-              to enable this feature, as well as extensive documentation.
+              postgresql.conf and recovery.conf
+              settings to enable this feature, as well as extensive
+              documentation.
             
           
 
           
             
               Allow continuous archive (WAL) files to be streamed to a
-              standby system (Fujii Masao,  Heikki)
+              standby system (Fujii Masao, Heikki)
             
 
             
               Previously WAL files could be sent to standby systems only
               as 16 megabytes files;  this allows master changes to be sent to the
               slave with very little delay.  There are new postgresql.conf
-              and recovery.conf settings to enable this feature, as
-              well as extensive documentation.
+              and recovery.conf settings to enable this
+              feature, as well as extensive 
+              linkend="streaming-replication">documentation.
             
           
 
           
             
-              Add pg_last_xlog_receive_location() and
-              pg_last_xlog_replay_location(), which can be used to
-              monitor standby server WAL activity (Fujii Masao,
-              Heikki)
+              Add 
+              linkend="functions-recovery-info-table">pg_last_xlog_receive_location()
+              and pg_last_xlog_replay_location(), which
+              can be used to monitor standby server WAL
+              activity (Fujii Masao, Heikki)
             
           
 
             
 
             
-              While the Genetic Query Optimizer (GEQO) still selects random plans,
-              it now selects the same random plans for identical queries.  You
-              can modify geqo_seed to randomize the starting value
-              of the random plan generator.
+              While the Genetic Query Optimizer (GEQO) still selects
+              random plans, it now selects the same random plans for
+              identical queries.  You can modify 
+              linkend="guc-geqo-seed"> to
+              randomize the starting value of the random plan generator.
             
           
 
           
             
               Improve optimizer statistics for greater/less-than comparisons
-          (Tom)
+              (Tom)
             
 
             
 
           
             
-              Add support for RADIUS (Remote Authentication Dial In
-              User Service) authentication (Magnus)
+              Add support for 
+              linkend="auth-radius">RADIUS (Remote
+              Authentication Dial In User Service) authentication
+              (Magnus)
             
           
 
 
           
             
-              Allow <acronym>LDAP (Lightweight Directory Access Protocol)
-              authentication to operate in "search/bind" mode (Robert Fleming,
-              Magnus)
+              Allow <link linkend="auth-ldap">LDAP
+              (Lightweight Directory Access Protocol) authentication
+              to operate in "search/bind" mode (Robert Fleming, Magnus)
             
 
             
 
           
             
-              Add samehost and samenet designations to
+              Add 
+              linkend="auth-pg-hba-conf">samehost
+              and samenet designations to
               pg_hba.conf (Stef Walter)
             
 
 
           
             
-              Add the ability for clients to set an application name, which is
-              displayed in pg_stat_activity (Dave Page)
+              Add the ability for clients to set an 
+              linkend="libpq-connect-application-name">application
+              name, which is displayed in
+              pg_stat_activity (Dave Page)
             
           
 
           
             
-              Add an SQL state option (%e) to log_line_prefix
+              Add an SQL state option (%e) to 
+              linkend="guc-log-line-prefix">log_line_prefix
               (Guillaume Smet)
             
           
 
           
             
-              Add pg_stat_reset_shared('bgwriter') to reset the
-              cluster-wide shared statistics of the bgwriter (Greg Smith)
+              Add 
+              linkend="monitoring-stats-funcs-table">pg_stat_reset_shared('bgwriter')
+              to reset the cluster-wide shared statistics of the
+              bgwriter (Greg Smith)
             
           
 
           
             
-              Add pg_stat_reset_single_table_counters() and
-              pg_stat_reset_single_function_counters() to allow the
-              reseting of statistics counters for individual tables and indexes
-              (Magnus)
+              Add 
+              linkend="monitoring-stats-funcs-table">pg_stat_reset_single_table_counters()
+              and pg_stat_reset_single_function_counters()
+              to allow the reseting of statistics counters for individual
+              tables and indexes (Magnus)
             
           
 
 
           
             
-              Allow setting of configuration variables based on database/role
+              Allow setting of configuration variables based on 
+              linkend="sql-alterrole-title">database/role
               combinations (Alvaro)
             
 
 
           
             
-              Add boolean variable bonjour, which controls whether
-              a Bonjour-enabled binary advertises itself via Bonjour
-              (Tom)
+              Add boolean variable 
+              linkend="guc-bonjour">bonjour, which
+              controls whether a Bonjour-enabled binary advertises
+              itself via Bonjour (Tom)
             
 
             
 
         
           
-            Increase the supported frame options in window functions (Hitoshi
+            Increase the supported frame options in 
+            linkend="SQL-WINDOW">window functions (Hitoshi
             Harada)
           
 
           
         
 
+        
+          
+            Have SELECT and CREATE TABLE AS return
+            row counts to the client
+            (Boszormenyi Zoltan)
+          
+
+          
+            psql does not display these counts.
+          
+        
 
       
 
 
           
             
-              Add Unicode surrogate pair (dual 16-bit) support to U&
+              Add Unicode surrogate pair (dual 16-bit) support to
+              
+              linkend="sql-syntax-strings-uescape">U&
               strings and identifiers (Peter)
             
           
 
           
             
-              Allow Unicode escapes in E'...' strings (Marko Kreen)
+              Allow Unicode escapes in 
+              linkend="sql-syntax-strings-escape">E'...'
+              strings (Marko Kreen)
             
           
 
-
         
 
       
 
           
             
-              Add ALTER DEFAULT PRIVILEGES command to control privileges of
-              all newly-created objects (Petr Jelinek)
+              Add ALTER
+              DEFAULT PRIVILEGES command to control privileges
+              of all newly-created objects (Petr Jelinek)
             
 
             
       
 
       
-        <<span class="marked">command>CREATE TABLE</</span>>
+        <<span class="marked">link linkend="SQL-CREATETABLE"><command>CREATE TABLE</></link</span>>
         
 
           
             
           
 
-          
-            
-              Have SELECT and CREATE TABLE AS return
-              row counts to the client
-              (Boszormenyi Zoltan)
-            
-
-            
-              psql does not display these counts.
-            
-          
-
         
 
       
 
           
             
-              Add the ability to make mass permission changes per schema using
-              the new GRANT/REVOKE IN SCHEMA clause
-              (Petr Jelinek)
+              Add the ability to make mass permission changes per
+              schema using the new 
+              linkend="SQL-GRANT">GRANT/REVOKE
+              IN SCHEMA clause (Petr Jelinek)
             
           
 
 
         
           
-            Allow <command>NOTIFY to pass an optional string to listeners
-            (Joachim Wieland)
+            Allow <link linkend="SQL-NOTIFY">NOTIFY
+            to pass an optional string to listeners (Joachim Wieland)
           
         
 
       
 
       
-        <<span class="marked">command>COPY</</span>>
+        <<span class="marked">link linkend="SQL-COPY"><command>COPY</></link</span>>
         
 
           
       
 
       
-        <<span class="marked">command>EXPLAIN</</span>>
+        <<span class="marked">link linkend="SQL-EXPLAIN"><command>EXPLAIN</></link</span>>
         
 
           
       
 
       
-        <<span class="marked">command>VACUUM</</span>>
+        <<span class="marked">link linkend="SQL-VACUUM"><command>VACUUM</></link</span>>
         
 
           
           
             
               Allow an index to be auto-named by not supplying an index name to
-              <command>CREATE INDEX> (Tom)
+              <link linkend="SQL-CREATEINDEX">CREATE INDEX> (Tom)
             
           
 
           
             
-              Allow REINDEX on system indexes (Tom)
+              Allow REINDEX
+              on system indexes (Tom)
             
 
             
 
         
           
-            Allow hex values to be specified in bytea strings (Peter)
+            Allow hex values to be specified in 
+            linkend="datatype-binary">bytea strings
+            (Peter)
           
 
           
-            The variable <varname>bytea_output> controls if hex (default)
+            The variable <xref linkend="guc-bytea-output"> controls if hex (default)
             or octal escapes are used for bytea output.  (SWITCH
             DEFAULT FOR BETA?  PETER)  Libpq's PQescapeByteaConn()
             now uses the hex format for PostgreSQL 9.0 servers.
 
         
           
-            Allow <varname>extra_float_digits> to be increased to 3
+            Allow <xref linkend="guc-extra-float-digits"> to be increased to 3
         (Tom)
           
 
 
         
           
-            Allow case-insensitive regular expression matching with UTF-8
-            server encodings.
+            Allow case-insensitive 
+            linkend="functions-posix-regexp">regular expression
+            matching with UTF-8 server encodings.
           
 
           
 
         
           
-            Add support for to_char() scientific notation output
-            ('EEEE') (Pavel Stehule, Brendan Jurd)
+            Add support for 
+            linkend="functions-formatting">to_char()
+            scientific notation output (
+            linkend="functions-formatting-numeric-table">'EEEE')
+            (Pavel Stehule, Brendan Jurd)
           
         
 
         
           
-            Have to_char() honor 'FM' (fill mode) in
-            'Y', 'YY', and 'YYY' specifications
-            (Bruce)
+            Have to_char() honor 
+            linkend="functions-formatting-datetimemod-table">'FM'
+            (fill mode) in 'Y', 'YY', and
+            'YYY' specifications (Bruce)
           
 
           
 
           
             
-              Add the string_agg() aggregate function which aggregates
-              values into a single string (Pavel Stehule)
+              Add the 
+              linkend="functions-aggregate-table">string_agg()
+              aggregate function which aggregates values into a single
+              string (Pavel Stehule)
             
 
             
 
           
             
-              Add get_bit() and set_bit() functions
-              for bit strings, mirroring those for bytea
-              (Leonardo F)
+              Add 
+              linkend="functions-binarystring-other">get_bit()
+              and set_bit() functions for bit
+              strings, mirroring those for bytea (Leonardo
+              F)
             
           
 
           
             
-              Implement OVERLAY() (replace) for bit strings
-              and bytea (Leonardo F)
+              Implement 
+              linkend="functions-string-sql">OVERLAY()
+              (replace) for bit strings and bytea
+              (Leonardo F)
             
           
 
 
           
             
-              Add pg_table_size() and pg_indexes_size()
-              to provide a more user-friendly interface to the
-              pg_relation_size() function (Bernd Helmle)
+              Add 
+              linkend="functions-admin-dbsize">pg_table_size()
+              and pg_indexes_size() to provide a more
+              user-friendly interface to the pg_relation_size()
+              function (Bernd Helmle)
             
           
 
           
             
-              Add has_sequence_privilege() for sequence permission
-              checking (Abhijit Menon-Sen)
+              Add 
+              linkend="functions-info-access-table">has_sequence_privilege()
+              for sequence permission checking (Abhijit Menon-Sen)
             
           
 
           
             
               Have information schema properly display date type octet lengths
-          (Peter)
+              (Peter)
             
 
             
 
           
             
-              Implement anonymous functions using the DO statement
-              (Petr Jelinek, Joshua Tolley, Hannu Valtonen)
+              Implement anonymous functions using the 
+              linkend="SQL-DO">DO statement (Petr
+              Jelinek, Joshua Tolley, Hannu Valtonen)
             
 
             
 
           
             
-              Allow SQL-compliant per-column triggers (Itagaki Takahiro)
+              Allow SQL-compliant 
+              linkend="SQL-CREATETRIGGER">per-column triggers
+              (Itagaki Takahiro)
             
 
             
 
           
             
-              Add WHERE clause to CREATE TRIGGER to
-              allow control over whether a trigger is fired (Takahiro Itagaki)
+              Add WHERE clause to 
+              linkend="SQL-CREATETRIGGER">CREATE TRIGGER
+              to allow control over whether a trigger is fired (Takahiro
+              Itagaki)
             
 
             
 
         
           
-            Add the OR REPLACE clause to CREATE
-            LANGUAGE (Tom)
+            Add the OR REPLACE clause to 
+            linkend="SQL-CREATELANGUAGE">CREATE LANGUAGE
+            (Tom)
           
 
           
         
 
         
-        PL/PgSQL Server-Side Language
+        <link linkend="plpgsql">PL/PgSQL</link> Server-Side</div> <div class="diff add">+        Language
 
         
 
       
 
       
-        <span class="marked">PL/pgSQL Cursors</span>
+        <span class="marked"><link linkend="plpgsql-cursors">PL/pgSQL Cursors</link></span>
         
 
           
       
 
       
-        <span class="marked">PL/Perl</span> Server-Side Language
+        <span class="marked"><link linkend="plperl">PL/Perl</link></span> Server-Side Language
         
 
           
 
           
             
-              Add server variable <varname>plperl.on_init> to specify a PL/Perl
+              Add server variable <xref linkend="guc-plperl-on-init"> to specify a PL/Perl
               Perl initialization function (Tim Bunce)
             
 
             
-              <varname>plperl.on_plperl_init> and plperl.on_plperlu_init
+              <xref linkend="guc-plperl-on-plperl-init"> and plperl.on_plperlu_init
               are also available for trusted/untrusted-specific initialization.
             
           
       
 
       
-        <span class="marked">PL/Python</span> Server-Side Language
+        <span class="marked"><link linkend="plpython">PL/Python</link></span> Server-Side Language
         
 
           
             
 
             
-              The new server-side language is called plpython3u.
+              The new server-side language is called 
+              linkend="plpython-python23">plpython3u.
             
           
 
 
         
         
-          Add <command>vacuumdb 
-          analyze (Bruce)
+          Add <link linkend="APP-VACUUMDB">vacuumdb
+          analyze (Bruce)
           
         
 
       
 
       
-        <<span class="marked">application>psql</</span>>
+        <<span class="marked">link linkend="APP-PSQL"><application>psql</></link</span>>
         
 
           
             
-              Properly escape psql variables and identifiers
-              (Pavel Stehule, Robert Haas)
+              Properly escape psql 
+              linkend="APP-PSQL-variables">variables and
+              identifiers (Pavel Stehule, Robert Haas)
             
 
             
         
 
         
-          <application>psql</> <command>\d</> Commands
+          <application>psql</> <link</div> <div class="diff add">+          linkend="APP-PSQL-meta-commands"><command>\d</></link></div> <div class="diff add">+          Commands
           
 
             
       
 
       
-        <<span class="marked">application>pg_dump</</span>>
+        <<span class="marked">link linkend="APP-PGDUMP"><application>pg_dump</></link</span>>
         
 
           
             
-              Have pg_dump/pg_restore 
+              Have pg_dump/pg_restore
+              
               also remove large objects (Itagaki Takahiro)
             
           
 
           
             
-              Have pg_dump 
-              pg_dump and server versions in text output mode (Jim
-              Cox, Tom)
+              Have pg_dump 
+              linkend="pg-dump-options">
+              output the pg_dump and server versions
+              in text output mode (Jim Cox, Tom)
             
 
             
       
 
       
-        <application>pg_ctl</>
+        <link</div> <div class="diff add">+        linkend="app-pg-ctl"><application>pg_ctl</></link>
         
 
           
       <application>Development Tools</>
 
       
-        <<span class="marked">application>libpq</</span>>
+        <<span class="marked">link linkend="libpq"><application>libpq</></link</span>>
 
         
 
           
             
               Add new libpq functions
-              PQconnectdbParams() and PQconnectStartParams()
-              (Guillaume Lelarge)
+              
+              linkend="libpq-connect">PQconnectdbParams()
+              and PQconnectStartParams() (Guillaume
+              Lelarge)
             
 
             
 
           
             
-              Add libpq functions PQescapeLiteral() and
-              PQescapeIdentifier() (Robert Haas)
+              Add libpq functions 
+              linkend="libpq-exec-escape-string">PQescapeLiteral()
+              and PQescapeIdentifier() (Robert Haas)
             
 
             
 
           
             
-              Add checking for a per-user service file (.pg_service.conf),
-              which is checked before the site-wide service file (Peter)
+              Add checking for a per-user service file (
+              linkend="libpq-pgservice">.pg_service.conf),
+              which is checked before the site-wide service file
+              (Peter)
             
 
             
 
           
             
-              Issue a warning if the .pgpass-retrieved password fails
-              (Bruce)
+              Issue a warning if the 
+              linkend="libpq-pgpass">.pgpass-retrieved
+              password fails (Bruce)
             
           
 
       
 
       
-        <<span class="marked">application>ecpg</</span>>
+        <<span class="marked">link linkend="ecpg"><application>ecpg</></link</span>>
         
 
           
             
-              Add SQLDA (SQL Descriptor Area) support to ecpg
+              Add SQLDA
+              (SQL Descriptor Area) support to ecpg
               (Boszormenyi Zoltan)
             
           
 
           
             
-              Add the DESCRIBE [OUTPUT] statement to
-              ecpg (Boszormenyi Zoltan)
+              Add the DESCRIBE
+              [OUTPUT] statement to ecpg
+              (Boszormenyi Zoltan)
             
           
 
           
             
-              Add an ecpg function to return the current transaction
-              status (Bernd Helmle)
+              Add an ecpg 
+              linkend="ecpg-library">function to return the
+              current transaction status (Bernd Helmle)
             
           
 
           
 
           
-            Thread-safe builds can be disabled with configure
+            Thread-safe builds can be disabled with 
+            linkend="configure">configure
             
           
         
           
 
           
-            Now that /proc/self/oom_adj allows disabling of the
-            Linux out-of-memory (OOM) killer for the
-            postmaster and its children, the new compile-time option
-            -DLINUX_OOM_ADJ=0 allows the killer to be enabled for
-            postmaster children.  pg_config shows if
-            this flag was used during compilation.
+            Now that /proc/self/oom_adj allows disabling
+            of the Linux out-of-memory (OOM)
+            killer for the postmaster and its children, the new
+            compile-time option 
+            linkend="linux-memory-overcommit">-DLINUX_OOM_ADJ=0
+            allows the killer to be enabled for postmaster
+            children.  pg_config shows if this flag
+            was used during compilation.
           
         
 
 
           
             
-              New Makefile targets world,
-              install-world, and installcheck-world (Andrew)
+              New Makefile targets 
+              linkend="build">world,
+              install-world, and installcheck-world
+              (Andrew)
             
 
             
 
           
             
-              Add data and documentation location control to PGXS
-              Makefiles (Mark Cave-Ayland)
+              Add data and documentation location control to 
+              linkend="xfunc-c-pgxs">PGXS Makefiles
+              (Mark Cave-Ayland)
             
           
 
 
           
             
-              Add support for compiling on 64-bit Windows and running
-              in 64-bit mode (Tsutomu Yamada, Magnus)
+              Add support for compiling on 
+              linkend="install-win32-full">64-bit
+              Windows and running in 64-bit
+              mode (Tsutomu Yamada, Magnus)
             
 
             
 
           
             
-              Allow server builds using Visual Studio 2008 (Magnus)
+              Allow server builds using 
+              linkend="install-win32-full">Visual Studio
+              2008 (Magnus)
             
           
 
           
         
 
+        
+          
+            Add a new ERRCODE_INVALID_PASSWORD SQLSTATE error
+            code (Bruce)
+          
+        
+
         
           
             Properly remove the few remaining personal source code copyright
           
         
 
-        
-          
-            Add a new ERRCODE_INVALID_PASSWORD SQLSTATE error
-            code (Bruce)
-          
-        
-
       
 
       
 
           
             
-              Add AggCheckCallContext() for use in detecting if a
-              C function is being called as an aggregate (Hitoshi
-              Harada)
+              Add 
+              linkend="xaggr">AggCheckCallContext()
+              for use in detecting if a C function is
+              being called as an aggregate (Hitoshi Harada)
             
           
 
 
           
             
-              Add support for preservation of all relfilenodes, for
-              use during binary upgrades (Bruce)
+              Add support for preservation of all 
+              linkend="catalog-pg-class">relfilenodes,
+              for use during binary upgrades (Bruce)
             
           
 
 
         
           
-            Add multi-threaded option (
-            /contrib/pgbench (Itagaki Takahiro)
+            Add multi-threaded option (