Document how to control the disk write cache on Solaris.

Zdenek Kotala

Remove tab in file name

Document that null ciphers are not recommended.

Mark Mielke

Update docs mentioning PAM doesn't work reading /etc/passwd because of
non-root.

Dhanaraj M

Doc wording improvment.

Document problem with NULL SSL ciphers and man-in-the-middle attacks.

Update examples in planstats.sgml for 8.3, and improve some aspects of
that discussion.  Add a link from perform.sgml.

Update docs:  client always gets server certificate

may -> might

Sorry, hit the wrong button with my last commit. Here's the correct changelog:

Applied patch send by ITAGAKI Takahiro <itagaki.takahiro@oss.ntt.co.jp> to fix bug in connect statement if user name is a variable.
Also fixed test case that didn't detect this.

*** empty log message ***

Disable LOT for the time being because of TeX problems

Update required TeX settings

Improve consistency of error reporting in GUC assign_hook routines.  Some
were reporting ERROR for interactive assignments and LOG for other cases,
some were saying nothing for non-interactive cases, and a few did yet other
things.  Make them use a new function GUC_complaint_elevel() to establish
a reasonably uniform policy about how to report.  There are still a few
edge cases such as assign_search_path(), but it's much better than before.
Per gripe from Devrim Gunduz and subsequent discussion.

As noted by Alvaro, it'd be better to fold these custom messages into the
standard "invalid parameter value" complaint from guc.c, perhaps as the DETAIL
field.  However that will require more redesign than seems prudent for 8.3.
This is a relatively safe, low-impact change that we can afford to risk now.

Disallow digits and lower-case ASCII letters as the delimiter in non-CSV
COPY.  We need a restriction here because when the delimiter occurs as a
data character, it is emitted with a backslash, and that will only work
as desired if CopyReadAttributesText() will interpret the backslash sequence
as representing the second character literally.  This is currently untrue
for 'b', 'f', 'n', 'r', 't', 'v', 'x', and octal digits.  For future-proofing
and simplicity of explanation, it seems best to disallow a-z and 0-9.
We must also disallow dot, since "\." by itself would look like copy EOF.
Note: "\N" is by default the null print string, so N would also cause a
problem, but that is already tested for.

Fix ill-advised usage of x?y:z expressions in errmsg() and errhint() calls.
This prevented gettext from recognizing the strings that need to be
translated.

Swap the order of testing for control characters and for column delimiter in
CopyAttributeOutText(), so that control characters are converted to the
C-style escape sequences even if they happen to be equal to the column
delimiter (as is true by default for tab, for example).  Oversight in my
previous patch to restore pre-8.3 behavior of COPY OUT escaping.  Per report
from Tomas Szepe.

Wording improvements

Update docs to clarify purpose of SSL key file

Add two documentation tables to outline SSL file usage for client and server.

Add documentation section about preventing server spoofing.

Update SSL documention to be clearer about certificates, and restructure
for clarity.

Properly indent SGML paragraph.

Remove paragraph about Linux OOM killer and fork(). Instead link to
article about OOM.

Move item to proper section:

< * Experiment with multi-threaded backend better resource utilization
<
<   This would allow a single query to make use of multiple CPU's or
<   multiple I/O channels simultaneously.  One idea is to create a
<   background reader that can pre-fetch sequential and index scan
<   pages needed by other backends.  This could be expanded to allow
<   concurrent reads from multiple devices in a partitioned table.
<
> * Experiment with multi-threaded backend better resource utilization
>
>   This would allow a single query to make use of multiple CPU's or
>   multiple I/O channels simultaneously.  One idea is to create a
>   background reader that can pre-fetch sequential and index scan
>   pages needed by other backends.  This could be expanded to allow
>   concurrent reads from multiple devices in a partitioned table.

Update find_typedefs to handle simple 'typedef X' cases, per request
from Tom.

Fixed a few minor glitches pointed out by splint.

Modify pgindent to use an external typedefs file rather than included
list.

Remove pgjindent.

libpq needs pgsleep on win32 because of the changes to port/open.c.

