Stamp

doc/src/sgml/release.sgml

@@ -1,10 +1,86 @@
+<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.163.2.44 2007/09/11 17:19:07 momjian Exp $ -->
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.163.2.43 2007/04/20 03:28:17 tgl Exp $
+
+Typical markup:
+
+&<>                             use & escapes
+[A-Z][A-Z ]+[A-Z]               <command>
+[A-Za-z_][A-Za-z0-9_]+()        <function>
+[A-Za-z_]/[A-Za-z_]+            <filename>
+PostgreSQL                      <productname>
+pg_[A-Za-z0-9_]                 <application>
+[A-Z][A-Z]                      <type>, <envar>, <literal>
+
+non-ASCII characters            convert to HTML4 entity (&) escapes
+
+        official:      http://www.w3.org/TR/html4/sgml/entities.html
+        one page:      http://www.zipcon.net/~swhite/docs/computers/browsers/entities_page.html
+        other lists:   http://www.zipcon.net/~swhite/docs/computers/browsers/entities.html
+                       http://www.zipcon.net/~swhite/docs/computers/browsers/entities_page.html
+                       http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
+
+        we cannot use UTF8 because SGML Docbook
+        does not support it
+          http://www.pemberley.com/janeinfo/latin1.html#latexta
+
+wrap long lines
+
+For new features, add links to the documentation sections.  Use </link>
+so that perl can remove it so HISTORY.html can be created with no
+links to the main documentation.  This was added only in 8.2, so don't
+do it for earlier branch release files.
+
 -->
 
 <appendix id="release">
  <title>Release Notes</title>
 
+  <sect1 id="release-7-3-20">
+   <title>Release 7.3.20</title>
+
+   <note>
+   <title>Release date</title>
+   <simpara>2007-09-17</simpara>
+   </note>
+
+   <para>
+    This release contains fixes from 7.3.19.
+   </para>
+
+   <sect2>
+    <title>Migration to version 7.3.20</title>
+
+    <para>
+     A dump/restore is not required for those running 7.3.X.  However,
+     if you are upgrading from a version earlier than 7.3.13, see the release
+     notes for 7.3.13.
+    </para>
+
+   </sect2>
+
+   <sect2>
+    <title>Changes</title>
+
+    <itemizedlist>
+
+     <listitem>
+      <para>
+       Allow <command>CREATE DOMAIN ... DEFAULT NULL</> (Tom)
+      </para>
+     </listitem>
+
+     <listitem>
+      <para>
+       Require non-superusers who use <filename>/contrib/dblink</> to use only password
+       authentication, as a security measure (Joe)
+      </para>
+     </listitem>
+
+    </itemizedlist>
+
+   </sect2>
+  </sect1>
+
   <sect1 id="release-7-3-19">
    <title>Release 7.3.19</title>
 
@@ -155,11 +231,13 @@ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.163.2.43 2007/04/20 03:28:
       <para>
        <function>to_number()</> and <function>to_char(numeric)</>
        are now <literal>STABLE</>, not <literal>IMMUTABLE</>, for
-       new <application>initdb</> installs (Tom)
+       new <link linkend="APP-INITDB"><application>initdb</></link>
+       installs (Tom)
       </para>
 
       <para>
-       This is because <literal>lc_numeric</> can potentially
+       This is because <link
+       linkend="guc-lc-numeric"><varname>lc_numeric</></link> can potentially
        change the output of these functions.
       </para>
      </listitem>
@@ -245,7 +323,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.163.2.43 2007/04/20 03:28:
 
     <para>
      Full security against the SQL-injection attacks described in
-     CVE-2006-2313 and CVE-2006-2314 may require changes in application
+     CVE-2006-2313 and CVE-2006-2314 might require changes in application
      code.  If you have applications that embed untrustworthy strings
      into SQL commands, you should examine them as soon as possible to
      ensure that they are using recommended escaping techniques.  In
@@ -277,7 +355,7 @@ literals.  By default, <literal>\'</> is rejected only when
 GB18030, or UHC), which is the scenario in which SQL injection is possible.
 A new configuration parameter <varname>backslash_quote</> is available to
 adjust this behavior when needed.  Note that full security against
-CVE-2006-2314 may require client-side changes; the purpose of
+CVE-2006-2314 might require client-side changes; the purpose of
 <varname>backslash_quote</> is in part to make it obvious that insecure
 clients are insecure.
 </para></listitem>
