Update release notes to be current as of CVS today.

Update major release note items.

First try at a major features list for 8.2.

Fix free space map to correctly track the total amount of FSM space needed
even when a single relation requires more than max_fsm_pages pages.  Also,
make VACUUM emit a warning in this case, since it likely means that VACUUM
FULL or other drastic corrective measure is needed.  Per reports from Jeff
Frost and others of unexpected changes in the claimed max_fsm_pages need.

Add comments about STORAGE option for GIN

Fix table's caption

Updated several parts in particular variable handling. This is work that was part of SoC.

Wording changes for continuous archving, per Simon.

Add documentation for new in-core advisory lock functions.  Merlin Moncure

Add URL for domain casting:

>   http://archives.postgresql.org/pgsql-hackers/2006-09/msg01681.php

Update release notes to use scaron, rather than numeric code for entity.

Fix bogus markup.

Add AIX shared library support item to release notes.

Change patternsel (LIKE/regex selectivity estimation) so that if there
is a large enough histogram, it will use the number of matches in the
histogram to derive a selectivity estimate, rather than the admittedly
pretty bogus heuristics involving examining the pattern contents.  I set
'large enough' at 100, but perhaps we should change that later.  Also
apply the same technique in contrib/ltree's <@ and @> estimator.  Per
discussion with Stefan Kaltenbrunner and Matteo Beccati.

Release note wording improvement.

Alvaro.

Add shared linking information to AIX FAQ.

Laurenz Albe

Improvements to the partitioning documentation. Original patch from Greg
Stark, additional fixes and editorialization by Neil Conway. Greg's patch
description:

    Some more doc patches for partitioned tables. In particular replace
    the caveat that INCLUDING CONSTRAINTS doesn't exist and replace it
    with documentation of, well, INCLUDING CONSTRAINTS.

    Also, there was an instance of "LIKE WITH DEFAULTS" which is
    actually spelled "LIKE INCLUDING DEFAULTS".

Improve usage of effective_cache_size parameter by assuming that all the
tables in the query compete for cache space, not just the one we are
currently costing an indexscan for.  This seems more realistic, and it
definitely will help in examples recently exhibited by Stefan
Kaltenbrunner.  To get the total size of all the tables involved, we must
tweak the handling of 'append relations' a bit --- formerly we looked up
information about the child tables on-the-fly during set_append_rel_pathlist,
but it needs to be done before we start doing any cost estimation, so
push it into the add_base_rels_to_query scan.

Do a round of copy-editing for the release notes: fix some typos and
grammatical errors, improve the description of some new features.

Dashed items are now for 8.3:

< #A hyphen, "-", marks changes that will appear in the upcoming 8.2 release.#
> #A hyphen, "-", marks changes that will appear in the upcoming 8.3 release.#

Remove completed TODO items:

< * -Make postmater and postgres options distinct so the postmaster -o
<   option is no longer needed
< * -Allow pooled connections to list all prepared statements
<
<   This would allow an application inheriting a pooled connection to know
<   the statements prepared in the current session.
<
< * -Re-enable the GUC full_page_writes in 8.2 when reliability issues have
<   been addressed
<  o -Add "include file" functionality in postgresql.conf
<  o -Allow per-database permissions to be set via GRANT
<
<    Allow database connection checks based on GRANT rules in
<    addition to the existing access checks in pg_hba.conf.
<
<  o -Issue a warning if a change-on-restart-only postgresql.conf value
>  o Issue a warning if a change-on-restart-only postgresql.conf value
<    o -Automatically force archiving of partially-filled WAL files when
<      pg_stop_backup() is called or the server is stopped
<    o -Add reporting of the current WAL file and offset, perhaps as
<      part of partial log file archiving
< * -Allow server logs to be remotely read and removed using SQL commands
< * -Allow protocol-level BIND parameter values to be logged
< * -Zero umasked bits in conversion from INET cast to CIDR
< * -Prevent INET cast to CIDR from dropping netmask, SELECT '1.1.1.1'::inet::cidr
< * -Allow INET + INT8 to increment the host part of the address or
<   throw an error on overflow
< * -Add 'tid != tid ' operator for use in corruption recovery
<  o -Allow customization of the known set of TZ names (generalize the
<    present australian_timezones hack)
<  o -Allow timezone names in SQL strings, '2006-05-24 21:11
<     Americas/New_York'::timestamptz
<  o -Add support for day-time syntax, INTERVAL '1 2:03:04' DAY TO
<    SECOND
<  o -Allow NULLs in arrays
< * -Add transaction_timestamp(), statement_timestamp(), clock_timestamp()
<   functionality
<
<   Current CURRENT_TIMESTAMP returns the start time of the current
<   transaction, and gettimeofday() returns the wallclock time. This will
<   make time reporting more consistent and will allow reporting of
<   the statement start time.
<
< * -Allow to_char() to print localized month names
< * -Add sleep() function, remove from regress.c
< * -Allow user-defined functions retuning a domain value to enforce domain
<   constraints
< * -Allow TRUNCATE ... CASCADE/RESTRICT
<
<   This is like DELETE CASCADE, but truncates.
<
< * -Add COMMENT ON for all cluster global objects (roles, databases
<   and tablespaces)
< * -Make row-wise comparisons work per SQL spec
<
<   Right now, '(a, b) < (1, 2)' is processed as 'a < 1 and b < 2', but
<   the SQL standard requires it to be processed as a column-by-column
<   comparison, so the proper comparison is '(a < 1) OR (a = 1 AND b < 2)'.
<
< * -Enable escape_string_warning and standard_conforming_strings
> * Enable standard_conforming_strings
<  o -Add ON COMMIT capability to CREATE TABLE AS ... SELECT
<  o -Allow an alias to be provided for the target table in
<    UPDATE/DELETE (Neil)
<  o -Allow UPDATE tab SET ROW (col, ...) = (val, ...) for updating
<    multiple columns
<  o -Add ALTER TABLE tab INHERIT / NO INHERIT  parent
<  o -Have COPY return the number of rows loaded/unloaded?
<  o -Allow COPY (SELECT ...) TO 'filename'
<
<  o -Allow pooled connections to list all open WITH HOLD cursors
<
<    Because WITH HOLD cursors exist outside transactions, this allows
<    them to be listed so they can be closed.
<
<  o -Allow INSERT INTO tab (col1, ..) VALUES (val1, ..), (val2, ..)
<  o -Allow INSERT/UPDATE ... RETURNING new.col or old.col
<  o -Allow PL/python to return composite types and result sets
<
< * -Have initdb set the input DateStyle (MDY or DMY) based on locale
<  o -Improve psql's handling of multi-line statements
<
<    Currently, while \e saves a single statement as one entry, interactive
<    statements are saved one line at a time.  Ideally all statements
<    would be saved like \e does.
<
<  o -Allow multi-line column values to align in the proper columns
<
<    If the second output column value is 'a\nb', the 'b' should appear
<    in the second display column, rather than the first column as it
<    does now.
<
<  o -Display IN, INOUT, and OUT parameters in \df
<  o -Allow pg_dump to use multiple -t and -n switches, exclusion
<     ability, and regular expression object matching
<  o -Update pg_dump and psql to use the new COPY libpq API (Christopher)
<  o -Add a function to support Parse/DescribeStatement capability
< * -Add fillfactor to control reserved free space during index creation
< * -Add system view to show free space map contents
< * -Allow installing to directories containing spaces
<
<   This is possible if proper quoting is added to the makefiles for the
<   install targets.  Because PostgreSQL supports relocatable installs, it
<   is already possible to install into a directory that doesn't contain
<   spaces and then copy the install to a directory with spaces.
<
< * -%Clean up compiler warnings (especially with gcc version 4)
< * -Remove BeOS and QNX-specific code
<  o -Port contrib/xml2

Document how to use psql's --single-transaction option to rollback restoring
an SQL dump if an error occurs. Along the way, make some improvements and
copy-edits to the surrounding text. Patch from Simon Riggs, additional
fixes by Neil Conway.

Fix broken markup.

Fix shared library creation to work properly on AIX.  Albe Laurenz

Minor additions and typo fixes for the backup documentation. Patch from
Simon Riggs, minor editorialization by Neil Conway.

More 8.2 release item reordering.

Reorder 8.2 release note items more logically.

Update migration changes, more cleanups.

Properly mention in the release notes that fillfactor controls both heap
and indexes.  Other cleanups.

Wrap long lines in 8.2 release notes.

Updates from Jim Nasby.

Add built-in userlock manipulation functions to replace the former
contrib functionality.  Along the way, remove the USER_LOCKS configuration
symbol, since it no longer makes any sense to try to compile that out.
No user documentation yet ... mmoncure has promised to write some.
Thanks to Abhijit Menon-Sen for creating a first draft to work from.

Move 8.2 release documentation into SGML.

Make the order of the CASCADE and RESTRICT keywords in the DROP OWNED
syntax summary consistent with the other SQL reference pages. Patch
from Euler Taveira de Oliveira.

Documentation for VALUES lists.  Joe Conway and Tom Lane

Add URL for commenting postgresql.conf:

>    http://archives.postgresql.org/pgsql-hackers/2006-09/msg01481.php

Add URL for UUID:

>
>   http://archives.postgresql.org/pgsql-patches/2006-09/msg00209.php
>

Fix problems with column name list of CREATE TABLE AS being applied to
the input query's target list too soon, causing it to affect processing
of ORDER BY in the input query.

Add item:

>
> * Set client encoding based on the client operating system encoding
>
>   Currently client_encoding is set in postgresql.conf, which
>   defaults to the server encoding.

Add URL to UPDATE unique index case x=x+1:

<
>    http://archives.postgresql.org/pgsql-hackers/2006-09/msg01458.php

Improve wordings by David Fuhry <dfuhry@cs.kent.edu>

Fix CREATE TABLE ... AS VALUES ... to work rather than Assert'ing;
oversight in original implementation of VALUES.  Also fix an oversight
in recent addition of options to CREATE TABLE AS: they weren't getting
propagated if the query was a set-operation such as UNION.

Change ANALYZE to take ShareUpdateExclusiveLock not AccessShareLock on
the table being analyzed.  This prevents two ANALYZEs from running
concurrently on the same table and possibly suffering concurrent-update
failures while trying to store their results into pg_statistic.  The
downside is that a database-wide ANALYZE executed within a transaction
block will hold ShareUpdateExclusiveLock on many tables simultaneously,
which could lead to concurrency issues or even deadlock against another
such ANALYZE.  However, this seems a corner case of less importance
than getting unexpected errors from a foreground ANALYZE when autovacuum
elects to analyze the same table concurrently.  Per discussion.

Marginal cleanup in arrangements for ensuring StrategyHintVacuum is cleared
after an error during VACUUM.  We have a PG_TRY block anyway around the only
call sites, so just reset it in the CATCH clause instead of having
AtEOXact_Buffers blindly do it during xact end.  I think the old code was
actively wrong for the case of a failure during ANALYZE inside a
subtransaction --- the flag wouldn't get cleared until main transaction end.
Probably not worth back-patching though.

Update TODO for short header versions:

<  o Reorder physical storage order to reduce padding?
<
<    This involves having the user-specified order of columns
<    be different from the physical order.  SELECT * would
<    need to reorder the physical values to match the
<    user-specified ordering.
<
<  o Store disk pages with no alignment/padding?
<
<    This necessitates adding CPU-required padding when moving
<    rows from disk to memory.
<
<    One idea is to store the header in network byte order (high bits
<    first), and read the high bits to determine the header length.
<    http://archives.postgresql.org/pgsql-hackers/2006-09/msg00848.php
>    One idea is to create zero-or-one-byte-header versions
>    of varlena data types.  In involves setting the high-bit and
>    0-127 length in the single-byte header, or clear the high bit
>    and store the 7-bit ASCII value in the rest of the byte.
>    The small-header versions have no alignment requirements.
>    http://archives.postgresql.org/pgsql-hackers/2006-09/msg01372.php

Rename the recently-added pg_timezonenames view to pg_timezone_abbrevs,
and create a new view pg_timezone_names that provides information about
the zones known in the 'zic' database.  Magnus Hagander, with some
additional work by Tom Lane.

Update timezone data files to release 2006k of the zic database.

Rename xml_valid() to xml_is_well_formed(), but provide a temporary
alias with the old name for backwards compatibility.  Per discussion,
the old name is actively wrong because validity and well-formedness
have different meanings in XML.

Define errcode as __msvc_errcode not __vc_errcode for MSVC builds,
per Magnus.

Fix some more uses of str[n]casecmp that should be pg_str[n]casecmp.

Remove emacs info from footer of SGML files.

Document Warm Standby for High Availability

Includes sample standby script.

Simon Riggs

Document WAL recovery now uses checkpoints.

Simon Riggs

Several fixes for MSVC build scripts, from Magnus.

Fix some uses of str[n]casecmp that should be pg_str[n]casecmp.

Fix some uses of str[n]casecmp that should be pg_str[n]casecmp,
per Magnus.

Remove WINLDAPAPI decoration from ldap_start_tls_sA typedef, per Magnus.

Improve confusing comment for HeapTupleSatisfiesNow, per gripe from Greg Stark.

Make postgresql.conf.sample match the initdb defaults.  This fixes
comment alignment on most systems.

Add a couple of information functions to support direct checks on whether
a schema is our own temp schema or another backend's temp schema, and use
these in place of some former kluges in information_schema.  Per my
proposal of yesterday.

Seems no one wants this:

< * -Allow PREPARE to automatically determine parameter types based on the SQL
<   statement (Neil)

