Fix broken markup, improve wording.

Suppress useless searches for unused line pointers in PageAddItem.  To do
this, add a 16-bit "flags" field to page headers by stealing some bits from
pd_tli.  We use one flag bit as a hint to indicate whether there are any
unused line pointers; the remaining 15 are available for future use.

This is a cut-down form of an idea proposed by Hiroki Kataoka in July 2005.
At the time it was rejected because the original patch increased the size of
page headers and it wasn't clear that the benefit outweighed the distributed
cost.  The flag-bit approach gets most of the benefit without requiring an
increase in the page header size.

Heikki Linnakangas and Tom Lane

Fix miscalculation of stats collector's write delay, introduced in revision 1.117.

Fix markQueryForLocking() to work correctly in the presence of nested views.
It has been wrong for this case since it was first written for 7.1 :-(
Per report from Pavel Hanák.

Fix date/time formats for XML Schema output.

Pavel Stehule

Fix up several contrib modules that were using varlena datatypes in not-so-obvious
ways.  I'm not totally sure that I caught everything, but at least now they pass
their regression tests with VARSIZE/SET_VARSIZE defined to reverse byte order.

Add language about rights given by posting a patch:

    <li>PostgreSQL is licensed under a BSD license.  By posting a patch
    to the public PostgreSQL mailling lists, you are giving the PostgreSQL
    Global Development Group the non-revokable right to distribute your
    patch under the BSD license.  If you use code that is available under
    some other license that is BSD compatible (eg. public domain), please
    note that in your email submission.</li>

Remove temporary Windows-specific debugging code.

Replace direct assignments to VARATT_SIZEP(x) with SET_VARSIZE(x, len).
Get rid of VARATT_SIZE and VARATT_DATA, which were simply redundant with
VARSIZE and VARDATA, and as a consequence almost no code was using the
longer names.  Rename the length fields of struct varlena and various
derived structures to catch anyplace that was accessing them directly;
and clean up various places so caught.  In itself this patch doesn't
change any behavior at all, but it is necessary infrastructure if we hope
to play any games with the representation of varlena headers.
Greg Stark and Tom Lane

Update release timeline to use unnumber lists HTML.

Update DEV FAQ for CVS/SVN issue.

Robert Treat

Remove Kerberos mention in Solaris FAQ.

Allow information schema definitions to work without requiring implicit
casts to text.

Make build.bat return a proper errorcode if the build fails.

Get rid of the separate EState for subplans, and just let them share the
parent query's EState.  Now that there's a single flat rangetable for both
the main plan and subplans, there's no need anymore for a separate EState,
and removing it allows cleaning up some crufty code in nodeSubplan.c and
nodeSubqueryscan.c.  Should be a tad faster too, although any difference
will probably be hard to measure.  This is the last bit of subsidiary
mop-up work from changing to a flat rangetable.

Put back copyObject() call I removed in a fit of brain fade.  This one
is still needed despite cleanups in setrefs.c, because the point is to
let the inserted Result node compute a different tlist than its input
node does.  Per example from Jeremy Drake.

Update Solaris FAQ.

Now that plans have flat rangetable lists, it's a lot easier to get EXPLAIN to
drill down into subplan targetlists to print the referent expression for an
OUTER or INNER var in an upper plan node.  Hence, make it do that always, and
banish the old hack of showing "?columnN?" when things got too complicated.

Along the way, fix an EXPLAIN bug I introduced by suppressing subqueries from
execution-time range tables: get_name_for_var_field() assumed it could look at
rte->subquery to find out the real type of a RECORD var.  That doesn't work
anymore, but instead we can look at the input plan of the SubqueryScan plan
node.

Move BLCKSZ < 1024 check to guc.c.

Spelling fix.

Update Solaris FAQ wording, per Peter.

Update upgrade FAQ info.

Update Solaris FAQ.

Zdenek Kotala

Add psql \prompt capability.

Chad Wagner

Change Agg and Group nodes so that Vars contained in their targetlists
and quals have varno OUTER, rather than zero, to indicate a reference to
an output of their lefttree subplan.  This is consistent with the way
that every other upper-level node type does it, and allows some simplifications
in setrefs.c and EXPLAIN.

Fix bug I introduced in recent patch to make hash joins discard null tuples
immediately: ExecHashGetHashValue failed to restore the caller's memory
context before taking the failure exit.

Turn the rangetable used by the executor into a flat list, and avoid storing
useless substructure for its RangeTblEntry nodes.  (I chose to keep using the
same struct node type and just zero out the link fields for unneeded info,
rather than making a separate ExecRangeTblEntry type --- it seemed too
fragile to have two different rangetable representations.)

Along the way, put subplans into a list in the toplevel PlannedStmt node,
and have SubPlan nodes refer to them by list index instead of direct pointers.
Vadim wanted to do that years ago, but I never understood what he was on about
until now.  It makes things a *whole* lot more robust, because we can stop
worrying about duplicate processing of subplans during expression tree
traversals.  That's been a constant source of bugs, and it's finally gone.

There are some consequent simplifications yet to be made, like not using
a separate EState for subplans in the executor, but I'll tackle that later.

Remove extra tab.

Remove tabs from SGML reference files, so their addition can be detected
in the future.

Update upgrade wording.

Update new optional VACUUM FULL hint for translations, per Alvaro.

Move increase FSM warning to after lazy_truncate_heap() because the
function might reduce the number of free pages in the table.  Recommend
VACUUM FULL only if 20% free.

Simon Riggs.

btree source code cleanups:

I refactored findsplitloc and checksplitloc so that the division of
labor is more clear IMO. I pushed all the space calculation inside the
loop to checksplitloc.

I also fixed the off by 4 in free space calculation caused by
PageGetFreeSpace subtracting sizeof(ItemIdData), even though it was
harmless, because it was distracting and I felt it might come back to
bite us in the future if we change the page layout or alignments.
There's now a new function PageGetExactFreeSpace that doesn't do the
subtraction.

findsplitloc now tries the "just the new item to right page" split as
well. If people don't like the refactoring, I can write a patch to just
add that.

Heikki Linnakangas

Update FAQ about minor updates.

Update Japanese FAQ.

Jun Kuwamura

Update URL in German FAQ for bug form, per Schima, Fabian

Update Chinese FAQs to have two versions, a traditional Chinese version (Taiwan)
and a Simplified version (China (PRC)).

Backpatch to 8.2.X.

Daojing.Zhou

Fix typo, per Dave Page.

Update minor release text.

Add configure --enable-profiling to enable GCC profiling.  Patches from
Korry Douglas and Nikhil S

Update upgrade text.

Revert changes to process pg_proc.h entries without OIDs. We're not supposed
to have such entries, and want to be notified when we do...
Leave the plain bugfix in genbki.

Update URL for set-returning functions.

Allow pltcl args to spi_prepare and plpython args to plpy.prepare to be standard type aliases as well as those known in pg_type. Similar to recent change in plperl.

Add URL for:

      o Allow row and record variables to be set to NULL constants,
        and allow NULL tests on such variables

Prevent BLCKSZ < 1024, and have initdb test shared buffers based on the
BLCKSZ value.

Add:

>
> * Consider decreasing the amount of memory used by PrivateRefCount
>
>   http://archives.postgresql.org/pgsql-hackers/2006-11/msg00797.php
>   http://archives.postgresql.org/pgsql-hackers/2007-01/msg00752.php
>

Fix markup.

Change $(CC) to $(COMPILER) on Solaris gcc so -m64 is passed into the
shared link line.

Add:

> * Increase locking when DROPing objects so dependent objects cannot
>   get dropped while the DROP operation is happening
>
>   http://archives.postgresql.org/pgsql-hackers/2007-01/msg00937.php

Add URL for:

        o Allow UPDATE/DELETE WHERE CURRENT OF cursor
>    http://archives.postgresql.org/pgsql-hackers/2007-01/msg01014.php

Add:

>
> * Add missing operators for geometric data types
>
>   Some geometric types do not have the full suite of geometric operators,
>   e.g. box @> point
>

Update "encode" documentation to mention that 'escape' only changes null
bytes and backslashes, remove "ASCII" mention.  Backpatch to 8.2.X.

Update pgpass Win32 wording.

Update information_schema documentation to match system tables.
Backpatch to 8.2.X.

Wording improvement.

More clearly document that most PostgreSQL utilities support libpq
environment variables.  Backpatch to 8.2.X.

Adjust user-facing documentation to explain why we don't check pgpass
file permissions on Windows.

Remove the Query structure from the executor's API.  This allows us to stop
storing mostly-redundant Query trees in prepared statements, portals, etc.
To replace Query, a new node type called PlannedStmt is inserted by the
planner at the top of a completed plan tree; this carries just the fields of
Query that are still needed at runtime.  The statement lists kept in portals
etc. now consist of intermixed PlannedStmt and bare utility-statement nodes
--- no Query.  This incidentally allows us to remove some fields from Query
and Plan nodes that shouldn't have been there in the first place.

Still to do: simplify the execution-time range table; at the moment the
range table passed to the executor still contains Query trees for subqueries.

initdb forced due to change of stored rules.

Remove, item not needed for Win32:

<  o Check .pgpass file permissions
>

Add comment that on Win32, we don't need to check the .pgpass file
permission, per Magnus.

Remove "History" sections for pg_dump and pg_restore.  I don't think
anyone cares because the last history change was for PostgreSQL 7.1.

Spell check on array patch.

Add for WIN32:

<
>  o Check .pgpass file permissions

Update array slice documentation to be clearer.

Add:

> * Fix IS OF so it matches the ISO specification, and add documentation
>
>   http://archives.postgresql.org/pgsql-patches/2003-08/msg00060.php
>   http://archives.postgresql.org/pgsql-hackers/2007-02/msg00060.php

Comment-out documentation for IS OF because it doesn't conform to the
ISO SQL behavior. Backpatch removal to 8.2.X.

Identify schema of inherited table in psql \d when necessary.

by Bernd Helmle

Add missing OIDs to pg_proc.

Remove item:

<  o ARRAY[[1,2],[3,4]])[1] should return the same values as
<    ARRAY[[1,2],[3,4]])[1:1];
<