@@ -410,7 +488,7 @@ to ensure that <application>plperl</> won't change the locale later</para>
 <para>This fixes a problem that occurred if the <application>postmaster</> was
 started with environment variables specifying a different locale than what
 <application>initdb</> had been told.  Under these conditions, any use of
-<application>plperl</> was likely to lead to corrupt indexes.  You may need
+<application>plperl</> was likely to lead to corrupt indexes.  You might need
 <command>REINDEX</> to fix existing indexes on
 textual columns if this has happened to you.</para></listitem>
 
@@ -565,7 +643,7 @@ the variable is of pass-by-reference type</para></listitem>
      It is strongly recommended that all installations repair this error,
      either by initdb or by following the manual repair procedure given
      below.  The error at least allows unprivileged database users to crash
-     their server process, and may allow unprivileged users to gain the
+     their server process, and might allow unprivileged users to gain the
      privileges of a database superuser.
     </para>
 
@@ -591,12 +669,12 @@ COMMIT;
      template databases then any subsequently created databases will contain
      the same error.  <literal>template1</> can be fixed in the same way
      as any other database, but fixing <literal>template0</> requires
-     additional steps.  First, from any database issue
+     additional steps.  First, from any database issue:
 <programlisting>
 UPDATE pg_database SET datallowconn = true WHERE datname = 'template0';
 </programlisting>
       Next connect to <literal>template0</> and perform the above repair
-      procedure.  Finally, do
+      procedure.  Finally, do:
 <programlisting>
 -- re-freeze template0:
 VACUUM FREEZE;
@@ -849,7 +927,7 @@ On some platforms, building with -fstrict-aliasing causes bugs.
 </para></listitem>
 <listitem><para>Make pg_restore handle 64-bit off_t correctly</para>
 <para>
-This bug prevented proper restoration from archive files exceeding 4Gb.
+This bug prevented proper restoration from archive files exceeding 4 GB.
 </para></listitem>
 <listitem><para>Make contrib/dblink not assume that local and remote type OIDs
 match (Joe)</para></listitem>
@@ -1149,7 +1227,7 @@ operations on bytea columns (Joe)</para></listitem>
     A dump/restore is <emphasis>not</emphasis> required for those
     running version 7.3. However, it should be noted that the main
     <productname>PostgreSQL</productname> interface library, libpq,
-    has a new major version number for this release, which may require
+    has a new major version number for this release, which might require
     recompilation of client code in certain cases.
    </para>
   </sect2>
@@ -1385,7 +1463,7 @@ operations on bytea columns (Joe)</para></listitem>
      <para>
       <command>COPY</command> no longer considers missing trailing
       columns to be null.  All columns need to be specified.