Done:

< * -Allow protocol-level BIND parameter values to be logged, if text mode
> * -Allow protocol-level BIND parameter values to be logged

Not done yet:

<  o -Allow commenting of variables in postgresql.conf to restore them
>  o Allow commenting of variables in postgresql.conf to restore them

Fix missing markup.

Remove sslinfo copyright with author permission, keep author attribution.

Victor Wagner

Remove:

< * Research storing only active XIDs in subtransaction cache

Add:

> * Research storing only active XIDs in subtransaction cache

Add XML item.
>
> * Improve XML support
>
>   http://developer.postgresql.org/index.php/XML_Support

Add description for variable-length header:

>    One idea is to store the header in network byte order (high bits
>    first), and read the high bits to determine the header length.

Add recent ICU URL:

>   http://archives.postgresql.org/pgsql-hackers/2006-09/msg00662.php

Update TODO items:

<  o Store disk pages with no alignment/padding?
>
>    This involves having the user-specified order of columns
>    be different from the physical order.  SELECT * would
>    need to reorder the physical values to match the
>    user-specified ordering.
>
>  o Store disk pages with no alignment/padding?
>
>    This necessitates adding CPU-required padding when moving
>    rows from disk to memory.
>
>
>    http://archives.postgresql.org/pgsql-hackers/2006-09/msg00848.php
>

For release notes checklist, add UTF8 URL.

In release notes checklist, add URL for HTML non-ASCII escapes, mention
UTF8 escapes.

Fix SGML markup

Improve error message. Per discussion
http://archives.postgresql.org/pgsql-general/2006-09/msg00186.php

GIN documentation and slightly improving GiST docs.
Thanks to  Christopher Kings-Lynne <chris.kingslynne@gmail.com> for
initial version and Jeff Davis <pgsql@j-davis.com> for inspection

Cygwin systems seem to have a different error message when trying to connect to port 0. Let's try port 20 instead.

Added missing constuctor/destructor for interval and date.

Some small editorialization on the description of CREATE INDEX
CONCURRENTLY.  Greg Stark, some further tweaks by me.

Make logging of extended-protocol commands a bit more consistent, per
discussion with Guillaume Smet.

Code review for patch to avoid second scan when vacuuming index-less
table: avoid invoking LockBufferForCleanup without need, put out the
same log message we would have before, minor code beautification.

Change "tps" to "scale" to avoid confusion

Fix bug with handling default scaling factor in the default
scenarios

Add David Fetter:

> * David is David Fetter <david@fetter.org>

Add uninstall script

Spell readme file's name correctly, per buildfarm reports.

Small fix for the README install for contrib/sslinfo.

Dave Page

Seems this wasn't committed originally

Move set_pglocale_pgservice() from path.c to exec.c, so that pulling in
path.c does not in itself force linking of both exec.c and libintl.
Should fix current ecpglib build failure on pickier platforms.

Move xml2's PG_MODULE_MAGIC block to the right source file, per Michael Fuhr.

Rename the uninstall scripts for contrib/lo and contrib/tsearch2 to
match the convention that foo's uninstall script is uninstall_foo.sql.
Also, stop installing lo_test.sql, which really ought to be made into
a regression test anyway (though it's unclear how to avoid a dependency
on the current OID counter...)

Add LDAP_LIBS_FE to $(libpq) for static or AIX linking, per Albe Laurenz.

Ooops, forgot to update ecpg comparison files to match
source-code change.

Fix omissions in contrib uninstall scripts.  Michael Fuhr

Fix unportable usage complained of by icc.  Per buildfarm results.

Remove unnecessary brace pair.

Back out patch added during 8.2.X development:

Allow to_char() "D" format specifiers for interval/time.

It doesn't work, and I doubt it is useful enough to fix ("D" = day of
week).

Add items:

< * Research storing disk pages with no alignment/padding
> * Consider ways of storing rows more compactly on disk
>
>  o Store disk pages with no alignment/padding?
>  o Reorder physical storage order to reduce padding?
>  o Support a smaller header for short variable-length fields?
>  o Reduce the row header size?

Install a cleaner solution to the AIX libpq linking problem, as per
an earlier discussion.  Centralize assumptions about what libpq depends
on in one place in Makefile.global.  I am unconvinced that this list
is complete, but since ecpg seems to have gotten along with just these
entries, we'll try it this way and see what happens.

Fix dblink build for --enable-nls or --enable-openssl on AIX.
Per Chris Browne.

Remove unhelpful/misleading advice about how to use SPI_saveplan().
Per gripe from Jack Orenstein.