Update 9.1 release notes to reflect commits through today.
authorTom Lane
Thu, 9 Jun 2011 22:44:05 +0000 (18:44 -0400)
committerTom Lane
Thu, 9 Jun 2011 22:44:46 +0000 (18:44 -0400)
Also do some desultory copy-editing on the notes.

doc/src/sgml/extend.sgml
doc/src/sgml/release-9.1.sgml

index 5ff6d16a41ab292495b0093ca53999f982fb8618..ab538cb500867a9bc38805d8708d24bed6506204 100644 (file)
     considered members of the extension.
    
 
-    id="extension">
+   
     Extension Files
 
    
index 69f34d36cda94e2f73a432c8eb9958236d7c763e..2d6c8edf9bd9234ba7d4085a32666bbf698a1108 100644 (file)
@@ -9,7 +9,7 @@
    2011-??-??
   
 
-  CURRENT AS OF 2011-03-15
+  CURRENT AS OF 2011-06-09
 
   
    Overview
@@ -87,6 +87,9 @@
        For example, disallow
        composite_value.text and
        text(composite_value).
+       Unintentional uses of this syntax have frequently resulted in bug
+       reports; although it was not a bug, it seems better to go back to
+       rejecting such expressions.
        The CAST and :: syntaxes are still available
        for use when a cast of an entire composite value is actually intended.
       
        rechecking the domain type's constraints, whereas before the checks
        were skipped.
       
-
-      
-       Also, such a domain type is no longer allowed to match an
-       anyarray parameter of a polymorphic function, except by
-       explicitly downcasting it to the base array type.
-      
      
 
     
 
      
       
-       Adjust PL/pgSQL's error line reporting code to be consistent
+       Adjust PL/pgSQL's error line numbering code to be consistent
        with other PLs (Pavel Stehule)
       
 
       
      
 
+     
+      
+       Make PL/pgSQL complain about conflicting IN and OUT parameter names
+       (Tom Lane)
+      
+
+      
+       Formerly, the collision was not detected, and the name would just
+       silently refer to only the OUT parameter.
+      
+     
+
+     
+      
+       Type modifiers of PL/pgSQL variables are now visible to the SQL parser
+       (Tom Lane)
+      
+
+      
+       A type modifier (such as a varchar length limit) attached to a PL/pgSQL
+       variable was formerly enforced during assignments, but was ignored for
+       all other purposes.  Such variables will now behave more like table
+       columns declared with the same modifier.  This is not expected to make
+       any visible difference in most cases, but it could result in subtle
+       changes for some SQL commands issued by PL/pgSQL functions.
+      
+     
+
     
 
    
 
      
       
-       Hav
+       Mak
        linkend="monitoring-stats-funcs-table">pg_stat_reset()
        reset all database-level statistics (Tomas Vondra)
       
 
       
        
-        Allow unlogged tables using the 
+        Support unlogged tables using the 
         linkend="SQL-CREATETABLE-description">UNLOGGED
-        clause in CREATE
+        option in CREATE
         TABLE (Robert Haas)
        
 
        
-        These tables are optimized for performance but are cleared in
-        case of a server crash.
+        Such tables provide better update performance than regular tables,
+        but are not crash-safe: their contents are automatically cleared in
+        case of a server crash.  Their contents do not propagate to
+        replication slaves, either.
        
       
 
 
       
        
-        Allow inheritance table queries to return meaningfully-sorted
-        results (Greg Stark, Hans-Jurgen Schonig, Robert Haas, Tom
-        Lane)
-       
-
-       
-        This allows optimization of ORDER BY and
-        LIMIT clauses in inheritance table queries.
+        Allow inheritance table scans to return meaningfully-sorted
+        results (Greg Stark, Hans-Jurgen Schonig, Robert Haas, Tom Lane)
        
-      
 
-      
        
-         Allow optimizations of MIN/MAX for
-         inheritance table queries (Tom Lane)
+        This allows better optimization of queries that use ORDER
+        BY, LIMIT, or MIN/MAX with
+        inherited tables.
        
       
 
       
        
-        Support hashing array values (Tom Lane)
-       
-
-       
-        This provides additional query optimization possibilities.
+         Improve GIN index scan cost estimation (Teodor Sigaev)
        
       
 
       
        
-         Improve GIN index scan cost estimation (Teodor Sigaev)
+        Improve cost estimation for aggregates and window functions (Tom Lane)
        
       
 
        
       
 
+      
+       
+        Reject local lines in 
+        linkend="auth-pg-hba-conf">pg_hba.conf
+        on platforms that don't support Unix-socket connections
+        (Magnus Hagander)
+       
+
+       
+        Formerly, such lines were silently ignored, which could be surprising.
+        This makes the behavior more like other unsupported cases.
+       
+      
+
       
        
         Allow GSSAPI
        
       
 