-      (However, one may achieve a similar effect by specifying a
+      (However, one can achieve a similar effect by specifying a
       column list in the <command>COPY</command> command.)
      </para>
     </listitem>
@@ -2286,7 +2364,7 @@ since <productname>PostgreSQL</productname> 7.1.
     <listitem>
      <para>
       The semantics of the <command>VACUUM</command> command have
-      changed in this release.  You may wish to update your
+      changed in this release.  You might wish to update your
       maintenance procedures accordingly.
      </para>
     </listitem>
@@ -2751,7 +2829,7 @@ since <productname>PostgreSQL</productname> 7.1.
 
     <para>
      <programlisting>
-Remove unused WAL segements of large transactions (Tom)
+Remove unused WAL segments of large transactions (Tom)
 Multiaction rule fix (Tom)
 PL/pgSQL memory allocation fix (Jan)
 VACUUM buffer fix (Tom)
@@ -2881,7 +2959,7 @@ previous releases of <productname>PostgreSQL</productname> have forced
 all data modifications to disk before each transaction commit.  With
 WAL, only one log file must be flushed to disk, greatly improving
 performance.  If you have been using -F in previous releases to
-disable disk flushes, you may want to consider discontinuing its use.
+disable disk flushes, you might want to consider discontinuing its use.
       </para>
      </listitem>
     </varlistentry>
@@ -2922,7 +3000,7 @@ outer join syntax.
 The previous C function manager did not
 handle null values properly, nor did it support 64-bit <acronym>CPU</acronym>'s (Alpha).  The new
 function manager does.  You can continue using your old custom
-functions, but you may want to rewrite them in the future to use the new
+functions, but you might want to rewrite them in the future to use the new
 function manager call interface.
       </para>
      </listitem>
@@ -3188,7 +3266,7 @@ Fix for psql \l+ when multibyte enabled (Tatsuo)
 Allow PL/pgSQL to accept non ascii identifiers (Tatsuo)
 Make vacuum always flush buffers (Tom)
 Fix to allow cancel while waiting for a lock (Hiroshi)
-Fix for memory aloocation problem in user authentication code (Tom)
+Fix for memory allocation problem in user authentication code (Tom)
 Remove bogus use of int4out() (Tom)
 Fixes for multiple subqueries in COALESCE or BETWEEN (Tom)
 Fix for failure of triggers on heap open in certain cases (Jeroen van
@@ -3395,7 +3473,7 @@ ecpg changes (Michael)
      A dump/restore using <application>pg_dump</application>
      is required for those wishing to migrate data from any
      previous release of <productname>PostgreSQL</productname>.
-     For those upgrading from 6.5.*, you may instead use 
+     For those upgrading from 6.5.*, you can instead use
      <application>pg_upgrade</application> to upgrade to this
      release; however, a full dump/reload installation is always the
      most robust method for upgrades.
@@ -3416,7 +3494,7 @@ ecpg changes (Michael)
        ease the transition by allowing
        <productname>PostgreSQL</productname> to recognize
        the deprecated type names and translate them to the new type
-       names, this mechanism may not be completely transparent to
+       names, this mechanism cannot be completely transparent to
        your existing application.
       </para>
      </listitem>
@@ -3428,8 +3506,8 @@ ecpg changes (Michael)
        decreased query times as the optimizer makes a better choice
        for the preferred plan. However, in a small number of cases,
        usually involving pathological distributions of data, your
-       query times may go up. If you are dealing with large amounts
+       query times might go up. If you are dealing with large amounts
-       of data, you may want to check your queries to verify
+       of data, you might want to check your queries to verify
        performance.
       </para>
      </listitem>
@@ -3667,7 +3745,7 @@ Fix for SELECT timespan('21:11:26'::time) (Tom)
 netmask('x.x.x.x/0') is 255.255.255.255 instead of 0.0.0.0 (Oleg Sharoiko)
 Add btree index on NUMERIC (Jan)
 Perl fix for large objects containing NUL characters (Douglas Thomson)
-ODBC fix for for large objects (free)
+ODBC fix for large objects (free)
 Fix indexing of cidr data type
 Fix for Ethernet MAC addresses (macaddr type) comparisons
 Fix for date/time types when overflows happened in computations (Tom)
@@ -3907,13 +3985,13 @@ Fix for EXPLAIN on inheritance(Tom)
 Patch to allow vacuum on multisegment tables(Hiroshi)
 R-Tree optimizer selectivity fix(Tom)
 ACL file descriptor leak fix(Atsushi Ogawa)
-New expresssion subtree code(Tom)
+New expression subtree code(Tom)
 Avoid disk writes for read-only transactions(Vadim)
 Fix for removal of temp tables if last transaction was aborted(Bruce)
 Fix to prevent too large row from being created(Bruce)
 plpgsql fixes
 Allow port numbers 32k - 64k(Bruce)
-Add ^ precidence(Bruce)
+Add ^ precedence(Bruce)
 Rename sort files called pg_temp to pg_sorttemp(Bruce)
 Fix for microseconds in time values(Tom)
 Tutorial source cleanup
@@ -4295,7 +4373,7 @@ New pg_options: pretty_plan, pretty_parse, pretty_rewritten(Jan)
 Better optimization statistics for system table access(Tom)
 Better handling of non-default block sizes(Massimo)
 Improve GEQO optimizer memory consumption(Tom)
-UNION now suppports ORDER BY of columns not in target list(Jan)
+UNION now supports ORDER BY of columns not in target list(Jan)
 Major libpq++ improvements(Vince Vielhaber)
 pg_dump now uses -z(ACL's) as default(Bruce)
 backend cache, memory speedups(Tom)
@@ -4593,7 +4671,7 @@ Jdbc cleanups(Peter)
 Show backend status on ps command line(only works on some platforms)(Bruce)
 Pg_hba.conf now has a sameuser option in the database field
 Make lo_unlink take oid param, not int4
-New DISABLE_COMPLEX_MACRO for compilers that can't handle our macros(Bruce)
+New DISABLE_COMPLEX_MACRO for compilers that cannot handle our macros(Bruce)
 Libpgtcl now handles NOTIFY as a Tcl event, need not send dummy queries(Tom)
 libpgtcl cleanups(Tom)
 Add -error option to libpgtcl's pg_result command(Tom)
@@ -4669,7 +4747,7 @@ New UNLISTEN command(Massimo)
 psql and libpq now compile under Windows using win32.mak(Magnus)
 Lo_read no longer stores trailing NULL(Bruce)
 Identifiers are now truncated to 31 characters internally(Bruce)
-Createuser options now availble on the command line
+Createuser options now available on the command line
 Code for 64-bit integer supported added, configure tested, int8 type(Thomas)
 Prevent file descriptor leaf from failed COPY(Bruce)
 New pg_upgrade command(Bruce)
@@ -4680,7 +4758,7 @@ New DECLARE and FETCH feature(Thomas)
 libpq's internal structures now not exported(Tom)
 Allow up to 8 key indexes(Bruce)
 Remove ARCHIVE key word, that is no longer used(Thomas)
-pg_dump -n flag to supress quotes around indentifiers
+pg_dump -n flag to suppress quotes around indentifiers
 disable system columns for views(Jan)
 new INET and CIDR types for network addresses(TomH, Paul)
 no more double quotes in psql output
@@ -4709,7 +4787,7 @@ NS32K platform fixes(Phil Nelson, John Buller)
 SCO 7/UnixWare 2.x fixes(Billy,others)
 Sparc/Solaris 2.5 fixes(Ryan)
 Pgbuiltin.3 is obsolete, move to doc files(Thomas)
-Even more documention(Thomas)
+Even more documentation(Thomas)
 Nextstep support(Jacek)
 Aix support(David)
 pginterface manual page(Bruce)
@@ -4910,7 +4988,7 @@ Better identify tcl and tk libs and includes(Bruce)
      <listitem>
       <para>
        Socket interface for client/server connection. This is the default now
-       so you may need to start <application>postmaster</application> with the
+       so you might need to start <application>postmaster</application> with the
        <option>-i</option> flag.
       </para>
      </listitem>
@@ -4946,9 +5024,9 @@ Better identify tcl and tk libs and includes(Bruce)
     mention that without subselects, SQL is a very limited language.
     Subselects are a major feature, and you should review your code for
     places where subselects provide a better solution for your queries.  I
-    think you will find that there are more uses for subselects than you may
+    think you will find that there are more uses for subselects than you might
     think.  Vadim has put us on the big SQL map with subselects, and fully
-    functional ones too.  The only thing you can't do with subselects is to
+    functional ones too.  The only thing you cannot do with subselects is to
     use them in the target list.
    </para>
    <para>
@@ -4961,7 +5039,7 @@ Better identify tcl and tk libs and includes(Bruce)
     Third, <type>char()</type> fields will now allow faster access than <type>varchar()</type> or
     <type>text</type>. Specifically, the <type>text</> and <type>varchar()</type> have a penalty for access to
     any columns after the first column of this type.  <type>char()</type> used to also
-    have this access penalty, but it no longer does.  This may suggest that
+    have this access penalty, but it no longer does.  This might suggest that
     you redesign some of your tables, especially if you have short character
     columns that you have defined as <type>varchar()</type> or <type>text</type>.  This and other
     changes make 6.3 even faster than earlier releases.
@@ -5057,7 +5135,7 @@ Check boolean input literals for 'true','false','yes','no','1','0'
         and throw elog(ERROR) if unrecognized(Thomas)
 Major large objects fix
 Fix for GROUP BY showing duplicates(Vadim)
-Fix for index scans in MergeJion(Vadim)
+Fix for index scans in MergeJoin(Vadim)
 
 Enhancements
 ------------
@@ -5510,7 +5588,7 @@ optimizer which uses <firstterm>genetic</firstterm>
   The interpretation of array specifiers (the curly braces around atomic
   values) appears to have changed sometime after the original regression
   tests were generated. The current <filename>./expected/*.out</filename> files reflect this
-  new interpretation, which may not be correct!
+  new interpretation, which might not be correct!
 </para>
 
 <para>
@@ -5682,7 +5760,7 @@ because the COPY output format was improved from the 1.02 release.
      <programlisting>
 Bug Fixes
 ---------
-ALTER TABLE bug - running postgress process needs to re-read table definition
+ALTER TABLE bug - running postgres process needs to re-read table definition
 Allow vacuum to be run on one table or entire database(Bruce)
 Array fixes
 Fix array over-runs of memory writes(Kurt)
@@ -5690,7 +5768,7 @@ Fix elusive btree range/non-range bug(Dan)
 Fix for hash indexes on some types like time and date
 Fix for pg_log size explosion
 Fix permissions on lo_export()(Bruce)
-Fix unitialized reads of memory(Kurt)
+Fix uninitialized reads of memory(Kurt)
 Fixed ALTER TABLE ... char(3) bug(Bruce)
 Fixed a few small memory leaks
 Fixed EXPLAIN handling of options and changed full_path option name
@@ -5734,7 +5812,7 @@ Change default decimal constant representation from float4 to float8(Bruce)
 European date format now set when postmaster is started
 Execute lowercase function names if not found with exact case
 Fixes for aggregate/GROUP processing, allow 'select sum(func(x),sum(x+y) from z'
-Gist now included in the distrubution(Marc)
+Gist now included in the distribution(Marc)
 Idend authentication of local users(Bryan)
 Implement BETWEEN qualifier(Bruce)
 Implement IN qualifier(Bruce)
@@ -5763,7 +5841,7 @@ Vacuum now had VERBOSE option(Bruce)
 Source tree changes
 -------------------
 All functions now have prototypes that are compared against the calls
-Allow asserts to be disabled easly from Makefile.global(Bruce)
+Allow asserts to be disabled easily from Makefile.global(Bruce)
 Change oid constants used in code to #define names
 Decoupled sparc and solaris defines(Kurt)
 Gcc -Wall compiles cleanly with warnings only from unfixable constructs
@@ -5776,13 +5854,13 @@ Name change from Postgres95 to PostgreSQL
 New config.h file(Marc, Bryan)
 PG_VERSION now set to 6.0 and used by postmaster
 Portability additions, including Ultrix, DG/UX, AIX, and Solaris
-Reduced the number of #define's, centeralized #define's
+Reduced the number of #define's, centralized #define's
 Remove duplicate OIDS in system tables(Dan)
 Remove duplicate system catalog info or report mismatches(Dan)
 Removed many os-specific #define's
 Restructured object file generation/location(Bryan, Marc)
 Restructured port-specific file locations(Bryan, Marc)
-Unused/uninialized variables corrected
+Unused/uninitialized variables corrected
 </programlisting>
 </para>
 </sect2>
@@ -5922,7 +6000,7 @@ New Ports
 </programlisting>
 </para>
 <!--
-Contributors (appologies to any missed)
+Contributors (apologies to any missed)
  * Kurt J. Lidl &lt;lidl@va.pubnix.com&gt;
         (missed in first run, but no less important)
  * Erich Stamberger &lt;eberger@gewi.kfunigraz.ac.at&gt;
@@ -5998,7 +6076,7 @@ If you do, you must create a file name <literal>pg_hba</literal> in your top-lev
 <step>
 <para>
 If you do not want host-based authentication, you can comment out
-   the line
+   the line:
 <programlisting>
         HBA = 1
 </programlisting>
@@ -6224,7 +6302,7 @@ Incompatible changes:
  * float literals (eg. 3.14) are now of type float4 (instead of float8 in
    previous releases); you might have to do typecasting if you depend on it
    being of type float8.  If you neglect to do the typecasting and you assign
-   a float literal to a field of type float8, you may get incorrect values
+   a float literal to a field of type float8, you might get incorrect values
    stored!
  * LIBPQ has been totally revamped so that frontend applications
    can connect to multiple backends
@@ -6260,7 +6338,7 @@ more compliant to the SQL-92 standard):
 
         "WITH GRANT OPTION" is not supported.  Only class owners can change
         access control
-   - The default access control is to to grant users readonly access.
+   - The default access control is to grant users readonly access.
      You must explicitly grant insert/update access to users.  To change
      this, modify the line in
                 src/backend/utils/acl.h
@@ -6487,20 +6565,3 @@ In general, however, 6.3 is substantially faster than previous releases (thanks,
 </sect1>
 ]]>
 </appendix>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode:sgml
-sgml-omittag:nil
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-default-dtd-file:"./reference.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:("/usr/lib/sgml/catalog")
-sgml-local-ecat-files:nil
-End:
--->