11<!--
2- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.367 2005/09/12 05:10:12 neilc Exp $
2+ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.368 2005/09/16 03:37:35 tgl Exp $
33
44Typical markup:
55
@@ -20,7 +20,7 @@ pg_[A-Za-z0-9_] <application>
2020
2121 <note>
2222 <title>Release date</title>
23- <simpara>2005-1?-??, Current as of 2005-08-24 </simpara>
23+ <simpara>2005-1?-??, Current as of 2005-09-15 </simpara>
2424 </note>
2525
2626 <sect2>
@@ -348,10 +348,10 @@ pg_[A-Za-z0-9_] <application>
348348 database (Tom)
349349 </para>
350350 <para>
351- The old behavior of <command>REINDEX</> database reindexed only
351+ Formerly, <command>REINDEX DATABASE </> reindexed only
352352 system tables. This new behavior seems more intuitive. A new
353- command <command>REINDEX SYSTEM</>allows for reindexing just the
354- system tables.
353+ command <command>REINDEX SYSTEM</>provides the old functionality
354+ of reindexing just the system tables.
355355 </para>
356356 </listitem>
357357
@@ -386,6 +386,28 @@ pg_[A-Za-z0-9_] <application>
386386 </para>
387387 </listitem>
388388
389+ <listitem>
390+ <para>
391+ <command>CREATE LANGUAGE</> may ignore the provided arguments
392+ in favor of information from <structname>pg_pltemplate</>
393+ (Tom)
394+ </para>
395+ <para>
396+ A new system catalog <structname>pg_pltemplate</> has been defined
397+ to carry information about the preferred definitions of procedural
398+ languages (such as whether they have validator functions). When
399+ an entry exists in this catalog for the language being created,
400+ <command>CREATE LANGUAGE</> will ignore all its parameters except the
401+ language name and instead use the catalog information. This measure
402+ was taken because of increasing problems with obsolete language
403+ definitions being loaded by old dump files. As of 8.1,
404+ <application>pg_dump</> will dump procedural language definitions as
405+ just <command>CREATE LANGUAGE <replaceable>name</></command>, relying
406+ on a template entry to exist at load time. We expect this will be a
407+ more future-proof representation.
408+ </para>
409+ </listitem>
410+
389411 </itemizedlist>
390412 </sect2>
391413
@@ -668,6 +690,13 @@ pg_[A-Za-z0-9_] <application>
668690 </para>
669691 </listitem>
670692
693+ <listitem>
694+ <para>
695+ New system catalog <structname>pg_pltemplate</> allows overriding
696+ obsolete procedural-language definitions in dump files (Tom)
697+ </para>
698+ </listitem>
699+
671700 </itemizedlist>
672701 </sect3>
673702
@@ -1610,6 +1639,17 @@ pg_[A-Za-z0-9_] <application>
16101639 </para>
16111640 </listitem>
16121641
1642+ <listitem>
1643+ <para>
1644+ Make startup banner show both server version number and
1645+ <application>psql</>'s version number, when they are different (Bruce)
1646+ </para>
1647+ <para>
1648+ Also, a warning will be shown if the server and <application>psql</>
1649+ are from different major releases.
1650+ </para>
1651+ </listitem>
1652+
16131653 </itemizedlist>
16141654 </sect3>
16151655
@@ -1660,6 +1700,20 @@ pg_[A-Za-z0-9_] <application>
16601700 </para>
16611701 </listitem>
16621702
1703+ <listitem>
1704+ <para>
1705+ Rely on <structname>pg_pltemplate</> for procedural languages (Tom)
1706+ </para>
1707+ <para>
1708+ If the call handler for a procedural language is in the
1709+ <literal>pg_catalog</> schema, <application>pg_dump</> does not
1710+ dump the handler. Instead, it dumps the language using just
1711+ <command>CREATE LANGUAGE <replaceable>name</></command>,
1712+ relying on the <structname>pg_pltemplate</> catalog to provide
1713+ the language's creation parameters at load time.
1714+ </para>
1715+ </listitem>
1716+
16631717 </itemizedlist>
16641718 </sect3>
16651719