+      
+       
+        ident
+        authentication over local sockets is now known as
+        peer
+        (Magnus Hagander)
+       
+
+       
+        The old term is still accepted for backward compatibility.
+       
+      
+
+      
+       
+        Rewrite peer
+        authentication to avoid use of credential control messages (Tom Lane)
+       
+
+       
+        This change makes the peer authentication code simpler and
+        better-performing.  However, it requires the platform to provide the
+        getpeereid function or an equivalent socket operation.
+        So far as is known, the only platform for which peer authentication
+        worked before and now will not is pre-5.0 NetBSD.
+       
+      
+
      
 
     
 
       
        This avoids the requirement of manually transferring a file
-       system backup when creating a standby server.
+       system backup when setting up a standby server.
+      
+     
+
+     
+      
+       Add
+       replication_timeout
+       setting (Fujii Masao, Heikki Linnakangas)
+      
+
+      
+       Replication connections that are idle for more than the
+       replication_timeout interval will be terminated
+       automatically.  Formerly, a failed connection was typically not
+       detected until the TCP timeout elapsed, which is inconveniently
+       long in many situations.
       
      
 
       
 
       
-       This is a read-only permission used for streaming replication
-       and allows non-superusers to initiate replication connections.
+       This is a read-only permission used for streaming replication.
+       It allows a non-superuser role to be used for replication connections.
        Previously only superusers could initiate replication
-       connections;  superusers have this permission by default.
-      
-     
-
-     
-      
-       ident
-       authentication over local sockets is now known as
-       peer
-       (Magnus Hagander)
-      
-
-      
-       The old term is still accepted for backward compatibility.
+       connections; superusers still have this permission by default.
       
      
 
        
 
        
-        This returns the time on the primary that generated the most
+        This returns the time at which the primary generated the most
         recent commit or abort record applied on the standby.
        
       
        
         These named restore points can be specified as recovery
         targets using the new recovery.conf setting
-        recovery_target_name
+        recovery_target_name.
        
       
 
        
         Add 
         linkend="guc-restart-after-crash">restart_after_crash
-        which disables server restart after a backend crash (Robert
-        Haas)
+        setting which disables automatic server restart after a backend
+        crash (Robert Haas)
        
 
        
 
      
 
+      
+       
+        Add extensions which
+        simplify packaging of additions to PostgreSQL
+        (Dimitri Fontaine, Tom Lane)
+       
+
+       
+        Extensions are controlled by the new 
+        linkend="SQL-CREATEEXTENSION">CREATE/
+        linkend="SQL-ALTEREXTENSION">ALTER/
+        linkend="SQL-DROPEXTENSION">DROP EXTENSION
+        commands.  This replaces ad-hoc methods of grouping objects that
+        are added to a PostgreSQL installation.
+       
+      
+
       
        
         Add support for foreign
        
       
 
+      
+       
+        Support ALTER TABLE name {OF | NOT OF}
+        type
+        (Noah Misch)
+       
+
+       
+        This syntax allows a standalone table to be made into a typed table,
+        or a typed table to be made standalone.
+       
+      
+
       
        
         Add support for more object types in ALTER ... SET
 
        
         This command is now supported for conversions, operators, operator
-        classes, operator families, text search configurations, and text search
+        classes, operator families, text search configurations, text search
         dictionaries, text search parsers, and text search templates.
        
       
        
 
        
-        This allows a primary key or unique constraint to be added using an
+        This allows a primary key or unique constraint to be defined using an
         existing unique index, including a concurrently created unique index.
        
       
       
        
         Fix possible tuple concurrently updated error
-        when two server backends attempted to add an inheritance
-        parent to the same table at the same time (Robert Haas)
+        when two backends attempted to add an inheritance
+        child to the same table at the same time (Robert Haas)
        
 
        
      
       
        Allow numeric to use a more compact, two-byte header
-       in many cases (Robert Haas)
+       in common cases (Robert Haas)
       
 
       
       
      
 
+     
+      
+       Support hashing array values (Tom Lane)
+      
+
+      
+       This provides additional query optimization possibilities.
+      
+     
+
+     
+      
+       Don't treat a composite type as sortable unless all its column types
+       are sortable (Tom Lane)
+      
+
+      
+       This avoids possible could not identify a comparison function
+       failures at runtime, if it is possible to implement the query without
+       sorting.  Also, ANALYZE won't try to use inappropriate
+       statistics-gathering methods for columns of such composite types.
+      
+     
+
     
 
     
       
      
 
+     
+      
+       Add support for casting from int4 and int8
+       to numeric (Joey Adams)
+      
+     
+
       
        
         Allow casting a table's row type to the table's supertype if
        
 
        
-        This function is used to obtain a human-readable string describing an
-        object, based on the pg_class OID, object OID, and sub-object OID.  It can be used to
-        help interpret the contents of pg_depend.
+        This function is used to obtain a human-readable string describing
+        an object, based on the 
+        linkend="catalog-pg-class">pg_class
+        OID, object OID, and sub-object ID.  It can be used to help
+        interpret the contents of 
+        linkend="catalog-pg-depend">pg_depend.
        
       
 
          Update comments for built-in operators and their underlying
          functions (Tom Lane)
        
+
+       
+        Functions that are meant to be used via an associated operator
+        are now commented as such.
+       
       
 
       
 
       
        
-        Allow INSTEAD
+        Support INSTEAD
         OF triggers on views (Dean Rasheed)
        
 
        
       
 
