Revise platform FAQs.

Improve wording.

Update jdbc doc to reflect correct name of the PGConnection class.

Fixes bug where join to pg_description was incorrect.  Also modifies the
regression test to test for this case.  Patch submitted by Kris Jurka.

 Modified Files:
  jdbc/org/postgresql/jdbc1/AbstractJdbc1DatabaseMetaData.java
  jdbc/org/postgresql/test/jdbc2/DatabaseMetaDataTest.java

Add cast to suppress compile warning on Alphas.

Back out use of palloc0 in place if palloc/MemSet.  Seems constant len
to MemSet is a performance boost.

Update russian FAQ, from Viktor Vislobokov.

Merge palloc()/MemSet(0) calls into a single palloc0() call.

Add palloc0 function to inline MemSet for newNode call.

This trivial patch removes 2 unused defines from pg_config.h.in:
FASTBUILD and DATEDEBUG weren't referenced by any other code.

Neil Conway

I am attaching a patch file that will replace the previous one.  It only
contains the patches to Makefile.global.in and Makefile.unixware.  The
Makefile.unixware patch has been updated to include the contents of
LD_LIBRARY_PATH, if present, to the -rpath (-R) option.  This change
will  simplify configuring and building PostgreSQL on systems that
support  LD_LIBRARY_PATH.  You can set LD_LIBRARY_PATH to include all
the directorys  you want to have searched for additional libraries, run
configure, then run  make.  The paths in LD_LIBRARY_PATH will then be
embedded in the executables  via the -rpath (-R) option to the linker,
and so will not require  LD_LIBRARY_PATH in order to run.

Billy G. Allie

This patch makes a minor cleanup to the implementation of PERFORM in
PL/PgSQL. Previously, it had been bundled together with the assign
statement implementation, for some reason that wasn't clear to me
(they certainly don't share any code with one another). So I separated
them and made PERFORM a statement like any other. No changes in
functionality.

Along the way, I added some regression tests for PERFORM, added a
bunch more SGML tags to the PL/PgSQL docs, and removed an obsolete
comment relating to the implementation of RETURN NEXT.

Neil Conway

> > I'll re-check that with the ppc architecture guy here.
>
> ... he is now about to write an inlined version that can go into
> s_lock.h . I'll send the new patch later on...

OK, here it comes:

An inlined version of tas(), that works for both, powerpc and
powerpc64. The patch is against 7.3b5 and passes the test suite on
both architectures.

Reinhard Max

Add documentation for array_upper/lower().

I just discovered, that there is missing a const when passing a buffer
to  PQescapeBytea and PQunescapeBytea. I fixed it and tried to create a
usable  diff (I'm not so familar to diff).

Tommi M?kitalo

Tweak CREATE SEQUENCE grammar to be more SQL1999 standards compliant.

Neil Conway

Add code to handle [ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP }]
for temp tables.

Gavin Sherry

Update discussion of floating-point problems in regression tests.

This patch removes a bunch of superfluous #include directives: if
postgres.h or c.h includes a system header (such as stdio.h or
stdlib.h), there's no need to specifically include it in any of the .c
files in the backend.

Neil Conway

Clean up format of SQL.

The attached patch defines functions for getting distances between
points on the surface of the earth and locating points within a
specified distance using an index based on the contrib/cube package. The
new functions are all of language type sql. A couple of bugs in the old
earthdistance function based on the point datatype are fixed. A
regression test has been added for both sets of functions. The README
file has been updated to include documentation on the new stuff. There
are comments about how this package is also useful for Astronomers.

Bruno Wolff III

Revise geometry regression testing to eliminate most cross-platform
variation.  To do this, set extra_float_digits to -3 in the geometry
test, and tweak the CIRCLE_TBL dataset to avoid values that suffer
from severe cancellation error (eg, circles that just touch an axis).
We still need two geometry 'expected' files to account for the
difference between platforms that display minus zero as '-0' and those
that just say '0', but with luck that's all we'll need.

Here is a patch that does just that, while maintaining the
"traditional" behavior, so the change should be transparent. Use the
command "\pset pager always" to turn it on. Anything else does the
normal toggle between "on" and "off"

Greg Sabino Mullane

Replace imprecise value of PI with a better one, and tweak circle_poly
in hopes of reducing platform-to-platform variations in its results.
This will cause the geometry regression test to start failing on some
platforms.  I plan to update the test later today.

Add name:

> * -Add GUC variables to control floating number output digits (Pedro Ferreira)

Mark as done:

> * -Add GUC variables to control floating number output digits

Add extra_float_digits GUC parameter to allow adjustment of displayed
precision for float4, float8, and geometric types.  Set it in pg_dump
so that float data can be dumped/reloaded exactly (at least on platforms
where the float I/O support is properly implemented).  Initial patch by
Pedro Ferreira, some additional work by Tom Lane.

The "Allow easy display of usernames in a group (pg_hba.conf uses groups
now)" item on the open items, and subsequent plpgsql function I sent in,
made me realize it was too hard to get the upper and lower bound of an
array. The attached creates two functions that I think will be very
useful when combined with the ability of plpgsql to return sets.