Document IS [NOT] OF, which was added in 7.3.

Add FAQ text about Makefile.custom:

    <P><I>src/Makefile.custom</I> can be used to set environment variables,
    like <I>CUSTOM_COPT</I>, that are used for every compile.

Document that to_char('J'/Julian) is midnight-based, per report that
Julian technically is noon to noon.

Wording improvement.

Update PQfree() documentation to be clearer, backpatch to 8.2.X.

Update wording:

< * Consider allowing configuration of TOAST thresholds
> * Allow user configuration of TOAST thresholds

Add:

> * Consider allowing configuration of TOAST thresholds
>
>   http://archives.postgresql.org/pgsql-hackers/2007-02/msg00213.php
>

Add newlines.

Add:

> * Allow UPDATEs on only non-referential integrity columns not to conflict
>   with referential integrity locks
>
>   http://archives.postgresql.org/pgsql-hackers/2007-02/msg00073.php

Add:

> * Allow INSERT/UPDATE ... RETURNING inside a SELECT 'FROM' clause
>
>   http://archives.postgresql.org/pgsql-general/2006-09/msg00803.php
>   http://archives.postgresql.org/pgsql-hackers/2006-10/msg00693.php
>

Clarify documentation that initdb -A or editing pg_hba.conf is required
if you do not trust local users.