Fix a small typo, per Jan Urbanski

On win32, loop when opening files if sharing- och lock-violation errors
occur. Hopefully, this will make it possible to recover from broken
antivirus and/or backup software that locks our files.

When given a nonzero column number, pg_get_indexdef() is only supposed to
print the index key variable or expression for that column.  It was mistakenly
printing ASC/DESC/NULLS FIRST/NULLS LAST decoration too --- and not only for
the target column, but all columns.  Someday we should have an option to
extract that info (and the opclass decoration as well) for a single index
column ... but today is not that day.  Per bug #3829 and subsequent
discussion.

Remove unnecessary logo output from msbuild when cleaning ecpg regression
test outputs.

Make all msvc build scripts use buildenv.pl, not buildenv.bat.

Andrew Dunstan

Fix thinko in encoding check for chr()

Make archiver process report its progress in PS display.  Per
proposal by Simon Riggs, though not exactly his patch.

Make path_recv() and poly_recv() reject paths/polygons containing no points.
The zero-point case is sensible so far as the data structure is concerned,
so maybe we ought to allow it sometime; but right now the textual input
routines for these types don't allow it, and it seems that not all the
functions for the types are prepared to cope.
Report and patch by Merlin Moncure.

Update pg_ctk/kill docs.

Remove tab in SGML file.

Improve wording.

Update archive_command example to use || test, rather than if [].

Some desultory copy-editing on the backup/restore docs.

Mention use all configure options when getting pgindent typedefs.

Mention installing /contrib libraries for pgindent.

Update item description:

* Consider having the background writer update the transaction status
  hint bits before writing out the page

  Implementing this requires the background writer to have access to system
  catalogs and the transaction status log.

Make an editorial pass over the newly SGML-ified contrib documentation.
Fix lots of bad markup, bad English, bad explanations.

Last ones ... whew.  Man, that was tedious.

Windows write-cache wording improvement.

Update write-cache docs to mention windows behavior for various
fsync_methods.

Magnus.

Mention that HOT helps with DELETE space reuse.

Update OOM wording.

Add docs about OOM killer.

lst_hoe01@kwsoft.de

Mention pg_ctl kill for Win32 in docs.

Update pgpool-II mention.

Mark 8.3 as likely now January, 2008 in release notes.

Get dllwrap name from variable instead of hardcoded.

Per complaint from Richard Evans

Fix example archive_command for standalone backups so it doesn't return spurious non-zero.

Use clearer error message for gmake postgres.pdf:

  Makefile:171: *** Invalid target;  use postgres-A4.pdf or postgres-US.pdf as targets.  Stop.

Improve documentation about Julian dates; in particular, point out the
difference between Julian and Gregorian reckoning of when JD 0 was.

Make error message more accurate

Add default error rules for making postgres.pdf and postgres.ps,
suggesting proper target names.

Correct result type of convert_to, per Pavel Stehule.

Clarify log messages

Change a couple of examples to say ALTER MAPPING instead of ADD MAPPING,
per Oleg.

Mark items needing updating for beta stamping.

Improve the method of localizing column names and other fixed strings in
psql's \d commands and other uses of printQuery().  Previously we would pass
these strings through gettext() and then send them to the server as literals
in the SQL query.  But the code was not set up to handle doubling of quotes in
the strings, causing failure if a translation attempted to use the wrong kind
of quote marks, as indeed is now the case for (at least) the French
translation of \dFp.  Another hazard was that gettext() would translate to
whatever encoding was implied by the client's LC_CTYPE setting, which might be
different from the client_encoding setting, which would probably cause the
server to reject the query as mis-encoded.  The new arrangement is to send the
untranslated ASCII strings to the server, and do the translations inside
printQuery() after the query results come back.  Per report from Guillaume
Lelarge and subsequent discussion.

Clean up unportable attempt to use #if inside a macro call, also
faulty code in third arm of #if.  Per buildfarm reports.

Provide a more accurate, detailed log message when the archive command fails.

Add random I/O URL:

>   http://archives.postgresql.org/pgsql-hackers/2007-12/msg00027.php

This item was fixed in a different way, so has been removed:

<
< * Allow free-behind capability for large sequential scans to avoid
<   kernel cache spoiling
<
<   Posix_fadvise() can control both sequential/random file caching and
<   free-behind behavior, but it is unclear how the setting affects other
<   backends that also have the file open, and the feature is not supported
<   on all operating systems.

Adjust release notes for HISTORY.html generation.

Change 'merge sort join', a phrase we use nowhere else, to the more
usual 'merge join'.

Make CSV column ordering a bit more logical.

Make documentation of -W options more accurate and uniform.

Remove the long-deprecated -u option from psql, since it does nothing very
useful and confuses people who think it is the same as -U.  (Eventually
we might want to re-introduce it as being an alias for -U, but that should
not happen until the switch has actually not been there for a few releases.)
Likewise in pg_dump and pg_restore.  Per gripe from Robert Treat and
subsequent discussion.

Typo pointed out by Erwin Brandstetter. Remove the whole makes it even
better, per JD.

Extend the format of CSV logs to include the additional information supplied
with the logged event.  CSV logs are now a first-class citizen along plain
text logs in that they carry much of the same information.

Per complaint from depesz on bug #3799.

Use _USE_32BIT_TIME_T when building with MSVC. Also, enforce that it's
used when building addons.

Dave Page

Remove the -P options of oid2name and pgbench, as they are security
hazards.  Instead teach these programs to prompt for a password when
necessary, just like all our other programs.
I did not bother to invent -W switches for them, since the return on
investment seems so low.

Make vacuumlo prompt for password when needed, thus making its -W
switch optional, as is the case for every other one of our programs.
I had already documented its -W as being optional, so this is bringing
the code into line with the docs ...

Remove Stefan Kaltenbrunner mention from full text release note item.

Add release note introduction.

Mention Stefan Kaltenbrunner as contributor for text search because of
psql work.

Wording improvement for write-cache disabling instructions.

Write cache doc cleanups

Greg Smith

Document how to turn off disk write cache on popular operating systems.

Make an editorial pass over the newly SGML-ified contrib documentation.
Fix lots of bad markup, bad English, bad explanations.

Second round of commits.  pgcrypto and pgstandby still to go...

Change the "distributed checkpoint" release note item to Greg Smith's proposed
wording.

Update Brazilian FAQ.

Euler Taveira de Oliveira

FAQ wording and markup fix.

Euler Taveira de Oliveira