array_lower(array, dim_num)
- and -
array_upper(array, dim_num)

They return the value (as an int) of the upper and lower bound of the
requested dim in the provided array.

Joe Conway

Update FAQ_SCO from Larry Rosenman, correction from Tom Lane.

Update libpq PQcmdTuples() and PQcmdStatus() docs, remove const param
doc mention to match code and include files.

I'm using libpgtcl with PostgreSQL-7.2.3. There is a discrepancy between
the documentation and behavior of "pg_result $res -oid" when $res is not
from an INSERT.  The documentation says it should return an empty
string, but in fact it returns 0. I think it used to return an empty
string around PostgreSQL-7.1.3 when PQoidStatus() was used, but now it
uses PQoidValue() which returns InvalidOid, 0 in this case.

Assuming the current behavior is desired, here is a patch to the
documentation doc/src/sgml/libpgtcl.sgml to match what really happens:

ljb

Add:

> * Add GUC variables extra_float_digits and extra_double_digits to
>   control output digits
419a422
> * Research interaction of setitimer() and sleep() used by statement_timeout

Update release docs for 7.3.

Add #define _GNU_SOURCE to work around what seems to be Perl 5.8.0's
problem.  Per recent discussions about plperl failing to build on Linux.

Move substitute extern declarations to end of file, so that they are
not read until after we've read the port-specific header file.  In
particular this should make it safer to #include system headers for
inet_aton; in general it seems that the port header file ought to be
in a position to set definitions before we do stuff based on having
a definition or not.

Remove inappropriate inclusions of OpenSSL internal header e_os.h,
as well as unnecessary (and incorrect on Windows) assignments to
errno/SOCK_ERRNO.

Synced parser one more time.

Remove no-longer-needed inclusions to improve backward compatibility
with older bison versions.

Phase 2 of hashed-aggregation project.  nodeAgg.c now knows how to do
hashed aggregation, but there's not yet planner support for it.

Remove GPL file pursuant to relicensing.

Remove:

< * Move dbmirror and rserv from /contrib to gborg.postgresql.org

Change dbmirror lincense to BSD.

Not done:

> * Add hash for evaluating GROUP BY aggregates (Tom)

Completed:

> * -Add hash for evaluating GROUP BY aggregates (Tom)

Remove completed items:

< A dash (-) marks changes that will appear in the upcoming 7.3 release.
> A dash (-) marks changes that will appear in the upcoming 7.4 release.
38d37
< * -Change DEBUG startup tag to LOG (Bruce)
40,51d38
< * -Add pg_backend_pid() function to backend
< * -Allow logging of query durations
<
<
< Permissions
< ===========
<
< * -Improve control over user privileges, including table creation
< * -Allow user/group names to be specified directly in pg_hba.conf (Bruce)
< * -Add ~/.pgpass to store passwords with user/host/password combinations
< * -Allow permissions for functions (Peter E)
< * -Allow object creation to be disabled for specific users
58,60d44
< * -Make it easier to create a database owned by someone who can't createdb,
<   perhaps CREATE DATABASE dbname WITH OWNER = "user" (Gavin)
< * -Make equals sign optional in CREATE DATABASE WITH param = 'val'
65,66d48
< * -Prevent SIGHUP and 'pg_ctl reload' from changing command line
<   specified parameters to postgresql.conf defaults (Peter E)
69,70d50
< * -Reserve last few process slots for super-user if max_connections reached
< * -Add GUC parameter to print queries that generate errors
79d58
< * -Add domain capability (Rod Taylor)
82,84d60
< * -SELECT cash_out(2) crashes because of opaque
< * -Declare typein/out functions in pg_proc with a special "C string" data type
< * -Functions returning sets do not totally work
89d64
< * -Add GUC parameter for DATESTYLE
91,93d65
< * -Allow bytea to handle LIKE with non-TEXT patterns
< * -to_char(0,'FM999.99') returns a period, to_char(1,'FM999.99') doesn't (Karel)
< * -Add floor(float8) and other missing functions
97d68
<  o -Store binary-compatible type information in the system
104d74
<  o -Ensure we have array-eq operators for every built-in array type
139,140d108
< * -Remove brackets as multi-statement rule grouping, must use parens (Bruce)
< * -Prevent aggregates from being used in rule WHERE clauses
154d121
< * -Allow UPDATE/DELETE on inherited table
166d132
< * -Add deleted bit to index tuples to reduce heap access
176d141
< * -Test hash index performance and discourage usage
182d146
< * -Add SIMILAR TO to allow character classes, 'pg_[a-c]%'
184d147
< * -Remove LIMIT #,# and force use LIMIT and OFFSET clauses in 7.3 (Bruce)
186,187d148
< * -Disallow TRUNCATE on tables that are involved in referential constraints
< * -Add OR REPLACE clauses to non-FUNCTION object creation
190d150
< * -Prevent create/drop scripts from allowing extra args (Bruce)
201,205d160
<  o -Add ALTER TABLE DROP COLUMN feature
<  o -Add ALTER TABLE DROP non-CHECK CONSTRAINT
<  o -ALTER TABLE ADD PRIMARY KEY (Tom)
<  o -ALTER TABLE ADD UNIQUE (Tom)
<  o -ALTER TABLE ALTER COLUMN SET/DROP NOT NULL (Christopher)
210d164
<  o -Have ALTER TABLE OWNER change all dependant objects like indexes
214,216d167
<  o -Cluster all tables at once using pg_index.indisclustered set during
<           previous CLUSTER
<  o -Prevent loss of indexes, permissions, inheritance
221d171
<  o -Allow specification of column names
224d173
<  o -Change syntax to WITH DELIMITER, (keep old syntax around?)
228d176
<  o -Generate failure on short COPY lines rather than pad NULLs
242,243d189
<  o -Allow INSERT INTO my_table VALUES (a, b, c, DEFAULT, x, y, z, ...)
<  o -Disallow missing columns in INSERT ... (col) VALUES, per ANSI
248,249d193
<  o -Add command to display locks
<  o -Add SET or BEGIN timeout parameter to cancel query
251d194
<  o -Remove SET KSQO option now that OR processing is improved (Bruce)
254,256d196
<  o -Add SHOW command to see locale
<  o -Allow SHOW to output as a query result, like EXPLAIN
<  o -Abort all SET changes made in an aborted transaction
264d203
<  o -Fix PL/PgSQL to handle quoted mixed-case identifiers
287,291d225
< * -Have pg_dump use LEFT OUTER JOIN in multi-table SELECTs
<   or multiple SELECTS to avoid bad system catalog entries
< * -Have pg_dump -C dump database location and encoding information
< * -Allow psql \d to show foreign keys
< * -Allow psql \d to show temporary table structure (Tom)
294d227
< * -Have pg_dump use ADD PRIMARY KEY after COPY, for performance (Neil)
302d234
<  o -Updateable resultSet
307d238
<  o -Implement cancel() method on Statement
309d239
<         o -Add support for CallableStatements
311d240
<  o -Compile under jdk 1.4
334d262
< * -Allow oid to act as a foreign key
337,338d264
< * -Allow user to control trigger firing order (Tom)
< * -Add ALTER TRIGGER ... RENAME
341d266
< * -Fix foreign key constraints to not error on intermediate db states (Stephan)
350,359d274
< * -Add pg_depend table for dependency recording; use sysrelid, oid,
<   depend_sysrelid, depend_oid, name
< * -Auto-destroy sequence on DROP of table with SERIAL; perhaps a separate
<   SERIAL type
< * -Prevent column dropping if column is used by foreign key
< * -Propagate column or table renaming to foreign key constraints
< * -Automatically drop constraints/functions when object is dropped
< * -Make foreign key constraints clearer in dump file
< * -Make other constraints clearer in dump file
< * -Make foreign keys easier to identify
367d281
< * -Allow autocommit so always in a transaction block
377d290
< * -Add SQL92 schemas (Tom)
400d312
< * -Cache most recent query plan(s) (Neil) [prepare]
439d350
< * -Cache system catalog information in per-database files (Tom)
450,451d360
< * -Reorder postgresql.conf WAL items in order of importance (Bruce)
< * -Remove wal_files postgresql.conf option because WAL files are now recycled
465,466d373
< * -Improve dynamic memory allocation by introducing tuple-context memory
<   allocation (Tom)
468d374
< * -Nested FULL OUTER JOINs don't work (Tom)
470,472d375
< * -Add new pg_proc cachable settings to specify whether function can be
<   evaluated only once or once per query
< * -Change FIXED_CHAR_SEL to 0.20 from 0.04 to give better selectivity (Bruce)
494,496d396
< * -Add Intimate Shared Memory(ISM) for Solaris
< * -Use faster flex flags for performance improvement (Peter E)
< * -Add BSD-licensed qsort() for Solaris
503,507d402
< * -Fix problems with libpq non-blocking/async code
< * -Make sure all block numbers are unsigned to increase maximum table size
< * -Merge LockMethodCtl and LockMethodTable into one shared structure (Bruce)
< * -HOLDER/HOLDERTAB rename to PROCLOCK/PROCLOCKTAG (Bruce)
< * -Remove LockMethodTable.prio field, not used (Bruce)
512,513d406
< * -Make one version of simple_prompt() in code (Bruce, Tom)
< * -Compile in syslog functionaility by default (Tatsuo)
517d409
< * -Report failure to find readline or zlib at end of configure run
519,520d410
< * -Increase identifier length (NAMEDATALEN) if small performance hit,
< * -Increase maximum number of function parameters if little wasted space
529,530d418
< * -Fix glibc's mktime() to handle pre-1970's dates
< * -Move /contrib/retep to gborg.postgresql.org