Clarify documentation for "day of the week" handling for to_char() and
EXTRACT().

Done:

> * -Add ISO day of week format 'ID' to to_char() where Monday = 1

Add "isodow" option to EXTRACT() and date_part() where Sunday = 7.

Done:

> * -Add a field 'isoyear' to extract(), based on the ISO week

Done:

<  o Add long file support for binary pg_dump output
<
<    While Win32 supports 64-bit files, the MinGW API does not,
<    meaning we have to build an fseeko replacement on top of the
<    Win32 API, and we have to make sure MinGW handles it.  Another
<    option is to wait for the MinGW project to fix it, or use the
<    code from the LibGW32C project as a guide.
<
<    http://archives.postgresql.org/pgsql-hackers/2006-12/msg00551.php
<
>  o -Add long file support for binary pg_dump output

Fix pg_dump on win32 to properly dump files larger than 2Gb when using
binary dump formats.

Parse pg_proc.h with entries without OIDs.

Get rid of some old and crufty global variables in the planner.  When
this code was last gone over, there wasn't really any alternative to
globals because we didn't have the PlannerInfo struct being passed all
through the planner code.  Now that we do, we can restructure things
to avoid non-reentrancy.  I'm fooling with this because otherwise I'd
have had to add another global variable for the planned compact
range table list.

Improve plpgsql's error message when a datatype declaration is omitted.
Per example from Jeff Ross.

Put function expressions and values lists into FunctionScan and ValuesScan
plan nodes, so that the executor does not need to get these items from
the range table at runtime.  This will avoid needing to include these
fields in the compact range table I'm expecting to make the executor use.

Fix portal management code to support non-default command completion tags for
portals using PORTAL_UTIL_SELECT strategy.  This is currently significant only
for FETCH queries, which are supposed to include a count in the tag.  Seems
it's been broken since 7.4, but nobody noticed before Knut Lehre.

Document limitation of SPI_execute() using multiple queries in a single
string.

Update wording:

<   Currently, ALTER USER and ALTER DATABASE support per-user and
>   Currently ALTER USER and ALTER DATABASE support per-user and
<    Currently, subtracting one date from another that crosses a
>    Currently subtracting one date from another that crosses a
<   Currently, SQL-language functions can only refer to parameters via $1, etc
>   Currently SQL-language functions can only refer to dollar parameters,
>   e.g. $1
<   Currently, queries prepared via the libpq API are planned on first
>   Currently queries prepared via the libpq API are planned on first
<    Currently, SET <tab> causes a database lookup to check all
>    Currently SET <tab> causes a database lookup to check all
<    Currently, all statement results are transferred to the libpq
>    Currently all statement results are transferred to the libpq

Add:

* Allow SQL-language functions to reference parameters by parameter name

  Currently SQL-language functions can only refer to parameters via $1, etc

Update "Conflicting lock modes" to show as conflict, add
current/requested headings, add link to table from text.

Add code so that when COPY_PARSE_PLAN_TREES is defined, the copy and
equal functions are checked for raw parse trees as well as post-analysis
trees.  This was never very important before, but the upcoming plan cache
control module will need to be able to do copyObject() on raw parse trees.

Remove rint() for to_char MS and US output.  We can't us rint() because
we can't overflow to the next higher units, and we might print the lower
units for MS.

Add:

> * Allow holdable cursors in SPI

Cleanup of to_char() patch.

Brendan Jurd