Fix attribution for Rime of the Ancient Mariner (obviously it's been
too long since freshman English :-()

The E. J. Pratt verse used as a tsearch test case is unfortunately still
under copyright in the US and many other places.  Substitute a little
something from a poet who's more safely dead.  Per gripe from Bjorn Munch.

Fix bogus prompt for password in -u case.  Per gripe from Robert Treat.

Fix up the PQconnectionUsedPassword mess: create a separate
PQconnectionNeedsPassword function that tells the right thing for whether to
prompt for a password, and improve PQconnectionUsedPassword so that it checks
whether the password used by the connection was actually supplied as a
connection argument, instead of coming from environment or a password file.
Per bug report from Mark Cave-Ayland and subsequent discussion.

Fix completely-bogus volatility markings on pg_trgm functions.

Fix mergejoin cost estimation so that we consider the statistical ranges of
the two join variables at both ends: not only trailing rows that need not be
scanned because there cannot be a match on the other side, but initial rows
that will be scanned without possibly having a match.  This allows a more
realistic estimate of startup cost to be made, per recent pgsql-performance
discussion.  In passing, fix a couple of bugs that had crept into
mergejoinscansel: it was not quite up to speed for the task of estimating
descending-order scans, which is a new requirement in 8.3.

In the release notes, mention that the "Overview" items are listed in
the sections below in more detail.

In release notes, mention "most" updates are improved with HOT.

Remove completed 8.3 TODO items:

<  o -Allow commenting of variables in postgresql.conf to restore them
<    to defaults
<  o -Add a GUC variable to control the tablespace for temporary objects
<    and sort files
< Monitoring
< ==========
<
< * -Allow server log information to be output as CSV format
< * -Add ability to monitor the use of temporary sort files
< * -Allow user-defined types to accept 'typmod' parameters
<
<   http://archives.postgresql.org/pgsql-hackers/2005-08/msg01142.php
<   http://archives.postgresql.org/pgsql-hackers/2005-09/msg00012.php
<   http://archives.postgresql.org/pgsql-hackers/2006-08/msg00149.php
<
< * -Add Globally/Universally Unique Identifier (GUID/UUID)
<
<   http://archives.postgresql.org/pgsql-patches/2006-09/msg00209.php
<   http://archives.postgresql.org/pgsql-general/2007-01/msg00853.php
<
< * -Support a data type with specific enumerated values (ENUM)
<  o -Add support for arrays of complex types
<  o -Make 64-bit version of the MONEY data type
< * -Add ISO day of week format 'ID' to to_char() where Monday = 1
< * -Add a field 'isoyear' to extract(), based on the ISO week
< * -Add RESET SESSION command to reset all session state
<  o -Make CLUSTER preserve recently-dead tuples per MVCC requirements
<  o -Add more logical syntax CLUSTER table USING index;
<    support current syntax for backward compatibility
<  o -Allow UPDATE/DELETE WHERE CURRENT OF cursor
<  o -Add support for MOVE cursors
<  o -Allow PL/PythonU to return boolean rather than 1/0
<  o -Allow psql \pset boolean variables to set to fixed values, rather
<    than toggle
<  o -Add -f to pg_dumpall
< Dependency Checking
< ===================
<
< * -Flush cached query plans when the dependent objects change or
<   when new ANALYZE statistics are available
< * -Track dependencies in function bodies and recompile/invalidate
< * -Invalidate prepared queries, like INSERT, when the table definition
<   is altered
<
< * -Allow use of indexes to search for NULLs
< * -Allow the creation of indexes with mixed ascending/descending
<   specifiers
< * -Reduce checkpoint performance degredation by forcing data to disk
<   more evenly
< * -Allow sequential scans to take advantage of other concurrent
<   sequential scans, also called "Synchronised Scanning"
< * -Consider shrinking expired tuples to just their headers
< * -Allow heap reuse of UPDATEd rows if no indexed columns are changed,
<   and old and new versions are on the same heap page
< * -Reduce XID consumption of read-only queries
<  o -Turn on by default
<  o -Allow multiple vacuums so large tables do not starve small
<    tables
< * -Allow the pg_xlog directory location to be specified during initdb
<   with a symlink back to the /data location
< * -Allow buffered WAL writes and fsync
< * -Allow ORDER BY ... LIMIT # to select high/low value without sort or
<   index using a sequential scan for highest/lowest values
< * -Merge xmin/xmax/cmin/cmax back into three header fields
<  o -Support a smaller header for short variable-length fields
< * -Move NAMEDATALEN from postgres_ext.h to pg_config_manual.h
< * -Fix problem with excessive logging during SSL disconnection
<
<   http://archives.postgresql.org/pgsql-bugs/2006-12/msg00122.php
<   http://archives.postgresql.org/pgsql-bugs/2007-05/msg00065.php
<
<  o -Add long file support for binary pg_dump output

Update HOT description to make index column changes clearer.

Change documentation, change "distributed" checkpoints to "smoothed"
checkpoints.

Clean up a couple of problems in crosstab_hash's use of a hash table.
The original coding leaked memory (at least 8K per crosstab_hash call)
because it allowed the hash table to be allocated as a child of
TopMemoryContext and then never freed it.  Fix that by putting the
hash table under per_query_ctx, instead.  Also get rid of use
of a static variable to point to the hash table.  Aside from being
ugly, that would actively do the wrong thing in the case of re-entrant
calls to crosstab_hash, which are at least theoretically possible
since it was expecting the static variable to stay valid across
a SPI_execute call.