mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Some desultory markup improvements in the new release notes.

Browse Source
This commit is contained in:
Tom Lane 2007-10-04 22:55:49 +00:00
parent 8dfca24b6b
commit 3c2d497f8d
1 changed files with 109 additions and 74 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

183
doc/src/sgml/release.sgml
View File

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.513 2007/10/04 07:53:07 neilc Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.514 2007/10/04 22:55:49 tgl Exp $ -->
<!-- <!--
Typical markup: Typical markup:
@ -86,13 +86,15 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
ORDER BY ... NULLS FIRST/LAST <literal>ORDER BY ... NULLS FIRST/LAST</>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Updatable cursors Updatable cursors
(<literal>UPDATE/DELETE WHERE CURRENT OF</>
<replaceable>cursor_name</>)
</para> </para>
</listitem> </listitem>
@ -189,7 +191,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
"Distributed" checkpoints to spread out the I/O load of a checkpoint <quote>Distributed</> checkpoints to spread out the I/O load of a
checkpoint
</para> </para>
</listitem> </listitem>
@ -331,7 +334,7 @@ do it for earlier branch release files.
<para> <para>
<literal>ORDER BY ... USING</> <replaceable>operator</> <literal>ORDER BY ... USING</> <replaceable>operator</>
will now be rejected if the <replaceable>operator</> is not a will now be rejected if the <replaceable>operator</> is not a
less-than or greater-than member of some btree opclass less-than or greater-than member of some btree operator class
</para> </para>
<para> <para>
@ -372,7 +375,7 @@ do it for earlier branch release files.
</para> </para>
<para> <para>
In 8.0 through 8.2, SET LOCAL's In 8.0 through 8.2, <command>SET LOCAL</command>'s
effects disappeared at subtransaction commit, leading to behavior effects disappeared at subtransaction commit, leading to behavior
that made little sense at the SQL level (one would not normally that made little sense at the SQL level (one would not normally
expect <command>RELEASE</> to do such a thing). expect <command>RELEASE</> to do such a thing).
@ -386,9 +389,9 @@ do it for earlier branch release files.
</para> </para>
<para> <para>
For example, "BEGIN; DROP DATABASE; COMMIT" will now be rejected For example, <literal>BEGIN; DROP DATABASE; COMMIT</> will now be
even if submitted as a single Query message. This was always quite rejected even if submitted as a single Query message. This was always
unsafe, but the <function>PreventTransactionChain</function> quite unsafe, but the <function>PreventTransactionChain</function>
test failed to detect it. test failed to detect it.
</para> </para>
</listitem> </listitem>
@ -412,7 +415,7 @@ do it for earlier branch release files.
<para> <para>
Strings that are not in the database's native encoding are now Strings that are not in the database's native encoding are now
represented as type bytea rather than type text. represented as type <type>bytea</> rather than type <type>text</>.
</para> </para>
</listitem> </listitem>
@ -469,8 +472,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Implement "distributed" checkpoints (Itagaki Takahiro and Heikki Implement <quote>distributed</> checkpoints (Itagaki Takahiro and
Linnakangas) Heikki Linnakangas)
</para> </para>
<para> <para>
@ -489,11 +492,11 @@ do it for earlier branch release files.
<para> <para>
When we update a tuple without changing any of its indexed columns, When we update a tuple without changing any of its indexed columns,
and the new version can be stored on the same heap page, we no and the new version can be stored on the same heap page, we no longer
longer generate extra index entries for the new version. Instead, generate extra index entries for the new version. Instead, index
index searches follow the HOT-chain links to ensure they find the searches follow the HOT-chain links to ensure they find the correct
correct tuple version. In addition, this patch introduces the tuple version. In addition, this patch introduces the ability to
ability to "prune" dead tuples on a per-page basis, without having <quote>prune</quote> dead tuples on a per-page basis, without having
to do a complete <command>VACUUM</command> pass to recover space. to do a complete <command>VACUUM</command> pass to recover space.
<command>VACUUM</command> is still needed to clean up dead index <command>VACUUM</command> is still needed to clean up dead index
entries, however. entries, however.
@ -556,7 +559,7 @@ do it for earlier branch release files.
read-only transactions, this should improve performance noticeably; read-only transactions, this should improve performance noticeably;
not so much from removal of the actual XID-assignments, as from not so much from removal of the actual XID-assignments, as from
reduction of overhead that's driven by the rate of XID consumption. reduction of overhead that's driven by the rate of XID consumption.
We add a concept of a "virtual transaction ID" so that active We add a concept of a <quote>virtual transaction ID</> so that active
transactions can be uniquely identified even if they don't have a transactions can be uniquely identified even if they don't have a
regular XID. This is a much lighter-weight concept: uniqueness of regular XID. This is a much lighter-weight concept: uniqueness of
VXIDs is only guaranteed over the short term, and no on-disk record VXIDs is only guaranteed over the short term, and no on-disk record
@ -585,8 +588,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Create a dedicated "wal writer" process to offload WAL-writing work Create a dedicated <quote>wal writer</quote> process to offload
from backends (Simon) WAL-writing work from backends (Simon)
</para> </para>
<para> <para>
@ -657,9 +660,9 @@ do it for earlier branch release files.
Large sequential scans now synchronize with each other, so that when Large sequential scans now synchronize with each other, so that when
multiple backends are scanning the same relation concurrently, each multiple backends are scanning the same relation concurrently, each
page is (ideally) read only once. Note that a backend joining such page is (ideally) read only once. Note that a backend joining such
a scan starts in the middle of the relation and "wraps around" to a scan starts in the middle of the relation and <quote>wraps
cover all blocks; this may affect the order in which rows are around</quote> to cover all blocks; this may affect the order in which
returned. rows are returned.
</para> </para>
</listitem> </listitem>
@ -711,8 +714,8 @@ do it for earlier branch release files.
<para> <para>
This change uses a Materialize node between the mergejoin and the This change uses a Materialize node between the mergejoin and the
sort to prevent the sort from having to "back up", which allows a sort to prevent the sort from having to <quote>back up</>, which
more efficient sort. The Materialize node keeps a circular allows a more efficient sort. The Materialize node keeps a circular
buffer of only the prior tuples that the mergejoin may actually buffer of only the prior tuples that the mergejoin may actually
need again, so it usually won't need to spill to disk, resulting need again, so it usually won't need to spill to disk, resulting
in net I/O savings. in net I/O savings.
@ -815,7 +818,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Add ssl_ciphers parameter to control allowed ciphers (Victor Wagner) Add <varname>ssl_ciphers</> parameter to control allowed ciphers
(Victor Wagner)
</para> </para>
</listitem> </listitem>
@ -890,8 +894,8 @@ do it for earlier branch release files.
This avoids Windows-specific problems with localized time zone names This avoids Windows-specific problems with localized time zone names
that are in the wrong encoding. There is a new that are in the wrong encoding. There is a new
<varname>log_timezone</> parameter that controls the timezone used <varname>log_timezone</> parameter that controls the timezone used
in log messages, separately from the client-visible timezone in log messages, separately from the client-visible
parameter. <varname>timezone</> parameter.
</para> </para>
</listitem> </listitem>
@ -1019,8 +1023,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Merge <varname>stats_block_level</> and <varname>stats_row_level</> Merge <varname>stats_block_level</> and <varname>stats_row_level</>
parameters into a single parameter track_counts, which controls all parameters into a single parameter <varname>track_counts</>,
reports sent to the collector process (Tom) which controls all reports sent to the collector process (Tom)
</para> </para>
</listitem> </listitem>
@ -1050,7 +1054,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Arrange to put TOAST tables belonging to temporary tables into Arrange to put TOAST tables belonging to temporary tables into
special schemas named pg_toast_temp_nnn (Tom) special schemas named
<literal>pg_toast_temp_<replaceable>nnn</></literal> (Tom)
</para> </para>
<para> <para>
@ -1122,7 +1127,9 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Support UPDATE/DELETE WHERE CURRENT OF cursor_name (Arul Shaji, Tom) Support <literal>UPDATE/DELETE WHERE CURRENT OF</>
<replaceable>cursor_name</>
(Arul Shaji, Tom)
</para> </para>
</listitem> </listitem>
@ -1355,7 +1362,7 @@ do it for earlier branch release files.
<para> <para>
There is now a sound semantic basis for the equality checks applied There is now a sound semantic basis for the equality checks applied
by foreign-key constraints; formerly the system tended to assume by foreign-key constraints; formerly the system tended to assume
that any operator named "=" was the right thing. The equality that any operator named <literal>=</> was the right thing. The equality
operators will now be selected from the opfamily of the unique index operators will now be selected from the opfamily of the unique index
that the FK constraint depends on to enforce uniqueness of the that the FK constraint depends on to enforce uniqueness of the
referenced columns; therefore they are certain to be consistent with referenced columns; therefore they are certain to be consistent with
@ -1363,8 +1370,8 @@ do it for earlier branch release files.
the problem noted awhile back that pg_dump may fail for foreign-key the problem noted awhile back that pg_dump may fail for foreign-key
constraints on user-defined types when the required operators aren't constraints on user-defined types when the required operators aren't
in the search path. This also means that the former warning in the search path. This also means that the former warning
condition about "foreign key constraint will require costly condition about <quote>foreign key constraint will require costly
sequential scans" is gone: if the comparison condition isn't sequential scans</quote> is gone: if the comparison condition isn't
indexable then we'll reject the constraint entirely. indexable then we'll reject the constraint entirely.
</para> </para>
</listitem> </listitem>
@ -1385,34 +1392,35 @@ do it for earlier branch release files.
<para> <para>
A database owner is now allowed to create a language in his database A database owner is now allowed to create a language in his database
if it's marked "tmpldbacreate" in pg_pltemplate. The factory if it's marked <structfield>tmpldbacreate</> in
default is that this is set for all standard trusted languages, but <structname>pg_pltemplate</>. The factory default is that this is set
of course a superuser may adjust the settings. In service of this, for all standard trusted languages, but of course a superuser may
add the long-foreseen owner column to pg_language; renaming, adjust the settings. In service of this, add the long-foreseen owner
dropping, and altering owner of a PL now follow normal ownership column to <structname>pg_language</>; renaming, dropping, and altering
rules instead of being superuser-only. owner of a PL now follow normal ownership rules instead of being
superuser-only.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Arrange for SET LOCAL's effects to persist until the end of the Arrange for <command>SET LOCAL</command>'s effects to persist until
current top transaction, unless rolled back or overridden by a SET the end of the current top transaction, unless rolled back or
clause for the same variable attached to a surrounding function call overridden by a SET clause for the same variable attached to a
(Tom) surrounding function call (Tom)
</para> </para>
<para> <para>
This is an incompatible change: in 8.0 through 8.2, SET LOCAL's This is an incompatible change: in 8.0 through 8.2, <command>SET
effects disappeared at subtransaction commit (leading to behavior LOCAL</command>'s effects disappeared at subtransaction commit
that made little sense at the SQL level). (leading to behavior that made little sense at the SQL level).
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Support <literal>SET FROM CURRENT</literal> in <command>CREATE/ALTER Support <literal>SET ... FROM CURRENT</literal> in
FUNCTION</command>, <command>ALTER DATABASE</command>, <command>CREATE/ALTER FUNCTION</command>, <command>ALTER DATABASE</command>,
<command>ALTER ROLE</command> (Tom) <command>ALTER ROLE</command> (Tom)
</para> </para>
@ -1474,7 +1482,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Support new syntax for <command>CLUSTER</command>: <literal>CLUSTER Support new syntax for <command>CLUSTER</command>: <literal>CLUSTER
<replaceable>table</> USING <replaceable>index</></literal> (Holger Schurig) <replaceable>table</> USING <replaceable>index</></literal>
(Holger Schurig)
</para> </para>
<para> <para>
@ -1516,7 +1525,8 @@ do it for earlier branch release files.
</para> </para>
<para> <para>
This fix banishes the old hack of showing <quote>?columnN?</quote> This fix banishes the old hack of showing
<literal>?column<replaceable>N</>?</literal>
when things got too complicated. when things got too complicated.
</para> </para>
</listitem> </listitem>
@ -1528,10 +1538,10 @@ do it for earlier branch release files.
</para> </para>
<para> <para>
For example, "BEGIN; DROP DATABASE; COMMIT" will now be rejected For example, <literal>BEGIN; DROP DATABASE; COMMIT</> will now be
even if submitted as a single Query message. This is a potential rejected even if submitted as a single Query message. This is a
incompatibility since some clients expected such strings to work; potential incompatibility since some clients expected such strings to
but it was always unsafe. work; but it was always unsafe.
</para> </para>
</listitem> </listitem>
@ -1555,8 +1565,8 @@ do it for earlier branch release files.
</para> </para>
<para> <para>
Formerly, these commands accepted "schema.relation" but then ignored Formerly, these commands accepted <quote>schema.relation</> but then
the schema part, leading to confusion. ignored the schema part, leading to confusion.
</para> </para>
</listitem> </listitem>
@ -1642,7 +1652,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Add "isodow" option to EXTRACT() and date_part() (Bruce) Add <literal>isodow</> option to <function>EXTRACT()</> and
<function>date_part()</> (Bruce)
</para> </para>
<para> <para>
@ -1667,7 +1678,7 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Make <function>to_timestamp()</> and <function>to_date()</> assume Make <function>to_timestamp()</> and <function>to_date()</> assume
"TM" for potentially variable-width fields (Bruce) <quote>TM</quote> for potentially variable-width fields (Bruce)
</para> </para>
<para> <para>
@ -1770,13 +1781,34 @@ do it for earlier branch release files.
The two argument form of <function>convert()</function> is gone, and The two argument form of <function>convert()</function> is gone, and
the three argument form now takes a <type>bytea</type> first the three argument form now takes a <type>bytea</type> first
argument and returns a <type>bytea</type>. To cover this loss three argument and returns a <type>bytea</type>. To cover this loss three
new functions are introduced: . convert_from(bytea, name) returns new functions are introduced:
text - converts the first argument from the named encoding to the
database encoding . convert_to(text, name) returns bytea - converts
the first argument from the database encoding to the named encoding
. length(bytea, name) returns int - gives the length of the first
argument in characters in the named encoding.
</para> </para>
<itemizedlist>
<listitem>
<para>
<function>convert_from(bytea, name)</function> returning
<type>text</> &mdash; converts the first argument from the named
encoding to the database encoding.
</para>
</listitem>
<listitem>
<para>
<function>convert_to(text, name)</function> returning <type>bytea</>
&mdash; converts the first argument from the database encoding to
the named encoding.
</para>
</listitem>
<listitem>
<para>
<function>length(bytea, name)</function> returning <type>int</>
&mdash; gives the length of the first argument in characters in the
named encoding.
</para>
</listitem>
</itemizedlist>
</listitem> </listitem>
<listitem> <listitem>
@ -1827,7 +1859,7 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Support scrollable cursors (ie, add a "direction" clause in Support scrollable cursors (ie, add a direction clause in
<command>FETCH</command>) in PL/PgSQL (Pavel Stehule) <command>FETCH</command>) in PL/PgSQL (Pavel Stehule)
</para> </para>
</listitem> </listitem>
@ -1964,20 +1996,22 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
List disabled triggers separately in "\d" output List disabled triggers separately in <literal>\d</literal> output
(Brendan Jurd) (Brendan Jurd)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Identify schema of inherited table in "\d" output (Bernd Helmle) Identify schema of inherited table in <literal>\d</literal> output
(Bernd Helmle)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Show aggregate return types in "\da" output (Greg Sabino Mullane) Show aggregate return types in <literal>\da</literal> output
(Greg Sabino Mullane)
</para> </para>
</listitem> </listitem>
@ -2043,7 +2077,8 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Flush the \o file, if any, after each backslash command (Tom) Flush the <literal>\o</> file, if any, after each backslash command
(Tom)
</para> </para>
</listitem> </listitem>
@ -2077,7 +2112,7 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Allow pg_dumpall to accept an initial-connection database name Allow pg_dumpall to accept an initial-connection database name
rather than the default "template1" (Dave Page) rather than the default <literal>template1</literal> (Dave Page)
</para> </para>
</listitem> </listitem>
@ -2333,7 +2368,7 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Clean up SPI's API a little bit by declaring SPI plan pointers as Clean up SPI's API a little bit by declaring SPI plan pointers as
"SPIPlanPtr" instead of "void *" (Tom) <literal>SPIPlanPtr</> instead of <literal>void *</> (Tom)
</para> </para>
<para> <para>
@ -2370,7 +2405,7 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Support "gmake draft" in doc/src/sgml/Makefile (Bruce) Support <literal>gmake draft</literal> in doc/src/sgml/Makefile (Bruce)
</para> </para>
</listitem> </listitem>
@ -2549,7 +2584,7 @@ do it for earlier branch release files.
<listitem> <listitem>
<para> <para>
Create a function variable "join_search_hook" to let plugins Create a function variable <literal>join_search_hook</> to let plugins
override the join search order portion of the planner (Julius override the join search order portion of the planner (Julius
Stroffek) Stroffek)
</para> </para>