+      
+       
+         Add traceback information to PL/Python errors (Jan Urbanski)
+       
+      
+
       
        
          Report PL/Python errors from iterators with PLy_elog (Jan
 
       
        
-         Add the \conninfo command to psql,
+         Add psql command \conninfo
          to show current connection information (David Christensen)
        
       
 
       
        
-        Add system table 
-        \dn (schemas) (Tom Lane)
+        Add 
+        \dn (list schemas) command (Tom Lane)
        
 
        
        
 
        
-        This is passed to the editor using the
-        EDITOR_LINENUMBER_SWITCH environment variable.
+        This is passed to the editor according to the
+        EDITOR_LINENUMBER_SWITCH psql variable.
        
       
 
 
       
        
-        Make <application>psql> distinguish between unique
+        Make <literal>\d> distinguish between unique
         indexes and unique constraints (Josh Kupershmidt)
        
       
 
+      
+       
+        Make \dt+ report pg_table_size
+        instead of pg_relation_size when talking to 9.0 or
+        later servers (Bernd Helmle)
+       
+
+       
+        This is a more useful measure of table size, but note that it is
+        not identical to what was previously reported in the same display.
+       
+      
+
       
        
         Additional tab completion support (Itagaki Takahiro, Pavel Stehule,
       
        
         Improve pg_ctl start's wait
-        (
-        non-standard Unix-domain socket locations, permission
-        problems, and stale postmaster lock files (Bruce Momjian)
+        (
+       
+
+       
+        The wait mode is now significantly more robust.  It will not get
+        confused by non-default postmaster port numbers, non-default
+        Unix-domain socket locations, permission problems, or stale
+        postmaster lock files.
        
       
 
 
       
        
-        Allow libpq database clients to use Unix-domain sockets to
+        Allow libpq database clients to
         check the user name of the server process using 
         linkend="libpq-connect-requirepeer">requirepeer
+        when connecting via Unix-domain sockets
         (Peter Eisentraut)
        
 
        
-        PostgreSQL already allowed servers to determine
-        the client user name via Unix-domain sockets.
+        PostgreSQL already allowed servers to check
+        the client user name when connecting via Unix-domain sockets.
        
       
 
        
 
        
-        The allow detection of the server's status without creating
-        a new session.
+        These functions allow detection of the server's status without
+        trying to open a new session.
        
       
 
 
       
        
-        Add extensions which simplify
-        packaging of additions to PostgreSQL (Dimitri
-        Fontaine, Tom Lane)
+        Use +Olibmerrno compile flag with HP-UX C compilers
+        that accept it (Ibrar Ahmed)
        
 
        
-        This is controlled by the new 
-        linkend="SQL-CREATEEXTENSION">CREATE/
-        linkend="SQL-ALTEREXTENSION">ALTER/
-        linkend="SQL-DROPEXTENSION">DROP EXTENSION 
-        command;  this replaces a more manual method of adding features
-        to PostgreSQL.
+        This avoids possible misbehavior of math library calls on recent
+        HP platforms.
        
       
 
 
        
         This allows for faster compiles.  Also, make -k
-        now works properly.
+        now works more consistently.
        
       
 
        
       
 
+      
+       
+        Add make maintainer-check target
+        (Peter Eisentraut)
+       
+
+       
+        This target performs various source code checks that are not
+        appropriate for either the build or the regression tests.  Currently:
+        duplicate_oids, SGML syntax and tabs check, NLS syntax check.
+       
+      
+
+      
+       
+        Support make check in contrib
+        (Peter Eisentraut)
+       
+
+       
+        Formerly only make installcheck worked, but now
+        there is support for testing in a temporary installation.
+        The top-level make check-world target now includes
+        testing contrib this way.
+       
+      
+
      
 
     
 
        
         This allows building 64-bit Windows binaries even on non-Windows
-        platforms with cross-compiling.
+        platforms via cross-compiling.
        
       
 
 
      
 
+      
+       
+        Revise the API for GUC variable assign hooks (Tom Lane)
+       
+
+       
+        The previous functions of assign hooks are now split between check
+        hooks and assign hooks, where the former can fail but the latter
+        shouldn't.  This change will impact add-on modules that define custom
+        GUC parameters.
+       
+      
+
       
        
          Add latches to the source code to wait for events (Heikki
       
        Modify contrib modules and stored procedure
        languages to install via the new 
-       linkend="extension">extension mechanism (Tom Lane,
+       linkend="extend-extensions">extension mechanism (Tom Lane,
        Dimitri Fontaine)
       
-
-      
-       This replaces a more manual method of installation.
-      
      
 
      
 
      
       
-        Allow 
+        Fix 
         linkend="fuzzystrmatch">contrib/fuzzystrmatch's
-        levenshtein() function handle multibyte characters
+        levenshtein() function to handle multibyte characters
         (Alexander Korotkov)
       
      
       
 
       
-       This parameter shows table storage options.
+       This function shows table storage options in a readable form.