None.

First phase of implementing hash-based grouping/aggregation.  An AGG plan
node now does its own grouping of the input rows, and has no need for a
preceding GROUP node in the plan pipeline.  This allows elimination of
the misnamed tuplePerGroup option for GROUP, and actually saves more code
in nodeGroup.c than it costs in nodeAgg.c, as well as being presumably
faster.  Restructure the API of query_planner so that we do not commit to
using a sorted or unsorted plan in query_planner; instead grouping_planner
makes the decision.  (Right now it isn't any smarter than query_planner
was, but that will change as soon as it has the option to select a hash-
based aggregation step.)  Despite all the hackery, no initdb needed since
only in-memory node types changed.

Add OS/X kernel tuning section.

Add:

> * Move dbmirror and rserv from /contrib to gborg.postgresql.org

Update FAQ_DEV.

Update FAQ_DEV.

Update ports list.

Update ports list.

Update ports list.

Update ports list.

Fix broken markup.

Update ports list.

Update ports list.

Brand CVS tip as 7.4devel.

Remove extraneous semicolons after routine bodies.  These don't bother
gcc, but some other compilers don't like 'em.

Fix inclusion order, per Andreas.

Remove unnecessary inclusion, per Andreas.

Remove no-longer-needed inclusion of bootstrap_tokens.h, per patch
from Andreas.

Applied two patches from Kris Jurka.
  - First fixes a problem with a recent patch allowing setNull on updateable
    resultsets
  - Second removed toLower() calls on database object names.  Leave it to
    the caller to correctly pass lower, upper or mixed case.  The driver
    already has methods that the caller can use to determine that postgres
    stores identifiers in lowercase. (unless the identifier was quoted when
    created).

 Modified Files:
  jdbc/org/postgresql/jdbc1/AbstractJdbc1DatabaseMetaData.java
  jdbc/org/postgresql/jdbc2/AbstractJdbc2ResultSet.java

Fix dblink regression test so that it works when repeated: don't
create a second database, just loop back to 'regression'.  Patch
from Joe Conway 10/22/02.

Update FAQ_DEV.

Stamp beta4.

This patch adds a couple of extra index entries and removes some
out-of-date text about multibyte encoding (which is now always
included).

Oliver Elphick

This patch adds information to the documentation on .pgpass and creates
additional index entries for it.

Oliver Elphick

Use sed rather than perl for reindexdb.

Fix some misstatements in WAL parameter discussion.

Code review for recent patch to allow ALTER TABLE ADD COLUMN when
a child table already has a matching column.  Acquire appropriate
lock on child table; do the right thing with any CHECK constraints
attached to the new parent column.

During swap_relfilenodes, swap relation size statistic fields along with
the relfilenode and toast fields.  This ensures that the newly-computed
statistics will be available on completion of CLUSTER.

Remove encoding lookups from grammar stage, push them back to places
where it's safe to do database access.  Along the way, fix core dump
for 'DEFAULT' parameters to CREATE DATABASE.  initdb forced due to
change in pg_proc entry.

Clean up a few fprintf(stderr)'s that should be elog's.

Add:

> * Acquire lock on a relation before building a relcache entry for it

Update:

>  o MOVE 0 should not move to end of cursor (Bruce)

Add:

> * Support statement-level triggers and triggers on columns (Neil)

Fix permissions-checking bugs and namespace-search-path bugs in
CONVERSION code.  Still need to figure out what to do about inappropriate
coding in parsing.

Add gcj discussion.

Re-add Win32 missing files, I think.

Re-add Win32 files.

Update port list.

Updates from Giles Lean.

Make it possible to run 'make installcheck' in contrib when building
outside the source tree.

Add:

> * Allow psql to do table completion for SELECT * FROM schema_part and
>   table completion for SELECT * FROM schema_name.

Fix contrib/rserv to install successfully when built outside source tree.
(Not that it will actually work with 7.3, I fear.)

Ooops, forgot to fix contrib regression tests for WARNING/NOTICE change.

Need -I. to build outside source tree.

Fix incorrect subdir value.

Add:

> * Have standalone backend read postgresql.conf

Arrange to compile flex output files as inclusions into other files
(usually bison output files), not as standalone files.  This hack
works around flex's insistence on including <stdio.h> before we are
able to include postgres.h; postgres.h will already be read before
the compiler starts to read the flex output file.  Needed for largefile
support on some platforms.

Ooops, forgot to fix contrib regression tests for WARNING/NOTICE change.

Reduce a couple of debugging messages from LOG to DEBUG1 category.

Reduce messages associated with shell-type function arguments/results
from WARNING to NOTICE, since they are expected messages in common cases.

Update to match expected results on OS X 10.2.

After elog(PANIC), exit with abort() not proc_exit().  This allows a
core file to be produced for debugging, and avoids trying to run the
normal proc-exit cleanup hooks, which are likely to cause additional
problems if the system is hosed.

Correct ordering of geometry/freebsd entries, add one for freebsd5.

Update for test changes.

Avoid malloc(0) when printing a table of no columns.  On some platforms
this returns NULL, which confuses the code.