]> granicus.if.org Git - postgresql/blob - doc/src/sgml/release.sgml
Update for 6.5.3.
[postgresql] / doc / src / sgml / release.sgml
1  <chapter id="release">
2   <title>Release Notes</title>
3
4 <sect1>
5 <title>Release 6.5.3</title>
6 <!--
7 <docinfo>
8 <authorgroup>
9 <author>
10 <firstname>Bruce</firstname>
11 <surname>Momjian</surname>
12 </author>
13 </authorgroup>
14 <date>1999-10-13</date>
15 </docinfo>
16 -->
17
18 <para>
19 This is basically a cleanup release for 6.5.2.  We have added a new
20 pgaccess that was missing in 6.5.2, and installed an NT-specific
21 fix.
22 </para>
23
24
25 <sect2>
26 <title>Migration to v6.5.3</title>
27
28 <para>
29 A dump/restore is <emphasis>not</emphasis> required for those running
30 6.5.*.
31 </para>
32 </sect2>
33 <sect2>
34 <title>Detailed Change List</title>
35
36 <para>
37 <programlisting>
38 Updated version of pgaccess 0.98
39 NT-specific patch
40 Fix dumping rules on inherited tables
41 </programlisting>
42 </para>
43 </sect2>
44 </sect1>
45
46
47 <sect1>
48 <title>Release 6.5.2</title>
49 <!--
50 <docinfo>
51 <authorgroup>
52 <author>
53 <firstname>Bruce</firstname>
54 <surname>Momjian</surname>
55 </author>
56 </authorgroup>
57 <date>1999-09-15</date>
58 </docinfo>
59 -->
60
61 <para>
62 This is basically a cleanup release for 6.5.1.  We have fixed a variety of
63 problems reported by 6.5.1 users.
64 </para>
65
66
67 <sect2>
68 <title>Migration to v6.5.2</title>
69
70 <para>
71 A dump/restore is <emphasis>not</emphasis> required for those running
72 6.5.*.
73 </para>
74 </sect2>
75 <sect2>
76 <title>Detailed Change List</title>
77
78 <para>
79 <programlisting>
80 subselect+CASE fixes(Tom)
81 Add SHLIB_LINK setting for solaris_i386 and solaris_sparc ports(Daren Sefcik)
82 Fixes for CASE in WHERE join clauses(Tom)
83 Fix BTScan abort(Tom)
84 Repair the check for redundant UNIQUE and PRIMARY KEY indices(Thomas)
85 Improve it so that it checks for multi-column constraints(Thomas)
86 Fix for Win32 making problem with MB enabled(Hiroki Kataoka)
87 Allow BSD yacc and bison to compile pl code(Bruce)
88 Fix SET NAMES working
89 int8 fixes(Thomas)
90 Fix vacuum's memory consumption(Hiroshi,Tatsuo)
91 Reduce the total memory consumption of vacuum(Tom)
92 Fix for timestamp(datetime)
93 Rule deparsing bugfixes(Tom)
94 Fix quoting problems in mkMakefile.tcldefs.sh.in and mkMakefile.tkdefs.sh.in(Tom)
95 This is to re-use space on index pages freed by vacuum(Vadim)
96 document -x for pg_dump(Bruce)
97 Fix for unary operators in rule deparser(Tom)
98 Comment out FileUnlink of excess segments during mdtruncate()(Tom)
99 Irix linking fix from Yu Cao &gt;yucao@falcon.kla-tencor.com&lt;
100 Repair logic error in LIKE: should not return LIKE_ABORT
101    when reach end of pattern before end of text(Tom)
102 Repair incorrect cleanup of heap memory allocation during transaction abort(Tom)
103 Updated version of pgaccess 0.98
104 </programlisting>
105 </para>
106 </sect2>
107 </sect1>
108
109
110 <sect1>
111 <title>Release 6.5.1</title>
112 <!--
113 <docinfo>
114 <authorgroup>
115 <author>
116 <firstname>Bruce</firstname>
117 <surname>Momjian</surname>
118 </author>
119 </authorgroup>
120 <date>1999-07-15</date>
121 </docinfo>
122 -->
123
124 <para>
125 This is basically a cleanup release for 6.5.  We have fixed a variety of
126 problems reported by 6.5 users.
127 </para>
128
129
130 <sect2>
131 <title>Migration to v6.5.1</title>
132
133 <para>
134 A dump/restore is <emphasis>not</emphasis> required for those running
135 6.5.
136 </para>
137 </sect2>
138 <sect2>
139 <title>Detailed Change List</title>
140
141 <para>
142 <programlisting>
143 Add NT README file
144 Portability fixes for linux_ppc, Irix, linux_alpha, OpenBSD, alpha
145 Remove QUERY_LIMIT, use SELECT...LIMIT
146 Fix for EXPLAIN on inheritance(Tom)
147 Patch to allow vacuum on multi-segment tables(Hiroshi)
148 R-Tree optimizer selectivity fix(Tom)
149 ACL file descriptor leak fix(Atsushi Ogawa)
150 New expresssion subtree code(Tom)
151 Avoid disk writes for read-only transactions(Vadim)
152 Fix for removal of temp tables if last transaction was aborted(Bruce)
153 Fix to prevent too large tuple from being created(Bruce)
154 plpgsql fixes
155 Allow port numbers 32k - 64k(Bruce)
156 Add ^ precidence(Bruce)
157 Rename sort files called pg_temp to pg_sorttemp(Bruce)
158 Fix for microseconds in time values(Tom)
159 Tutorial source cleanup
160 New linux_m68k port
161 Fix for sorting of NULL's in some cases(Tom)
162 Shared library dependencies fixed (Tom)
163 Fixed glitches affecting GROUP BY in subselects(Tom)
164 Fix some compiler warnings (Tomoaki Nishiyama)
165 Add Win1250 (Czech) support (Pavel Behal)
166 </programlisting>
167 </para>
168 </sect2>
169 </sect1>
170
171
172   <sect1>
173    <title>Release 6.5</title>
174 <!--
175 <docinfo>
176 <authorgroup>
177 <author>
178 <firstname>Bruce</firstname>
179 <surname>Momjian</surname>
180 </author>
181 </authorgroup>
182 <date>1998-06-09</date>
183 </docinfo>
184 -->
185
186    <para>
187     This release marks a major step in the development team's mastery of the source
188     code we inherited from Berkeley.  You will see we are now easily adding
189     major features, thanks to the increasing size and experience of our
190     world-wide development team.
191    </para>
192
193    <para>
194     Here is a brief summary of the more notable changes:
195
196     <variablelist>
197      <varlistentry>
198       <term>
199        Multi-version concurrency control(MVCC)
200       </term>
201       <listitem>
202        <para>
203         This removes our old
204         table-level locking, and replaces it with a locking system that is
205         superior to most commercial database systems.  In a traditional system,
206         each row that is modified is locked until committed, preventing reads by
207         other users.  MVCC uses the natural multi-version nature of PostgreSQL
208         to allow readers to continue reading consistent data during writer
209         activity.  Writers continue to use the compact pg_log transaction
210         system.  This is all performed without having to allocate a lock for
211         every row like traditional database systems.  So, basically, we no
212         longer are restricted by simple table-level locking;
213         we have something better than row-level locking.
214        </para>
215       </listitem>
216      </varlistentry>
217
218      <varlistentry>
219       <term>
220        Hot backups from <application>pg_dump</application>
221       </term>
222       <listitem>
223        <para>
224         <application>pg_dump</application> takes advantage of the new
225         MVCC features to give a consistant database dump/backup while
226         the database stays online and available for queries.
227        </para>
228       </listitem>
229      </varlistentry>
230
231      <varlistentry>
232       <term>
233        Numeric data type
234       </term>
235       <listitem>
236        <para>
237         We now have a true numeric data type, with
238         user-specified precision.
239        </para>
240       </listitem>
241      </varlistentry>
242
243      <varlistentry>
244       <term>
245        Temporary tables
246       </term>
247       <listitem>
248        <para>
249         Temporary tables are guaranteed to have unique names
250         within a database session, and are destroyed on session exit.
251        </para>
252       </listitem>
253      </varlistentry>
254
255      <varlistentry>
256       <term>
257        New SQL features
258       </term>
259       <listitem>
260        <para>
261         We now have CASE, INTERSECT, and EXCEPT statement
262         support.  We have new LIMIT/OFFSET, SET TRANSACTION ISOLATION LEVEL,
263         SELECT ... FOR UPDATE, and an improved LOCK TABLE command.
264        </para>
265       </listitem>
266      </varlistentry>
267
268      <varlistentry>
269       <term>
270        Speedups
271       </term>
272       <listitem>
273        <para>
274         We continue to speed up PostgreSQL, thanks to the variety of
275         talents within our team.  We have sped up memory allocation,
276         optimization, table joins, and row transfer routines.
277        </para>
278       </listitem>
279      </varlistentry>
280
281      <varlistentry>
282       <term>
283        Ports
284       </term>
285       <listitem>
286        <para>
287         We continue to expand our port list, this time including
288         WinNT/ix86 and NetBSD/arm32.
289        </para>
290       </listitem>
291      </varlistentry>
292
293      <varlistentry>
294       <term>
295        Interfaces
296       </term>
297       <listitem>
298        <para>
299         Most interfaces have new versions, and existing functionality
300         has been improved.
301        </para>
302       </listitem>
303      </varlistentry>
304
305      <varlistentry>
306       <term>
307        Documentation
308       </term>
309       <listitem>
310        <para>
311         New and updated material is present throughout the
312         documentation. New <acronym>FAQ</acronym>s have been
313         contributed for SGI and AIX platforms.
314         The <citetitle>Tutorial</citetitle> has introductory information
315         on <acronym>SQL</acronym> from Stefan Simkovics.
316         For the <citetitle>User's Guide</citetitle>, there are
317         reference pages covering the postmaster and more utility
318         programs, and a new appendix
319         contains details on date/time behavior.
320         The <citetitle>Administrator's Guide</citetitle> has a new
321         chapter on troubleshooting from Tom Lane.
322         And the <citetitle>Programmer's Guide</citetitle> has a
323         description of query processing, also from Stefan, and details 
324         on obtaining the <productname>Postgres</productname> source
325         tree via anonymous <productname>CVS</productname> and
326         <productname>CVSup</productname>. 
327        </para>
328       </listitem>
329      </varlistentry>
330     </variablelist>
331    </para>
332
333    <sect2>
334     <title>Migration to v6.5</title>
335
336     <para>
337      A dump/restore using <application>pg_dump</application>
338      is required for those wishing to migrate data from any
339      previous release of <productname>Postgres</productname>.
340      <application>pg_upgrade</application> can <emphasis>not</emphasis>
341      be used to upgrade to this release because the on-disk structure
342      of the tables has changed compared to previous releases.
343     </para>
344
345     <para>
346      The new Multi-Version Concurrency Control (MVCC) features can
347      give somewhat different behaviors in multi-user
348      environments. <emphasis>Read and understand the following section 
349       to ensure that your existing applications will give you the
350       behavior you need.</emphasis>
351     </para>
352
353     <sect3>
354      <title>Multi-Version Concurrency Control</title>
355
356      <para>
357       Because readers in 6.5 don't lock data, regardless of transaction
358       isolation level, data read by one transaction can be overwritten by
359       another. In other words, if a row is returned by
360       <command>SELECT</command> it doesn't mean that this row really exists
361       at the time it is returned (i.e. sometime after the statement or
362       transaction began) nor that the row is protected from being deleted or
363       updated by concurrent transactions before the current transaction does
364       a commit or rollback.
365      </para>
366
367      <para>
368       To ensure the actual existence of a row and protect it against
369       concurrent updates one must use <command>SELECT FOR UPDATE</command> or
370       an appropriate <command>LOCK TABLE</command> statement. This should be
371       taken into account when porting applications from previous releases of
372       <productname>Postgres</productname> and other environments.
373      </para>
374
375      <para>
376       Keep the above in mind if you are using
377       <filename>contrib/refint.*</filename> triggers for
378       referential integrity. Additional technics are required now. One way is
379       to use <command>LOCK parent_table IN SHARE ROW EXCLUSIVE MODE</command>
380       command if a transaction is going to update/delete a primary key and
381       use <command>LOCK parent_table IN SHARE MODE</command> command if a
382       transaction is going to update/insert a foreign key.
383
384       <note>
385        <para>
386         Note that if you run a transaction in SERIALIZABLE mode then you must
387         execute the <command>LOCK</command> commands above before execution of any
388         DML statement
389         (<command>SELECT/INSERT/DELETE/UPDATE/FETCH/COPY_TO</command>) in the
390         transaction.
391        </para>
392       </note>
393      </para>
394
395      <para>
396       These inconveniences will disappear in the future
397       when the ability to read dirty
398       (uncommitted) data (regardless of isolation level) and true referential
399       integrity will be implemented.
400      </para>
401     </sect3>
402     </sect2>
403
404    <sect2>
405     <title>Detailed Change List</title>
406     <para>
407      <programlisting>
408 Bug Fixes
409 ---------
410 Fix text<->float8 and text<->float4 conversion functions(Thomas)
411 Fix for creating tables with mixed-case constraints(Billy)
412 Change exp()/pow() behavior to generate error on underflow/overflow(Jan)
413 Fix bug in pg_dump -z
414 Memory overrun cleanups(Tatsuo)
415 Fix for lo_import crash(Tatsuo)
416 Adjust handling of data type names to suppress double quotes(Thomas)
417 Use type coersion for matching columns and DEFAULT(Thomas)
418 Fix deadlock so it only checks once after one second of sleep(Bruce)
419 Fixes for aggregates and PL/pgsql(Hiroshi)
420 Fix for subquery crash(Vadim)
421 Fix for libpq function PQfnumber and case-insensitive names(Bahman Rafatjoo)
422 Fix for large object write-in-middle, no extra block, memory consumption(Tatsuo)
423 Fix for pg_dump -d or -D and  quote special characters in INSERT
424 Repair serious problems with dynahash(Tom)
425 Fix INET/CIDR portability problems
426 Fix problem with selectivity error in ALTER TABLE ADD COLUMN(Bruce)
427 Fix executor so mergejoin of different column types works(Tom)
428 Fix for Alpha OR selectivity bug
429 Fix OR index selectivity problem(Bruce)
430 Fix so \d shows proper length for char()/varchar()(Ryan)
431 Fix tutorial code(Clark)
432 Improve destroyuser checking(Oliver)
433 Fix for Kerberos(Rodney McDuff)
434 Fix for dropping database while dirty buffers(Bruce)
435 Fix so sequence nextval() can be case-sensitive(Bruce)
436 Fix !!= operator
437 Drop buffers before destroying database files(Bruce)
438 Fix case where executor evaluates functions twice(Tatsuo)
439 Allow sequence nextval actions to be case-sensitive(Bruce)
440 Fix optimizer indexing not working for negative numbers(Bruce)
441 Fix for memory leak in executor with fjIsNull
442 Fix for aggregate memory leaks(Erik Riedel)
443 Allow username containing a dash GRANT permissions
444 Cleanup of NULL in inet types
445 Clean up system table bugs(Tom)
446 Fix problems of PAGER and \? command(Masaaki Sakaida)
447 Reduce default multi-segment file size limit to 1GB(Peter)
448 Fix for dumping of CREATE OPERATOR(Tom)
449 Fix for backward scanning of cursors(Hiroshi Inoue)
450 Fix for COPY FROM STDIN when using \i(Tom)
451 Fix for subselect is compared inside an expression(Jan)
452 Fix handling of error reporting while returning rows(Tom)
453 Fix problems with reference to array types(Tom,Jan)
454 Prevent UPDATE SET oid(Jan)
455 Fix pg_dump so -t option can handle case-sensitive tablenames
456 Fixes for GROUP BY in special cases(Tom, Jan)
457 Fix for memory leak in failed queries(Tom)
458 DEFAULT now supports mixed-case identifiers(Tom)
459 Fix for multi-segment uses of DROP/RENAME table, indexes(Ole Gjerde)
460 Disable use of pg_dump with both -o and -d options(Bruce)
461 Allow pg_dump to properly dump GROUP permissions(Bruce)
462 Fix GROUP BY in INSERT INTO table SELECT * FROM table2(Jan)
463 Fix for computations in views(Jan)
464 Fix for aggregates on array indexes(Tom)
465 Fix for DEFAULT handles single quotes in value requiring too many quotes
466 Fix security problem with non-super users importing/exporting large objects(Tom)
467 Rollback of transaction that creates table cleaned up properly(Tom)
468 Fix to allow long table and column names to generate proper serial names(Tom)
469
470 Enhancements
471 ------------
472 Add "vacuumdb" utility
473 Speed up libpq by allocating memory better(Tom)
474 EXPLAIN all indices used(Tom)
475 Implement CASE, COALESCE, NULLIF  expression(Thomas)
476 New pg_dump table output format(Constantin)
477 Add string min()/max() functions(Thomas)
478 Extend new type coersion techniques to aggregates(Thomas)
479 New moddatetime contrib(Terry)
480 Update to pgaccess 0.96(Constantin)
481 Add routines for single-byte "char" type(Thomas)
482 Improved substr() function(Thomas)
483 Improved multi-byte handling(Tatsuo)
484 Multi-version concurrency control/MVCC(Vadim)
485 New Serialized mode(Vadim)
486 Fix for tables over 2gigs(Peter)
487 New SET TRANSACTION ISOLATION LEVEL(Vadim)
488 New LOCK TABLE IN ... MODE(Vadim)
489 Update ODBC driver(Byron)
490 New NUMERIC data type(Jan)
491 New SELECT FOR UPDATE(Vadim)
492 Handle "NaN" and "Infinity" for input values(Jan)
493 Improved date/year handling(Thomas)
494 Improved handling of backend connections(Magnus)
495 New options ELOG_TIMESTAMPS and USE_SYSLOG options for log files(Massimo)
496 New TCL_ARRAYS option(Massimo)
497 New INTERSECT and EXCEPT(Stefan)
498 New pg_index.indisprimary for primary key tracking(D'Arcy)
499 New pg_dump option to allow dropping of tables before creation(Brook)
500 Speedup of row output routines(Tom)
501 New READ COMMITTED isolation level(Vadim)
502 New TEMP tables/indexes(Bruce)
503 Prevent sorting if result is already sorted(Jan)
504 New memory allocation optimization(Jan)
505 Allow psql to do \p\g(Bruce)
506 Allow multiple rule actions(Jan)
507 Added LIMIT/OFFSET functionality(Jan)
508 Improve optimizer when joining a large number of tables(Bruce)
509 New intro to SQL from S. Simkovics' Master's Thesis (Stefan, Thomas)
510 New intro to backend processing from S. Simkovics' Master's Thesis (Stefan)
511 Improved int8 support(Ryan Bradetich, Thomas, Tom)
512 New routines to convert between int8 and text/varchar types(Thomas)
513 New bushy plans, where meta-tables are joined(Bruce)
514 Enable right-hand queries by default(Bruce)
515 Allow reliable maximum number of backends to be set at configure time
516       (--with-maxbackends and postmaster switch (-N backends))(Tom)
517 GEQO default now 10 tables because of optimizer speedups(Tom)
518 Allow NULL=Var for MS-SQL portability(Michael, Bruce)
519 Modify contrib check_primary_key() so either "automatic" or "dependent"(Anand)
520 Allow psql \d on a view show query(Ryan)
521 Speedup for LIKE(Bruce)
522 Ecpg fixes/features, see src/interfaces/ecpg/ChangeLog file(Michael)
523 JDBC fixes/features, see src/interfaces/jdbc/CHANGELOG(Peter)
524 Make % operator have precedence like /(Bruce)
525 Add new postgres -O option to allow system table structure changes(Bruce)
526 Update contrib/pginterface/findoidjoins script(Tom)
527 Major speedup in vacuum of deleted rows with indexes(Vadim) 
528 Allow non-SQL functions to run different versions based on arguments(Tom)
529 Add -E option that shows actual queries sent by \dt and friends(Masaaki Sakaida)
530 Add version number in startup banners for psql(Masaaki Sakaida)
531 New contrib/vacuumlo removes large objects not referenced(Peter)
532 New initialization for table sizes so non-vacuumed tables perform better(Tom)
533 Improve error messages when a connection is rejected(Tom)
534 Support for arrays of char() and varchar() fields(Massimo)
535 Overhaul of hash code to increase reliability and performance(Tom)
536 Update to PyGreSQL 2.4(D'Arcy)
537 Changed debug options so -d4 and -d5 produce different node displays(Jan)
538 New pg_options: pretty_plan, pretty_parse, pretty_rewritten(Jan)
539 Better optimization statistics for system table access(Tom)
540 Better handling of non-default block sizes(Massimo)
541 Improve GEQO optimizer memory consumption(Tom)
542 UNION now suppports ORDER BY of columns not in target list(Jan)
543 Major libpq++ improvements(Vince Vielhaber)
544 pg_dump now uses -z(ACL's) as default(Bruce)
545 backend cache, memory speedups(Tom)
546 have pg_dump do everything in one snapshot transaction(Vadim)
547 fix for large object memory leakage, fix for pg_dumping(Tom)
548 INET type now respects netmask for comparisons
549 Make VACUUM ANALYZE only use a readlock(Vadim)
550 Allow VIEWs on UNIONS(Jan)
551 pg_dump now can generate consistent snapshots on active databases(Vadim)
552
553 Source Tree Changes
554 -------------------
555 Improve port matching(Tom)
556 Portability fixes for SunOS
557 Add NT/Win32 backend port and enable dynamic loading(Magnus and Daniel Horak)
558 New port to Cobalt Qube(Mips) running Linux(Tatsuo)
559 Port to NetBSD/m68k(Mr. Mutsuki Nakajima)
560 Port to NetBSD/sun3(Mr. Mutsuki Nakajima)
561 Port to NetBSD/macppc(Toshimi Aoki)
562 Fix for tcl/tk configuration(Vince)
563 Removed CURRENT keyword for rule queries(Jan)
564 NT dynamic loading now works(Daniel Horak)
565 Add ARM32 support(Andrew McMurry)
566 Better support for HPUX 11 and Unixware
567 Improve file handling to be more uniform, prevent file descriptor leak(Tom)
568 New install commands for plpgsql(Jan)
569      </programlisting>
570     </para>
571    </sect2>
572   </sect1>
573
574
575 <sect1>
576 <title>Release 6.4.2</title>
577 <!--
578 <docinfo>
579 <authorgroup>
580 <author>
581 <firstname>Bruce</firstname>
582 <surname>Momjian</surname>
583 </author>
584 </authorgroup>
585 <date>1999-12-20</date>
586 </docinfo>
587 -->
588
589 <para>
590 The 6.4.1 release was improperly packaged.  This also has one additional
591 bug fix.
592 </para>
593
594
595 <sect2>
596 <title>Migration to v6.4.2</title>
597
598 <para>
599 A dump/restore is <emphasis>not</emphasis> required for those running
600 6.4.*.
601 </para>
602 </sect2>
603 <sect2>
604 <title>Detailed Change List</title>
605
606 <para>
607 <programlisting>
608 Fix for datetime constant problem on some platforms(Thomas)
609 </programlisting>
610 </para>
611 </sect2>
612 </sect1>
613
614
615
616 <sect1>
617 <title>Release 6.4.1</title>
618 <!--
619 <docinfo>
620 <authorgroup>
621 <author>
622 <firstname>Bruce</firstname>
623 <surname>Momjian</surname>
624 </author>
625 </authorgroup>
626 <date>1999-12-18</date>
627 </docinfo>
628 -->
629
630 <para>
631 This is basically a cleanup release for 6.4.  We have fixed a variety of
632 problems reported by 6.4 users.
633 </para>
634
635
636 <sect2>
637 <title>Migration to v6.4.1</title>
638
639 <para>
640 A dump/restore is <emphasis>not</emphasis> required for those running
641 6.4.
642 </para>
643 </sect2>
644 <sect2>
645 <title>Detailed Change List</title>
646
647 <para>
648 <programlisting>
649 Add pg_dump -N flag to force double quotes around identifiers.  This is
650         the default(Thomas)
651 Fix for NOT in where clause causing crash(Bruce)
652 EXPLAIN VERBOSE coredump fix(Vadim)
653 Fix shared-library problems on Linux
654 Fix test for table existance to allow mixed-case and whitespace in
655         the table name(Thomas)
656 Fix a couple of pg_dump bugs
657 Configure matches template/.similar entries better(Tom)
658 Change builtin function names from SPI_* to spi_*
659 OR WHERE clause fix(Vadim)
660 Fixes for mixed-case table names(Billy)
661 contrib/linux/postgres.init.csh/sh fix(Thomas)
662 libpq memory overrun fix
663 SunOS fixes(Tom)
664 Change exp() behavior to generate error on underflow(Thomas)
665 pg_dump fixes for memory leak, inheritance constraints, layout change
666 update pgaccess to 0.93
667 Fix prototype for 64-bit platforms
668 Multi-byte fixes(Tatsuo)
669 New ecpg man page
670 Fix memory overruns(Tatsuo)
671 Fix for lo_import() crash(Bruce)
672 Better search for install program(Tom)
673 Timezone fixes(Tom)
674 HPUX fixes(Tom)
675 Use implicit type coersion for matching DEFAULT values(Thomas)
676 Add routines to help with single-byte (internal) character type(Thomas)
677 Compilation of libpq for Win32 fixes(Magnus)
678 Upgrade to PyGreSQL 2.2(D'Arcy)
679 </programlisting>
680 </para>
681 </sect2>
682 </sect1>
683
684
685
686 <sect1>
687 <title>Release 6.4</title>
688 <!--
689 <docinfo>
690 <authorgroup>
691 <author>
692 <firstname>Bruce</firstname>
693 <surname>Momjian</surname>
694 </author>
695 </authorgroup>
696 <date>1998-10-30</date>
697 </docinfo>
698 -->
699
700 <para>
701 There are <emphasis>many</emphasis> new features and improvements in this release.
702 Thanks to our developers and maintainers, nearly every aspect of the system
703 has received some attention since the previous release.
704 Here is a brief, incomplete summary:
705
706 <itemizedlist>
707 <listitem>
708 <para>
709 Views and rules are now functional thanks to extensive new code in the 
710 rewrite rules system from Jan Wieck. He also wrote a chapter on it
711 for the <citetitle>Programmer's Guide</citetitle>.
712 </para>
713 </listitem>
714 <listitem>
715 <para>
716 Jan also contributed a second procedural language, PL/pgSQL, to go with the
717 original PL/pgTCL procedural language he contributed last release.
718 </para>
719 </listitem>
720
721 <listitem>
722 <para>
723 We have optional multiple-byte character set support from Tatsuo Iishi
724 to complement our existing locale support.
725 </para>
726 </listitem>
727
728 <listitem>
729 <para>
730 Client/server communications has been cleaned up, with better support for
731 asynchronous messages and interrupts thanks to Tom Lane.
732 </para>
733 </listitem>
734
735 <listitem>
736 <para>
737 The parser will now perform automatic type coersion to match arguments
738 to available operators and functions, and to match columns and expressions
739 with target columns. This uses a generic mechanism which supports
740 the type extensibility features of <productname>Postgres</productname>.
741 There is a new chapter in the <citetitle>User's Guide</citetitle>
742 which covers this topic.
743 </para>
744 </listitem>
745
746 <listitem>
747 <para>
748 Three new data types have been added. 
749 Two types, <type>inet</type> and <type>cidr</type>, support various forms
750 of IP network, subnet, and machine addressing. There is now an 8-byte integer
751 type available on some platforms. See the chapter on data types
752 in the <citetitle>User's Guide</citetitle> for details.
753 A fourth type, <type>serial</type>, is now supported by the parser as an
754 amalgam of the <type>int4</type> type, a sequence, and a unique index.
755 </para>
756 </listitem>
757
758 <listitem>
759 <para>
760 Several more <acronym>SQL92</acronym>-compatible syntax features have been
761 added, including <command>INSERT DEFAULT VALUES</command>
762 </para>
763 </listitem>
764
765 <listitem>
766 <para>
767 The automatic configuration and installation system has received some
768 attention, and should be more robust for more platforms than it has ever
769 been.
770 </para>
771 </listitem>
772
773 </itemizedlist>
774 </para>
775
776 <sect2>
777 <title>Migration to v6.4</title>
778
779 <para>
780 A dump/restore using <application>pg_dump</application> 
781 or <application>pg_dumpall</application>
782 is required for those wishing to migrate data from any
783 previous release of <productname>Postgres</productname>.
784 </para>
785 </sect2>
786 <sect2>
787 <title>Detailed Change List</title>
788
789 <para>
790 <programlisting>
791 Bug Fixes
792 ---------
793 Fix for a tiny memory leak in PQsetdb/PQfinish(Bryan)
794 Remove char2-16 data types, use char/varchar(Darren)
795 Pqfn not handles a NOTICE message(Anders)
796 Reduced busywaiting overhead for spinlocks with many backends (dg)
797 Stuck spinlock detection (dg)
798 Fix up "ISO-style" timespan decoding and encoding(Thomas)
799 Fix problem with table drop after rollback of transaction(Vadim)
800 Change error message and remove non-functional update message(Vadim)
801 Fix for COPY array checking
802 Fix for SELECT 1 UNION SELECT NULL
803 Fix for buffer leaks in large object calls(Pascal)
804 Change owner from oid to int4 type(Bruce)
805 Fix a bug in the oracle compatibility functions btrim() ltrim() and rtrim()
806 Fix for shared invalidation cache overflow(Massimo)
807 Prevent file descriptor leaks in failed COPY's(Bruce)
808 Fix memory leak in libpgtcl's pg_select(Constantin)
809 Fix problems with username/passwords over 8 characters(Tom)
810 Fix problems with handling of asynchronous NOTIFY in backend(Tom)
811 Fix of many bad system table entries(Tom)
812
813 Enhancements
814 ------------
815 Upgrade ecpg and ecpglib,see src/interfaces/ecpc/ChangeLog(Michael)
816 Show the index used in an EXPLAIN(Zeugswetter)
817 EXPLAIN  invokes  rule system and shows plan(s) for rewritten queries(Jan)
818 Multi-byte awareness of many data types and functions, via configure(Tatsuo)
819 New configure --with-mb option(Tatsuo)
820 New initdb --pgencoding option(Tatsuo)
821 New createdb -E multibyte option(Tatsuo)
822 Select version(); now returns PostgreSQL version(Jeroen)
823 Libpq now allows asynchronous clients(Tom)
824 Allow cancel from client of backend query(Tom)
825 Psql now cancels query with Control-C(Tom)
826 Libpq users need not issue dummy queries to get NOTIFY messages(Tom)
827 NOTIFY now sends sender's PID, so you can tell whether it was your own(Tom)
828 PGresult struct now includes associated error message, if any(Tom)
829 Define "tz_hour" and "tz_minute" arguments to date_part()(Thomas)
830 Add routines to convert between varchar and bpchar(Thomas)
831 Add routines to allow sizing of varchar and bpchar into target columns(Thomas)
832 Add bit flags to support timezonehour and minute in data retrieval(Thomas)
833 Allow more variations on valid floating point numbers (e.g. ".1", "1e6")(Thomas)
834 Fixes for unary minus parsing with leading spaces(Thomas)
835 Implement TIMEZONE_HOUR, TIMEZONE_MINUTE per SQL92 specs(Thomas)
836 Check for and properly ignore FOREIGN KEY column constraints(Thomas)
837 Define USER as synonym for CURRENT_USER per SQL92 specs(Thomas)
838 Enable HAVING clause but no fixes elsewhere yet.
839 Make "char" type a synonym for "char(1)" (actually implemented as bpchar)(Thomas)
840 Save string type if specified for DEFAULT clause handling(Thomas)
841 Coerce operations involving different data types(Thomas)
842 Allow some index use for columns of different types(Thomas)
843 Add capabilities for automatic type conversion(Thomas)
844 Cleanups for large objects, so file is truncated on open(Peter)
845 Readline cleanups(Tom)
846 Allow psql  \f \ to make spaces as delimiter(Bruce)
847 Pass pg_attribute.atttypmod to the frontend for column field lengths(Tom,Bruce)
848 Msql compatibility library in /contrib(Aldrin)
849 Remove the requirement that ORDER/GROUP BY clause identifiers be 
850 included in the target list(David)
851 Convert columns to match columns in UNION clauses(Thomas)
852 Remove fork()/exec() and only do fork()(Bruce)
853 Jdbc cleanups(Peter)
854 Show backend status on ps command line(only works on some platforms)(Bruce)
855 Pg_hba.conf now has a sameuser option in the database field
856 Make lo_unlink take oid param, not int4
857 New DISABLE_COMPLEX_MACRO for compilers that can't handle our macros(Bruce)
858 Libpgtcl now handles NOTIFY as a Tcl event, need not send dummy queries(Tom)
859 libpgtcl cleanups(Tom)
860 Add -error option to libpgtcl's pg_result command(Tom)
861 New locale patch, see docs/README/locale(Oleg)
862 Fix for pg_dump so CONSTRAINT and CHECK syntax is correct(ccb)
863 New contrib/lo code for large object orphan removal(Peter)
864 New psql command "SET CLIENT_ENCODING TO 'encoding'" for multi-bytes
865 feature, see /doc/README.mb(Tatsuo)
866 /contrib/noupdate code to revoke update permission on a column
867 Libpq can now be compiled on win32(Magnus)
868 Add PQsetdbLogin() in libpq
869 New 8-byte integer type, checked by configure for OS support(Thomas)
870 Better support for quoted table/column names(Thomas)
871 Surround table and column names with double-quotes in pg_dump(Thomas)
872 PQreset() now works with passwords(Tom)
873 Handle case of GROUP BY target list column number out of range(David)
874 Allow UNION in subselects
875 Add auto-size to screen to \d? commands(Bruce)
876 Use UNION to show all \d? results in one query(Bruce)
877 Add \d? field search feature(Bruce)
878 Pg_dump issues fewer \connect requests(Tom)
879 Make pg_dump -z flag work better, document it in manual page(Tom)
880 Add HAVING clause with full support for subselects and unions(Stephan)
881 Full text indexing routines in contrib/fulltextindex(Maarten)
882 Transaction ids now stored in shared memory(Vadim)
883 New PGCLIENTENCODING when issuing COPY command(Tatsuo)
884 Support for SQL92 syntax "SET NAMES"(Tatsuo)
885 Support for LATIN2-5(Tatsuo)
886 Add UNICODE regression test case(Tatsuo)
887 Lock manager cleanup, new locking modes for LLL(Vadim)
888 Allow index use with OR clauses(Bruce)
889 Allows "SELECT NULL ORDER BY 1;"
890 Explain VERBOSE prints the plan, and now pretty-prints the plan to
891 the postmaster log file(Bruce)
892 Add Indices display to \d command(Bruce)
893 Allow GROUP BY on functions(David)
894 New pg_class.relkind for large objects(Bruce)
895 New way to send libpq NOTICE messages to a different location(Tom)
896 New \w write command to psql(Bruce)
897 New /contrib/findoidjoins scans oid columns to find join relationships(Bruce)
898 Allow binary-compatible indices to be considered when checking for valid
899 indices for restriction clauses containing a constant(Thomas)
900 New ISBN/ISSN code in /contrib/isbn_issn
901 Allow NOT LIKE, IN, NOT IN, BETWEEN, and NOT BETWEEN constraint(Thomas)
902 New rewrite system fixes many problems with rules and views(Jan)
903         * Rules on relations work
904         * Event qualifications on insert/update/delete work
905         * New OLD variable to reference CURRENT, CURRENT will be remove in future
906         * Update rules can reference NEW and OLD in rule qualifications/actions
907         * Insert/update/delete rules on views work
908         * Multiple rule actions are now supported, surrounded by parentheses
909         * Regular users can create views/rules on tables they have RULE permits
910         * Rules and views inherit the permissions on the creator
911         * No rules at the column level
912         * No UPDATE NEW/OLD rules
913         * New pg_tables, pg_indexes, pg_rules and pg_views system views
914         * Only a single action on SELECT rules
915         * Total rewrite overhaul, perhaps for 6.5
916         * handle subselects
917         * handle aggregates on views
918         * handle insert into select from view works
919 System indexes are now multi-key(Bruce)
920 Oidint2, oidint4, and oidname types are removed(Bruce)
921 Use system cache for more system table lookups(Bruce)
922 New backend programming language PL/pgSQL in backend/pl(Jan)
923 New SERIAL data type, auto-creates sequence/index(Thomas)
924 Enable assert checking without a recompile(Massimo)
925 User lock enhancements(Massimo)
926 New setval() command to set sequence value(Massimo)
927 Auto-remove unix socket file on startup if no postmaster running(Massimo)
928 Conditional trace package(Massimo)
929 New UNLISTEN command(Massimo)
930 Psql and libpq now compile under win32 using win32.mak(Magnus)
931 Lo_read no longer stores trailing NULL(Bruce)
932 Identifiers are now truncated to 31 characters internally(Bruce)
933 Createuser options now availble on the command line
934 Code for 64-bit integer supported added, configure tested, int8 type(Thomas)
935 Prevent file descriptor leaf from failed COPY(Bruce)
936 New pg_upgrade command(Bruce)
937 Updated /contrib directories(Massimo)
938 New CREATE TABLE DEFAULT VALUES statement available(Thomas)
939 New INSERT INTO TABLE DEFAULT VALUES statement available(Thomas)
940 New DECLARE and FETCH feature(Thomas)
941 libpq's internal structures now not exported(Tom)
942 Allow up to 8 key indexes(Bruce)
943 Remove ARCHIVE keyword, that is no longer used(Thomas)
944 pg_dump -n flag to supress quotes around indentifiers
945 disable system columns for views(Jan)
946 new INET and CIDR types for network addresses(TomH, Paul)
947 no more double quotes in psql output
948 pg_dump now dumps views(Terry)
949 new SET QUERY_LIMIT(Tatsuo,Jan)
950
951 Source Tree Changes
952 -------------------
953 /contrib cleanup(Jun)
954 Inline some small functions called for every row(Bruce)
955 Alpha/linux fixes
956 Hp/UX cleanups(Tom)
957 Multi-byte regression tests(Soonmyung.)
958 Remove --disabled options from configure
959 Define PGDOC to use POSTGRESDIR by default
960 Make regression optional
961 Remove extra braces code to pgindent(Bruce)
962 Add bsdi shared library support(Bruce)
963 New --without-CXX support configure option(Brook)
964 New FAQ_CVS
965 Update backend flowchart in tools/backend(Bruce)
966 Change atttypmod from int16 to int32(Bruce, Tom)
967 Getrusage() fix for platforms that do not have it(Tom)
968 Add PQconnectdb, PGUSER, PGPASSWORD to libpq man page
969 NS32K platform fixes(Phil Nelson, John Buller)
970 Sco 7/UnixWare 2.x fixes(Billy,others)
971 Sparc/Solaris 2.5 fixes(Ryan)
972 Pgbuiltin.3 is obsolete, move to doc files(Thomas)
973 Even more documention(Thomas)
974 Nextstep support(Jacek)
975 Aix support(David)
976 pginterface manual page(Bruce)
977 shared libraries all have version numbers
978 merged all OS-specific shared library defines into one file
979 smarter TCL/TK configuration checking(Billy)
980 smarter perl configuration(Brook)
981 configure uses supplied install-sh if no install script found(Tom)
982 new Makefile.shlib for shared library configuration(Tom)
983 </programlisting>
984 </para>
985 </sect2>
986 </sect1>
987
988 <sect1>
989 <title>Release 6.3.2</title>
990 <!--
991 <docinfo>
992 <authorgroup>
993 <author>
994 <firstname>Bruce</firstname>
995 <surname>Momjian</surname>
996 </author>
997 </authorgroup>
998 <date>Tue Apr  7 16:53:16 EDT 1998</date>
999 </docinfo>
1000 -->
1001
1002 <para>
1003 This is a bugfix release for 6.3.x.
1004 Refer to the release notes for v6.3 for a more complete summary of new features.
1005 </para>
1006 <para>
1007 Summary:
1008
1009 <itemizedlist>
1010 <listitem>
1011 <para>
1012 Repairs automatic configuration support for some platforms, including Linux,
1013 from breakage inadvertently introduced in v6.3.1.
1014 </para>
1015 </listitem>
1016
1017 <listitem>
1018 <para>
1019 Correctly handles function calls on the left side of BETWEEN and LIKE clauses.
1020 </para>
1021 </listitem>
1022
1023 </itemizedlist>
1024 </para>
1025 <para>
1026 A dump/restore is NOT required for those running 6.3 or 6.3.1.  A 
1027 'make distclean', 'make', and 'make install' is all that is required.
1028 This last step should be performed while the postmaster is not running.
1029 You should re-link any custom applications that use <productname>Postgres</productname> libraries.
1030 </para>
1031 <para>
1032 For upgrades from pre-v6.3 installations,
1033 refer to the installation and migration instructions for v6.3.
1034 </para>
1035
1036 <sect2>
1037 <title>Detailed Change List</title>
1038
1039 <para>
1040 <programlisting>
1041 Changes
1042 -------
1043 Configure detection improvements for tcl/tk(Brook Milligan, Alvin)
1044 Manual page improvements(Bruce)
1045 BETWEEN and LIKE fix(Thomas)
1046 fix for psql \connect used by pg_dump(Oliver Elphick)
1047 New odbc driver
1048 pgaccess, version 0.86
1049 qsort removed, now uses libc version, cleanups(Jeroen)
1050 fix for buffer over-runs detected(Maurice Gittens)
1051 fix for buffer overrun in libpgtcl(Randy Kunkee)
1052 fix for UNION with DISTINCT or ORDER BY(Bruce)
1053 gettimeofday configure check(Doug Winterburn)
1054 Fix "indexes not used" bug(Vadim)
1055 docs additions(Thomas)
1056 Fix for backend memory leak(Bruce)
1057 libreadline cleanup(Erwan MAS)
1058 Remove DISTDIR(Bruce)
1059 Makefile dependency cleanup(Jeroen van Vianen)
1060 ASSERT fixes(Bruce)
1061 </programlisting>
1062 </para>
1063 </sect2>
1064 </sect1>
1065 <sect1>
1066 <title>Release 6.3.1</title>
1067 <!--
1068 <docinfo>
1069 <authorgroup>
1070 <author>
1071 <firstname>Bruce</firstname>
1072 <surname>Momjian</surname>
1073 </author>
1074 </authorgroup>
1075 <date>
1076 Mon Mar 23 10:21:52 EST 1998
1077 </date>
1078 </docinfo>
1079 -->
1080
1081 <para>
1082 Summary:
1083
1084 <itemizedlist>
1085 <listitem>
1086 <para>
1087 Additional support for multi-byte character sets.
1088 </para>
1089 </listitem>
1090
1091 <listitem>
1092 <para>
1093 Repair byte ordering for mixed-endian clients and servers.
1094 </para>
1095 </listitem>
1096
1097 <listitem>
1098 <para>
1099 Minor updates to allowed SQL syntax.
1100 </para>
1101 </listitem>
1102
1103 <listitem>
1104 <para>
1105 Improvements to the configuration autodetection for installation.
1106 </para>
1107 </listitem>
1108
1109 </itemizedlist>
1110 </para>
1111 <para>
1112 A dump/restore is NOT required for those running 6.3.  A 
1113 'make distclean', 'make', and 'make install' is all that is required.
1114 This last step should be performed while the postmaster is not running.
1115 You should re-link any custom applications that use <productname>Postgres</productname> libraries.
1116 </para>
1117 <para>
1118 For upgrades from pre-v6.3 installations,
1119 refer to the installation and migration instructions for v6.3.
1120 </para>
1121
1122 <sect2>
1123 <title>Detailed Change List</title>
1124
1125 <para>
1126 <programlisting>
1127 Changes
1128 -------
1129 ecpg cleanup/fixes, now version 1.1(Michael Meskes)
1130 pg_user cleanup(Bruce)
1131 large object fix for pg_dump and tclsh (alvin)
1132 LIKE fix for multiple adjacent underscores
1133 fix for redefining builtin functions(Thomas)
1134 ultrix4 cleanup
1135 upgrade to pg_access 0.83
1136 updated CLUSTER manual page
1137 multi-byte character set support, see doc/README.mb(Tatsuo)
1138 configure --with-pgport fix
1139 pg_ident fix
1140 big-endian fix for backend communications(Kataoka)
1141 SUBSTR() and substring() fix(Jan)
1142 several jdbc fixes(Peter)
1143 libpgtcl improvements, see libptcl/README(Randy Kunkee)
1144 Fix for "Datasize = 0" error(Vadim)
1145 Prevent \do from wrapping(Bruce)
1146 Remove duplicate Russian character set entries
1147 Sunos4 cleanup
1148 Allow optional TABLE keyword in LOCK and SELECT INTO(Thomas)
1149 CREATE SEQUENCE options to allow a negative integer(Thomas)
1150 Add "PASSWORD" as an allowed column identifier(Thomas)
1151 Add checks for UNION target fields(Bruce)
1152 Fix Alpha port(Dwayne Bailey)
1153 Fix for text arrays containing quotes(Doug Gibson)
1154 Solaris compile fix(Albert Chin-A-Young)
1155 Better identify tcl and tk libs and includes(Bruce)
1156 </programlisting>
1157 </para>
1158 </sect2>
1159 </sect1>
1160 <sect1>
1161 <title>Release 6.3</title>
1162 <!--
1163 <docinfo>
1164 <authorgroup>
1165 <author>
1166 <firstname>Bruce</firstname>
1167 <surname>Momjian</surname>
1168 </author>
1169 </authorgroup>
1170 <date>
1171 Sun Mar  1 14:57:30 EST 1998
1172 </date>
1173 </docinfo>
1174 -->
1175
1176 <para>
1177 There are <emphasis>many</emphasis> new features and improvements in this release.
1178 Here is a brief, incomplete summary:
1179
1180 <itemizedlist>
1181 <listitem>
1182 <para>
1183 Many new SQL features, including
1184 full <acronym>SQL92</acronym> subselect capability
1185 (everything is here but target-list subselects).
1186 </para>
1187 </listitem>
1188
1189 <listitem>
1190 <para>
1191 Support for client-side environment variables to specify time zone and date style.
1192 </para>
1193 </listitem>
1194
1195 <listitem>
1196 <para>
1197 Socket interface for client/server connection. This is the default now
1198 so you may need to start <application>postmaster</application> with the
1199 <quote>-i</quote> flag.
1200 </para>
1201 </listitem>
1202
1203 <listitem>
1204 <para>
1205 Better password authorization mechanisms. Default table permissions have changed.
1206 </para>
1207 </listitem>
1208
1209 <listitem>
1210 <para>
1211 Old-style <quote>time travel</quote> has been removed. Performance has been improved.
1212 </para>
1213 </listitem>
1214
1215 </itemizedlist>
1216 </para>
1217
1218 <note>
1219 <para>
1220 Bruce Momjian wrote the following notes to introduce the new release.
1221 </para>
1222 </note>
1223
1224 <para>
1225 There are some general 6.3 issues that I want to mention.  These are
1226 only the big items that can not be described in one sentence.  A review
1227 of the detailed changes list is still needed.
1228 </para>
1229 <para>
1230 First, we now have subselects.  Now that we have them, I would like to
1231 mention that without subselects, SQL is a very limited language.
1232 Subselects are a major feature, and you should review your code for
1233 places where subselects provide a better solution for your queries.  I
1234 think you will find that there are more uses for subselects than you may
1235 think.  Vadim has put us on the big SQL map with subselects, and fully
1236 functional ones too.  The only thing you can't do with subselects is to
1237 use them in the target list.
1238 </para>
1239 <para>
1240 Second, 6.3 uses unix domain sockets rather than TCP/IP by default.  To
1241 enable connections from other machines, you have to use the new
1242 postmaster -i option, and of course edit pg_hba.conf.  Also, for this
1243 reason, the format of pg_hba.conf has changed.
1244 </para>
1245 <para>
1246 Third, char() fields will now allow faster access than varchar() or
1247 text. Specifically, the text and varchar() have a penalty for access to
1248 any columns after the first column of this type.  char() used to also
1249 have this access penalty, but it no longer does.  This may suggest that
1250 you redesign some of your tables, especially if you have short character
1251 columns that you have defined as varchar() or text.  This and other
1252 changes make 6.3 even faster than earlier releases.
1253 </para>
1254 <para>
1255 We now have passwords definable independent of any Unix file.  There are
1256 new SQL USER commands.  See the pg_hba.conf manual page for more
1257 information.  There is a new table, pg_shadow, which is used to store
1258 user information and user passwords, and it by default only SELECT-able
1259 by the postgres super-user.  pg_user is now a view of pg_shadow, and is
1260 SELECT-able by PUBLIC.  You should keep using pg_user in your
1261 application without changes.
1262 </para>
1263 <para>
1264 User-created tables now no longer have SELECT permission to PUBLIC by
1265 default.  This was done because the ANSI standard requires it.  You can
1266 of course GRANT any permissions you want after the table is created. 
1267 System tables continue to be SELECT-able by PUBLIC.
1268 </para>
1269 <para>
1270 We also have real deadlock detection code.  No more sixty-second
1271 timeouts.  And the new locking code implements a FIFO better, so there
1272 should be less resource starvation during heavy use.
1273 </para>
1274 <para>
1275 Many complaints have been made about inadequate documenation in previous
1276 releases.  Thomas has put much effort into many new manuals for this
1277 release.  Check out the doc/ directory.
1278 </para>
1279 <para>
1280 For performance reasons, time travel is gone, but can be implemented
1281 using triggers (see pgsql/contrib/spi/README).  Please check out the new
1282 \d command for types, operators, etc.  Also, views have their own
1283 permissions now, not based on the underlying tables, so permissions on
1284 them have to be set separately.  Check /pgsql/interfaces for some new
1285 ways to talk to <productname>Postgres</productname>.
1286 </para>
1287 <para>
1288 This is the first release that really required an explanation for
1289 existing users.  In many ways, this was necessary because the new
1290 release removes many limitations, and the work-arounds people were using
1291 are no longer needed.
1292 </para>
1293
1294 <sect2>
1295 <title>Migration to v6.3</title>
1296
1297 <para>
1298 A dump/restore using <application>pg_dump</application> 
1299 or <application>pg_dumpall</application>
1300 is required for those wishing to migrate data from any
1301 previous release of <productname>Postgres</productname>.
1302 </para>
1303 </sect2>
1304
1305 <sect2>
1306 <title>Detailed Change List</title>
1307
1308 <para>
1309 <programlisting>
1310 Bug Fixes
1311 ---------
1312 Fix binary cursors broken by MOVE implementation(Vadim)
1313 Fix for tcl library crash(Jan)
1314 Fix for array handling, from Gerhard Hintermayer
1315 Fix acl error, and remove duplicate pqtrace(Bruce)
1316 Fix psql \e for empty file(Bruce)
1317 Fix for textcat on varchar() fields(Bruce)
1318 Fix for DBT Sendproc (Zeugswetter Andres)
1319 Fix vacuum analyze syntax problem(Bruce)
1320 Fix for international identifiers(Tatsuo)
1321 Fix aggregates on inherited tables(Bruce)
1322 Fix substr() for out-of-bounds data
1323 Fix for select 1=1 or 2=2, select 1=1 and 2=2, and select sum(2+2)(Bruce)
1324 Fix notty output to show status result.  -q option still turns it off(Bruce)
1325 Fix for count(*), aggs with views and multiple tables and sum(3)(Bruce)
1326 Fix cluster(Bruce)
1327 Fix for PQtrace start/stop several times(Bruce)
1328 Fix a variety of locking problems like newer lock waiters getting
1329         lock before older waiters, and having readlock people not share
1330         locks if a writer is waiting for a lock, and waiting writers not
1331         getting priority over waiting readers(Bruce)
1332 Fix crashes in psql when executing queries from external files(James)
1333 Fix problem with multiple order by columns, with the first one having
1334         NULL values(Jeroen)
1335 Use correct hash table support functions for float8 and int4(Thomas)
1336 Re-enable JOIN= option in CREATE OPERATOR statement (Thomas)
1337 Change precedence for boolean operators to match expected behavior(Thomas)
1338 Generate elog(ERROR) on over-large integer(Bruce)
1339 Allow multiple-argument functions in constraint clauses(Thomas)
1340 Check boolean input literals for 'true','false','yes','no','1','0'
1341         and throw elog(ERROR) if unrecognized(Thomas)
1342 Major large objects fix
1343 Fix for GROUP BY showing duplicates(Vadim)
1344 Fix for index scans in MergeJion(Vadim)
1345
1346 Enhancements
1347 ------------
1348 Subselects with EXISTS, IN, ALL, ANY keywords (Vadim, Bruce, Thomas)
1349 New User Manual(Thomas, others)
1350 Speedup by inlining some frequently-called functions
1351 Real deadlock detection, no more timeouts(Bruce)
1352 Add SQL92 "constants" CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, 
1353         CURRENT_USER(Thomas)
1354 Modify constraint syntax to be SQL92-compliant(Thomas)
1355 Implement SQL92 PRIMARY KEY and UNIQUE clauses using indices(Thomas)
1356 Recognize SQL92 syntax for FOREIGN KEY. Throw elog notice(Thomas)
1357 Allow NOT NULL UNIQUE constraint clause (each allowed separately before)(Thomas)
1358 Allow Postgres-style casting ("::") of non-constants(Thomas)
1359 Add support for SQL3 TRUE and FALSE boolean constants(Thomas)
1360 Support SQL92 syntax for IS TRUE/IS FALSE/IS NOT TRUE/IS NOT FALSE(Thomas)
1361 Allow shorter strings for boolean literals (e.g. "t", "tr", "tru")(Thomas)
1362 Allow SQL92 delimited identifiers(Thomas)
1363 Implement SQL92 binary and hexadecimal string decoding (b'10' and x'1F')(Thomas)
1364 Support SQL92 syntax for type coercion of literal strings
1365         (e.g. "DATETIME 'now'")(Thomas)
1366 Add conversions for int2, int4, and OID types to and from text(Thomas)
1367 Use shared lock when building indices(Vadim)
1368 Free memory allocated for an user query inside transaction block after
1369         this query is done, was turned off in <= 6.2.1(Vadim)
1370 New SQL statement CREATE PROCEDURAL LANGUAGE(Jan)
1371 New <productname>Postgres</productname> Procedural Language (PL) backend interface(Jan)
1372 Rename pg_dump -H option to -h(Bruce)
1373 Add Java support for passwords, European dates(Peter)
1374 Use indices for LIKE and ~, !~ operations(Bruce)
1375 Add hash functions for datetime and timespan(Thomas)
1376 Time Travel removed(Vadim, Bruce)
1377 Add paging for \d and \z, and fix \i(Bruce)
1378 Add Unix domain socket support to backend and to frontend library(Goran)
1379 Implement CREATE DATABASE/WITH LOCATION and initlocation utility(Thomas)
1380 Allow more SQL92 and/or <productname>Postgres</productname> reserved words as column identifiers(Thomas)
1381 Augment support for SQL92 SET TIME ZONE...(Thomas)
1382 SET/SHOW/RESET TIME ZONE uses TZ backend environment variable(Thomas)
1383 Implement SET keyword = DEFAULT and SET TIME ZONE DEFAULT(Thomas)
1384 Enable SET TIME ZONE using TZ environment variable(Thomas)
1385 Add PGDATESTYLE environment variable to frontend and backend initialization(Thomas)
1386 Add PGTZ, PGCOSTHEAP, PGCOSTINDEX, PGRPLANS, PGGEQO
1387         frontend library initialization environment variables(Thomas)
1388 Regression tests time zone automatically set with "setenv PGTZ PST8PDT"(Thomas)
1389 Add pg_description table for info on tables, columns, operators, types, and
1390         aggregates(Bruce)
1391 Increase 16 char limit on system table/index names to 32 characters(Bruce)
1392 Rename system indices(Bruce)
1393 Add 'GERMAN' option to SET DATESTYLE(Thomas)
1394 Define an "ISO-style" timespan output format with "hh:mm:ss" fields(Thomas)
1395 Allow fractional values for delta times (e.g. '2.5 days')(Thomas)
1396 Validate numeric input more carefully for delta times(Thomas)
1397 Implement day of year as possible input to date_part()(Thomas)
1398 Define timespan_finite() and text_timespan() functions(Thomas)
1399 Remove archive stuff(Bruce)
1400 Allow for a pg_password authentication database that is separate from
1401         the system password file(Todd)
1402 Dump ACLs, GRANT, REVOKE permissions(Matt)
1403 Define text, varchar, and bpchar string length functions(Thomas)
1404 Fix Query handling for inheritance, and cost computations(Bruce)
1405 Implement CREATE TABLE/AS SELECT (alternative to SELECT/INTO)(Thomas)
1406 Allow NOT, IS NULL, IS NOT NULL in constraints(Thomas)
1407 Implement UNIONs for SELECT(Bruce)
1408 Add UNION, GROUP, DISTINCT to INSERT(Bruce)
1409 varchar() stores only necessary bytes on disk(Bruce)
1410 Fix for BLOBs(Peter)
1411 Mega-Patch for JDBC...see README_6.3 for list of changes(Peter)
1412 Remove unused "option" from PQconnectdb()
1413 New LOCK command and lock manual page describing deadlocks(Bruce)
1414 Add new psql \da, \dd, \df, \do, \dS, and \dT commands(Bruce)
1415 Enhance psql \z to show sequences(Bruce)
1416 Show NOT NULL and DEFAULT in psql \d table(Bruce)
1417 New psql .psqlrc file startup(Andrew)
1418 Modify sample startup script in contrib/linux to show syslog(Thomas)
1419 New types for IP and MAC addresses in contrib/ip_and_mac(TomH)
1420 Unix system time conversions with date/time types in contrib/unixdate(Thomas)
1421 Update of contrib stuff(Massimo)
1422 Add Unix socket support to DBD::Pg(Goran)
1423 New python interface (PyGreSQL 2.0)(D'Arcy)
1424 New frontend/backend protocol has a version number, network byte order(Phil)
1425 Security features in pg_hba.conf enhanced and documented, many cleanups(Phil)
1426 CHAR() now faster access than VARCHAR() or TEXT
1427 ecpg embedded SQL preprocessor
1428 Reduce system column overhead(Vadmin)
1429 Remove pg_time table(Vadim)
1430 Add pg_type attribute to identify types that need length (bpchar, varchar)
1431 Add report of offending line when COPY command fails
1432 Allow VIEW permissions to be set separately from the underlying tables. 
1433         For security, use GRANT/REVOKE on views as appropriate(Jan)
1434 Tables now have no default GRANT SELECT TO PUBLIC.  You must
1435         explicitly grant such permissions.
1436 Clean up tutorial examples(Darren)
1437
1438 Source Tree Changes
1439 -------------------
1440 Add new html development tools, and flow chart in /tools/backend
1441 Fix for SCO compiles
1442 Stratus computer port Robert Gillies
1443 Added support for shlib for BSD44_derived & i386_solaris
1444 Make configure more automated(Brook)
1445 Add script to check regression test results
1446 Break parser functions into smaller files, group together(Bruce)
1447 Rename heap_create to heap_create_and_catalog, rename heap_creatr
1448         to heap_create()(Bruce)
1449 Sparc/Linux patch for locking(TomS)
1450 Remove PORTNAME and reorganize port-specific stuff(Marc)
1451 Add optimizer README file(Bruce)
1452 Remove some recursion in optimizer and clean up some code there(Bruce)
1453 Fix for NetBSD locking(Henry)
1454 Fix for libptcl make(Tatsuo)
1455 AIX patch(Darren)
1456 Change IS TRUE, IS FALSE, ... to expressions using "=" rather than
1457         function calls to istrue() or isfalse() to allow optimization(Thomas)
1458 Various fixes NetBSD/Sparc related(TomH)
1459 Alpha linux locking(Travis,Ryan)
1460 Change elog(WARN) to elog(ERROR)(Bruce)
1461 FAQ for FreeBSD(Marc)
1462 Bring in the PostODBC source tree as part of our standard distribution(Marc)
1463 A minor patch for HP/UX 10 vs 9(Stan)
1464 New pg_attribute.atttypmod for type-specific info like varchar length(Bruce)
1465 Unixware patches(Billy)
1466 New i386 'lock' for spin lock asm(Billy)
1467 Support for multiplexed backends is removed
1468 Start an OpenBSD port
1469 Start an AUX port
1470 Start a Cygnus port
1471 Add string functions to regression suite(Thomas)
1472 Expand a few function names formerly truncated to 16 characters(Thomas)
1473 Remove un-needed malloc() calls and replace with palloc()(Bruce)
1474 </programlisting>
1475 </para>
1476 </sect2>
1477 </sect1>
1478
1479 <sect1>
1480 <title>Release 6.2.1</title>
1481 <!--
1482 <docinfo>
1483 <authorgroup>
1484 <author>
1485 <firstname>Bruce</firstname>
1486 <surname>Momjian</surname>
1487 </author>
1488 </authorgroup>
1489 <date>
1490 Fri Oct 17 00:01:27 EDT 1997
1491 </date>
1492 </docinfo>
1493 -->
1494
1495 <para>
1496 v6.2.1 is a bug-fix and usability release on v6.2.
1497 </para>
1498 <para>
1499 Summary:
1500
1501 <itemizedlist>
1502 <listitem>
1503 <para>
1504 Allow strings to span lines, per <acronym>SQL92</acronym>.
1505 </para>
1506 </listitem>
1507
1508 <listitem>
1509 <para>
1510 Include example trigger function for inserting user names on table updates.
1511 </para>
1512 </listitem>
1513
1514 </itemizedlist>
1515 </para>
1516 <para>
1517 This is a minor bug-fix release on v6.2. 
1518 For upgrades from pre-v6.2 systems, a full dump/reload is required. 
1519 Refer to the v6.2 release notes for instructions.
1520 </para>
1521
1522 <sect2>
1523 <title>Migration from v6.2 to v6.2.1</title>
1524
1525 <para>
1526 This is a minor bug-fix release. A dump/reload is not required from v6.2,
1527 but is required from any release prior to v6.2.
1528 </para>
1529 <para>
1530 In upgrading from v6.2, if you choose to dump/reload you will find that
1531 avg(money) is now calculated correctly. All other bug fixes take effect
1532 upon updating the executables.
1533 </para>
1534 <para>
1535 Another way to avoid dump/reload is to use the following SQL command
1536 from psql to update the existing system table:
1537
1538 <programlisting>
1539   update pg_aggregate set aggfinalfn = 'cash_div_flt8'
1540    where aggname = 'avg' and aggbasetype = 790;
1541 </programlisting>
1542 </para>
1543 <para>
1544 This will need to be done to every existing database, including template1.
1545 </para>
1546 </sect2>
1547 <sect2>
1548 <title>Detailed Change List</title>
1549
1550 <para>
1551 <programlisting>
1552 Changes in this release
1553 -----------------------
1554 Allow TIME and TYPE column names(Thomas)
1555 Allow larger range of true/false as boolean values(Thomas)
1556 Support output of "now" and "current"(Thomas)
1557 Handle DEFAULT with INSERT of NULL properly(Vadim)
1558 Fix for relation reference counts problem in buffer manager(Vadim)
1559 Allow strings to span lines, like ANSI(Thomas)
1560 Fix for backward cursor with ORDER BY(Vadim)
1561 Fix avg(cash) computation(Thomas)
1562 Fix for specifying a column twice in ORDER/GROUP BY(Vadim)
1563 Documented new libpq function to return affected rows, PQcmdTuples(Bruce)
1564 Trigger function for inserting user names for INSERT/UPDATE(Brook Milligan)
1565 </programlisting>
1566 </para>
1567 </sect2>
1568 </sect1>
1569
1570 <sect1>
1571 <title>Release 6.2</title>
1572 <!--
1573 <docinfo>
1574 <authorgroup>
1575 <author>
1576 <firstname>Bruce</firstname>
1577 <surname>Momjian</surname>
1578 </author>
1579 </authorgroup>
1580 <date>
1581 Thu Oct 02 12:53:46 EDT 1997
1582 </date>
1583 </docinfo>
1584 -->
1585
1586 <para>
1587 A dump/restore is required for those wishing to migrate data from
1588 previous releases of <productname>Postgres</productname>.
1589 </para>
1590
1591 <sect2>
1592 <title>Migration from v6.1 to v6.2</title>
1593
1594 <para>
1595 This migration requires a complete dump of the 6.1 database and a
1596 restore of the database in 6.2.
1597 </para>
1598 <para>
1599 Note that the pg_dump and pg_dumpall utility from 6.2 should be used
1600 to dump the 6.1 database.
1601 </para>
1602 </sect2>
1603
1604 <sect2>
1605 <title>Migration from v1.x to v6.2</title>
1606
1607 <para>
1608 Those migrating from earlier 1.* releases should first upgrade to 1.09
1609 because the COPY output format was improved from the 1.02 release.
1610 </para>
1611 </sect2>
1612
1613 <sect2>
1614 <title>Detailed Change List</title>
1615
1616 <para>
1617 <programlisting>
1618 Bug Fixes
1619 ---------
1620 Fix problems with pg_dump for inheritance, sequences, archive tables(Bruce)
1621 Fix compile errors on overflow due to shifts, unsigned, and bad prototypes
1622          from Solaris(Diab Jerius)
1623 Fix bugs in geometric line arithmetic (bad intersection calculations)(Thomas)
1624 Check for geometric intersections at endpoints to avoid rounding ugliness(Thomas)
1625 Catch non-functional delete attempts(Vadim)
1626 Change time function names to be more consistent(Michael Reifenberg)
1627 Check for zero divides(Michael Reifenberg)
1628 Fix very old bug which made tuples changed/inserted by a commnd
1629         visible to the command itself (so we had multiple update of 
1630         updated tuples, etc)(Vadim)
1631 Fix for SELECT null, 'fail' FROM pg_am (Patrick)
1632 SELECT NULL as EMPTY_FIELD now allowed(Patrick)
1633 Remove un-needed signal stuff from contrib/pginterface
1634 Fix OR (where x != 1 or x isnull didn't return tuples with x NULL) (Vadim)
1635 Fix time_cmp function (Vadim)
1636 Fix handling of functions with non-attribute first argument in 
1637         WHERE clauses (Vadim)
1638 Fix GROUP BY when order of entries is different from order
1639         in target list (Vadim)
1640 Fix pg_dump for aggregates without sfunc1 (Vadim)
1641
1642 Enhancements
1643 ------------
1644 Default genetic optimizer GEQO parameter is now 8(Bruce)
1645 Allow use parameters in target list having aggregates in functions(Vadim)
1646 Added JDBC driver as an interface(Adrian & Peter)
1647 pg_password utility
1648 Return number of tuples inserted/affected by INSERT/UPDATE/DELETE etc.(Vadim)
1649 Triggers implemented with CREATE TRIGGER (SQL3)(Vadim)
1650 SPI (Server Programming Interface) allows execution of queries inside 
1651         C-functions (Vadim)
1652 NOT NULL implemented (SQL92)(Robson Paniago de Miranda)
1653 Include reserved words for string handling, outer joins, and unions(Thomas)
1654 Implement extended comments ("/* ... */") using exclusive states(Thomas)
1655 Add "//" single-line comments(Bruce)
1656 Remove some restrictions on characters in operator names(Thomas)
1657 DEFAULT and CONSTRAINT for tables implemented (SQL92)(Vadim & Thomas)
1658 Add text concatenation operator and function (SQL92)(Thomas)
1659 Support WITH TIME ZONE syntax (SQL92)(Thomas)
1660 Support INTERVAL unit TO unit syntax (SQL92)(Thomas)
1661 Define types DOUBLE PRECISION, INTERVAL, CHARACTER,
1662         and CHARACTER VARYING (SQL92)(Thomas)
1663 Define type FLOAT(p) and rudimentary DECIMAL(p,s), NUMERIC(p,s) (SQL92)(Thomas)
1664 Define EXTRACT(), POSITION(), SUBSTRING(), and TRIM() (SQL92)(Thomas)
1665 Define CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP (SQL92)(Thomas)
1666 Add syntax and warnings for UNION, HAVING, INNER and OUTER JOIN (SQL92)(Thomas)
1667 Add more reserved words, mostly for SQL92 compliance(Thomas)
1668 Allow hh:mm:ss time entry for timespan/reltime types(Thomas)
1669 Add center() routines for lseg, path, polygon(Thomas)
1670 Add distance() routines for circle-polygon, polygon-polygon(Thomas)
1671 Check explicitly for points and polygons contained within polygons
1672         using an axis-crossing algorithm(Thomas)
1673 Add routine to convert circle-box(Thomas)
1674 Merge conflicting operators for different geometric data types(Thomas)
1675 Replace distance operator "<===>" with "<->"(Thomas)
1676 Replace "above" operator "!^" with ">^" and "below" operator "!|" with "<^"(Thomas)
1677 Add routines for text trimming on both ends, substring, and string position(Thomas)
1678 Added conversion routines circle(box) and poly(circle)(Thomas)
1679 Allow internal sorts to be stored in memory rather than in files(Bruce & Vadim)
1680 Allow functions and operators on internally-identical types to succeed(Bruce)
1681 Speed up backend startup after profiling analysis(Bruce)
1682 Inline frequently called functions for performance(Bruce)
1683 Reduce open() calls(Bruce)
1684 psql:  Add PAGER for \h and \?,\C fix
1685 Fix for psql pager when no tty(Bruce)
1686 New entab utility(Bruce)
1687 General trigger functions for referential integrity (Vadim)
1688 General trigger functions for time travel (Vadim)
1689 General trigger functions for AUTOINCREMENT/IDENTITY feature (Vadim)
1690 MOVE implementation (Vadim)
1691
1692 Source Tree Changes
1693 -------------------
1694 HPUX 10 patches (Vladimir Turin)
1695 Added SCO support, (Daniel Harris)
1696 mkLinux patches (Tatsuo Ishii)
1697 Change geometric box terminology from "length" to "width"(Thomas)
1698 Deprecate temporary unstored slope fields in geometric code(Thomas)
1699 Remove restart instructions from INSTALL(Bruce)
1700 Look in /usr/ucb first for install(Bruce)
1701 Fix c++ copy example code(Thomas)
1702 Add -o to psql manual page(Bruce)
1703 Prevent relname unallocated string length from being copied into database(Bruce)
1704 Cleanup for NAMEDATALEN use(Bruce)
1705 Fix pg_proc names over 15 chars in output(Bruce)
1706 Add strNcpy() function(Bruce)
1707 remove some (void) casts that are unnecessary(Bruce)
1708 new interfaces directory(Marc)
1709 Replace fopen() calls with calls to fd.c functions(Bruce)
1710 Make functions static where possible(Bruce)
1711 enclose unused functions in #ifdef NOT_USED(Bruce)
1712 Remove call to difftime() in timestamp support to fix SunOS(Bruce & Thomas)
1713 Changes for Digital Unix
1714 Portability fix for pg_dumpall(Bruce)
1715 Rename pg_attribute.attnvals to attdisbursion(Bruce)
1716 "intro/unix" manual page now "pgintro"(Bruce)
1717 "built-in" manual page now "pgbuiltin"(Bruce)
1718 "drop" manual page now "drop_table"(Bruce)
1719 Add "create_trigger", "drop_trigger" manual pages(Thomas)
1720 Add constraints regression test(Vadim & Thomas)
1721 Add comments syntax regression test(Thomas)
1722 Add PGINDENT and support program(Bruce)
1723 Massive commit to run PGINDENT on all *.c and *.h files(Bruce)
1724 Files moved to /src/tools directory(Bruce)
1725 SPI and Trigger programming guides (Vadim & D'Arcy)
1726 </programlisting>
1727 </para>
1728 </sect2>
1729 </sect1>
1730
1731 <sect1>
1732 <title>Release 6.1.1</title>
1733 <!--
1734 <docinfo>
1735 <authorgroup>
1736 <author>
1737 <firstname>Bruce</firstname>
1738 <surname>Momjian</surname>
1739 </author>
1740 </authorgroup>
1741 <date>
1742 Mon Jul 22 18:04:49 EDT 1997
1743 </date>
1744 </docinfo>
1745 -->
1746
1747
1748 <sect2>
1749 <title>Migration from v6.1 to v6.1.1</title>
1750
1751 <para>
1752 This is a minor bug-fix release. A dump/reload is not required from v6.1,
1753 but is required from any release prior to v6.1.
1754 Refer to the release notes for v6.1 for more details.
1755 </para>
1756 </sect2>
1757
1758 <sect2>
1759 <title>Detailed Change List</title>
1760
1761 <para>
1762 <programlisting>
1763 Changes in this release
1764 -----------------------
1765 fix for SET with options (Thomas)
1766 allow pg_dump/pg_dumpall to preserve ownership of all tables/objects(Bruce)
1767 new psql \connect option allows changing usernames without changing databases
1768 fix for initdb --debug option(Yoshihiko Ichikawa))
1769 lextest cleanup(Bruce)
1770 hash fixes(Vadim)
1771 fix date/time month boundary arithmetic(Thomas)
1772 fix timezone daylight handling for some ports(Thomas, Bruce, Tatsuo)
1773 timestamp overhauled to use standard functions(Thomas)
1774 other code cleanup in date/time routines(Thomas)
1775 psql's \d now case-insensitive(Bruce)
1776 psql's backslash commands can now have trailing semicolon(Bruce)
1777 fix memory leak in psql when using \g(Bruce)
1778 major fix for endian handling of communication to server(Thomas, Tatsuo)
1779 Fix for Solaris assembler and include files(Yoshihiko Ichikawa)
1780 allow underscores in usernames(Bruce)
1781 pg_dumpall now returns proper status, portability fix(Bruce)
1782 </programlisting>
1783 </para>
1784 </sect2>
1785 </sect1>
1786
1787 <sect1>
1788 <title>Release 6.1</title>
1789 <!--
1790 <docinfo>
1791 <authorgroup>
1792 <author>
1793 <firstname>Bruce</firstname>
1794 <surname>Momjian</surname>
1795 </author>
1796 </authorgroup>
1797 <date>
1798 Sun Jun  8 14:41:13 EDT 1997
1799 </date>
1800 </docinfo>
1801 -->
1802
1803 <para>
1804   The regression tests have been adapted and extensively modified for the
1805   v6.1 release of <productname>Postgres</productname>.
1806 </para>
1807
1808 <para>
1809   Three new data types (datetime, timespan, and circle) have been added to
1810   the native set of <productname>Postgres</productname> types. Points, boxes, paths, and polygons
1811   have had their output formats made consistant across the data types.
1812   The polygon output in misc.out has only been spot-checked for correctness
1813   relative to the original regression output.
1814 </para>
1815
1816 <para>
1817   <productname>Postgres</productname> v6.1 introduces a new, alternate
1818 optimizer which uses <firstterm>genetic</firstterm>
1819   algorithms. These algorithms introduce a random behavior in the ordering
1820   of query results when the query contains multiple qualifiers or multiple
1821   tables (giving the optimizer a choice on order of evaluation). Several
1822   regression tests have been modified to explicitly order the results, and
1823   hence are insensitive to optimizer choices. A few regression tests are
1824   for data types which are inherently unordered (e.g. points and time
1825   intervals) and tests involving those types are explicitly bracketed with
1826   <command>set geqo to 'off'</command> and <command>reset geqo</command>.
1827 </para>
1828
1829 <para>
1830   The interpretation of array specifiers (the curly braces around atomic
1831   values) appears to have changed sometime after the original regression
1832   tests were generated. The current <filename>./expected/*.out</filename> files reflect this
1833   new interpretation, which may not be correct!
1834 </para>
1835
1836 <para>
1837   The float8 regression test fails on at least some platforms. This is due
1838   to differences in implementations of pow() and exp() and the signaling
1839   mechanisms used for overflow and underflow conditions.
1840 </para>
1841
1842 <para>
1843   The "random" results in the random test should cause the "random" test
1844   to be "failed", since the regression tests are evaluated using a simple
1845   diff. However, "random" does not seem to produce random results on my 
1846   test machine (Linux/gcc/i686).
1847 </para>
1848
1849 <sect2>
1850 <title>Migration to v6.1</title>
1851
1852 <para>
1853 This migration requires a complete dump of the 6.0 database and a
1854 restore of the database in 6.1.
1855 </para>
1856 <para>
1857 Those migrating from earlier 1.* releases should first upgrade to 1.09
1858 because the COPY output format was improved from the 1.02 release.
1859 </para>
1860 </sect2>
1861
1862 <sect2>
1863 <title>Detailed Change List</title>
1864
1865 <para>
1866 <programlisting>
1867 Bug Fixes
1868 ---------
1869 packet length checking in library routines
1870 lock manager priority patch
1871 check for under/over flow of float8(Bruce)
1872 multi-table join fix(Vadim)
1873 SIGPIPE crash fix(Darren)
1874 large object fixes(Sven)
1875 allow btree indexes to handle NULLs(Vadim)
1876 timezone fixes(D'Arcy)
1877 select SUM(x) can return NULL on no rows(Thomas)
1878 internal optimizer, executor bug fixes(Vadim)
1879 fix problem where inner loop in < or <= has no rows(Vadim)
1880 prevent re-commuting join index clauses(Vadim)
1881 fix join clauses for multiple tables(Vadim)
1882 fix hash, hashjoin for arrays(Vadim)
1883 fix btree for abstime type(Vadim)
1884 large object fixes(Raymond)
1885 fix buffer leak in hash indices (Vadim)
1886 fix rtree for use in inner scan (Vadim)
1887 fix gist for use in inner scan, cleanups (Vadim, Andrea)
1888 avoid unnecessary local buffers allocation (Vadim, Massimo)
1889 fix local buffers leak in transaction aborts (Vadim)
1890 fix file manager memmory leaks, cleanups (Vadim, Massimo)
1891 fix storage manager memmory leaks (Vadim)
1892 fix btree duplicates handling (Vadim)
1893 fix deleted tuples re-incarnation caused by vacuum (Vadim)
1894 fix SELECT varchar()/char() INTO TABLE made zero-length fields(Bruce)
1895 many psql, pg_dump, and libpq memory leaks fixed using Purify (Igor)
1896
1897 Enhancements
1898 ------------
1899 attribute optimization statistics(Bruce)
1900 much faster new btree bulk load code(Paul)
1901 BTREE UNIQUE added to bulk load code(Vadim) 
1902 new lock debug code(Massimo)
1903 massive changes to libpg++(Leo)
1904 new GEQO optimizer speeds table multi-table optimization(Martin)
1905 new WARN message for non-unique insert into unique key(Marc)
1906 update x=-3, no spaces, now valid(Bruce)
1907 remove case-sensitive identifier handling(Bruce,Thomas,Dan)
1908 debug backend now pretty-prints tree(Darren)
1909 new Oracle character functions(Edmund)
1910 new plaintext password functions(Dan)
1911 no such class or insufficient privilege changed to distinct messages(Dan)
1912 new ANSI timestamp function(Dan)
1913 new ANSI Time and Date types (Thomas)
1914 move large chunks of data in backend(Martin)
1915 multi-column btree indexes(Vadim)
1916 new SET var TO value command(Martin)
1917 update transaction status on reads(Dan)
1918 new locale settings for character types(Oleg)
1919 new SEQUENCE serial number generator(Vadim)
1920 GROUP BY function now possible(Vadim)
1921 re-organize regression test(Thomas,Marc)
1922 new optimizer operation weights(Vadim)
1923 new psql \z grant/permit option(Marc)
1924 new MONEY data type(D'Arcy,Thomas)
1925 tcp socket communication speed improved(Vadim)
1926 new VACUUM option for attribute statistics, and for certain columns (Vadim)
1927 many geometric type improvements(Thomas,Keith)
1928 additional regression tests(Thomas)
1929 new datestyle variable(Thomas,Vadim,Martin)
1930 more comparison operators for sorting types(Thomas)
1931 new conversion functions(Thomas)
1932 new more compact btree format(Vadim)
1933 allow pg_dumpall to preserve database ownership(Bruce)
1934 new SET GEQO=# and R_PLANS variable(Vadim)
1935 old (!GEQO) optimizer can use right-sided plans (Vadim)
1936 typechecking improvement in SQL parser(Bruce)
1937 new SET, SHOW, RESET commands(Thomas,Vadim)
1938 new \connect database USER option
1939 new destroydb -i option (Igor)
1940 new \dt and \di psql commands (Darren)
1941 SELECT "\n" now escapes newline (A. Duursma)
1942 new geometry conversion functions from old format (Thomas)
1943
1944 Source tree changes
1945 -------------------
1946 new configuration script(Marc)
1947 readline configuration option added(Marc)
1948 OS-specific configuration options removed(Marc)
1949 new OS-specific template files(Marc)
1950 no more need to edit Makefile.global(Marc)
1951 re-arrange include files(Marc)
1952 nextstep patches (Gregor Hoffleit)
1953 removed WIN32-specific code(Bruce)
1954 removed postmaster -e option, now only postgres -e option (Bruce)
1955 merge duplicate library code in front/backends(Martin)
1956 now works with eBones, international Kerberos(Jun)
1957 more shared library support
1958 c++ include file cleanup(Bruce)
1959 warn about buggy flex(Bruce)
1960 DG-UX, Ultrix, Irix, AIX portability fixes
1961 </programlisting>
1962 </para>
1963 </sect2>
1964 </sect1>
1965
1966 <sect1>
1967 <title>Release v6.0</title>
1968 <!--
1969 <docinfo>
1970 <authorgroup>
1971 <author>
1972 <firstname>Bruce</firstname>
1973 <surname>Momjian</surname>
1974 </author>
1975 </authorgroup>
1976 <date>
1977 Wed Jan 29 00:19:54 EST 1997
1978 </date>
1979 </docinfo>
1980 -->
1981
1982 <para>
1983 A dump/restore is required for those wishing to migrate data from
1984 previous releases of <productname>Postgres</productname>.
1985 </para>
1986
1987 <sect2>
1988 <title>Migration from v1.09 to v6.0</title>
1989
1990 <para>
1991 This migration requires a complete dump of the 1.09 database and a
1992 restore of the database in 6.0.
1993 </para>
1994 </sect2>
1995
1996 <sect2>
1997 <title>Migration from pre-v1.09 to v6.0</title>
1998
1999 <para>
2000 Those migrating from earlier 1.* releases should first upgrade to 1.09
2001 because the COPY output format was improved from the 1.02 release.
2002 </para>
2003 </sect2>
2004
2005 <sect2>
2006 <title>Detailed Change List</title>
2007
2008 <para>
2009 <programlisting>
2010 Bug Fixes
2011 ---------
2012 ALTER TABLE bug - running postgress process needs to re-read table definition
2013 Allow vacuum to be run on one table or entire database(Bruce)
2014 Array fixes
2015 Fix array over-runs of memory writes(Kurt)
2016 Fix elusive btree range/non-range bug(Dan)
2017 Fix for hash indexes on some types like time and date
2018 Fix for pg_log size explosion
2019 Fix permissions on lo_export()(Bruce)
2020 Fix unitialized reads of memory(Kurt)
2021 Fixed ALTER TABLE ... char(3) bug(Bruce)
2022 Fixed a few small memory leaks
2023 Fixed EXPLAIN handling of options and changed full_path option name
2024 Fixed output of group acl permissions
2025 Memory leaks (hunt and destroy with tools like Purify(Kurt)
2026 Minor improvements to rules system
2027 NOTIFY fixes
2028 New asserts for run-checking
2029 Overhauled parser/analyze code to properly report errors and increase speed
2030 Pg_dump -d now handles NULL's properly(Bruce)
2031 Prevent SELECT NULL from crashing server (Bruce)
2032 Properly report errors when INSERT ... SELECT columns did not match
2033 Properly report errors when insert column names were not correct
2034 Psql \g filename now works(Bruce)
2035 Psql fixed problem with multiple statements on one line with multiple outputs
2036 Removed duplicate system oid's
2037 SELECT * INTO TABLE . GROUP/ORDER BY gives unlink error if table exists(Bruce)
2038 Several fixes for queries that crashed the backend
2039 Starting quote in insert string errors(Bruce)
2040 Submitting an empty query now returns empty status, not just " " query(Bruce)
2041
2042 Enhancements
2043 ------------
2044 Add EXPLAIN manual page(Bruce)
2045 Add UNIQUE index capability(Dan)
2046 Add hostname/user level access control rather than just hostname and user
2047 Add synonym of != for &lt;&gt;(Bruce)
2048 Allow "select oid,* from table"
2049 Allow BY,ORDER BY to specify columns by number, or by non-alias table.column(Bruce)
2050 Allow COPY from the frontend(Bryan)
2051 Allow GROUP BY to use alias column name(Bruce)
2052 Allow actual compression, not just reuse on the same page(Vadim)
2053 Allow installation-configuration option to auto-add all local users(Bryan)
2054 Allow libpq to distinguish between text value '' and null(Bruce)
2055 Allow non-postgres users with createdb privs to destroydb's
2056 Allow restriction on who can create C functions(Bryan)
2057 Allow restriction on who can do backend COPY(Bryan)
2058 Can shrink tables, pg_time and pg_log(Vadim & Erich)
2059 Change debug level 2 to print queries only, changed debug heading layout(Bruce)
2060 Change default decimal constant representation from float4 to float8(Bruce)
2061 European date format now set when postmaster is started
2062 Execute lowercase function names if not found with exact case
2063 Fixes for aggregate/GROUP processing, allow 'select sum(func(x),sum(x+y) from z'
2064 Gist now included in the distrubution(Marc)
2065 Idend authentication of local users(Bryan)
2066 Implement BETWEEN qualifier(Bruce)
2067 Implement IN qualifier(Bruce)
2068 Libpq has PQgetisnull()(Bruce)
2069 Libpq++ improvements
2070 New options to initdb(Bryan)
2071 Pg_dump allow dump of oid's(Bruce)
2072 Pg_dump create indexes after tables are loaded for speed(Bruce)
2073 Pg_dumpall dumps all databases, and the user table
2074 Pginterface additions for NULL values(Bruce)
2075 Prevent postmaster from being run as root
2076 Psql \h and \? is now readable(Bruce)
2077 Psql allow backslashed, semicolons anywhere on the line(Bruce)
2078 Psql changed command prompt for lines in query or in quotes(Bruce)
2079 Psql char(3) now displays as (bp)char in \d output(Bruce)
2080 Psql return code now more accurate(Bryan?)
2081 Psql updated help syntax(Bruce)
2082 Re-visit and fix vacuum(Vadim)
2083 Reduce size of regression diffs, remove timezone name difference(Bruce)
2084 Remove compile-time parameters to enable binary distributions(Bryan)
2085 Reverse meaning of HBA masks(Bryan)
2086 Secure Authentication of local users(Bryan)
2087 Speed up vacuum(Vadim)
2088 Vacuum now had VERBOSE option(Bruce)
2089
2090 Source tree changes
2091 -------------------
2092 All functions now have prototypes that are compared against the calls
2093 Allow asserts to be disabled easly from Makefile.global(Bruce)
2094 Change oid constants used in code to #define names
2095 Decoupled sparc and solaris defines(Kurt)
2096 Gcc -Wall compiles cleanly with warnings only from unfixable constructs
2097 Major include file reorganization/reduction(Marc)
2098 Make now stops on compile failure(Bryan)
2099 Makefile restructuring(Bryan, Marc)
2100 Merge bsdi_2_1 to bsdi(Bruce)
2101 Monitor program removed
2102 Name change from Postgres95 to PostgreSQL
2103 New config.h file(Marc, Bryan)
2104 PG_VERSION now set to 6.0 and used by postmaster
2105 Portability additions, including Ultrix, DG/UX, AIX, and Solaris
2106 Reduced the number of #define's, centeralized #define's
2107 Remove duplicate OIDS in system tables(Dan)
2108 Remove duplicate system catalog info or report mismatches(Dan)
2109 Removed many os-specific #define's
2110 Restructured object file generation/location(Bryan, Marc)
2111 Restructured port-specific file locations(Bryan, Marc)
2112 Unused/uninialized variables corrected
2113 </programlisting>
2114 </para>
2115 </sect2>
2116 </sect1>
2117
2118 <sect1>
2119 <title>Release v1.09</title>
2120 <!--
2121 <docinfo>
2122 <authorgroup>
2123 <author>
2124 <firstname>Bruce</firstname>
2125 <surname>Momjian</surname>
2126 </author>
2127 </authorgroup>
2128 <date>
2129 Unknown
2130 </date>
2131 </docinfo>
2132 -->
2133
2134 <para>
2135 Sorry, we stopped keeping track of changes from 1.02 to 1.09.  Some of
2136 the changes listed in 6.0 were actually included in the 1.02.1 to 1.09
2137 releases.
2138 </para>
2139 </sect1>
2140
2141 <sect1>
2142 <title>Release v1.02</title>
2143 <!--
2144 <docinfo>
2145 <authorgroup>
2146 <author>
2147 <firstname>Bruce</firstname>
2148 <surname>Momjian</surname>
2149 </author>
2150 </authorgroup>
2151 <date>
2152 Thu Aug  1 18:00:00 EDT 1996
2153 </date>
2154 </docinfo>
2155 -->
2156
2157 <sect2>
2158 <title>Migration from v1.02 to v1.02.1</title>
2159
2160 <para>
2161 Here is a new migration file for 1.02.1.  It includes the 'copy' change
2162 and a script to convert old ascii files.
2163 </para>
2164 <note>
2165 <para>
2166 The following notes are for the benefit of users who want to migrate
2167 databases from postgres95 1.01 and 1.02 to postgres95 1.02.1.
2168 </para>
2169 <para>
2170 If you are starting afresh with postgres95 1.02.1 and do not need
2171 to migrate old databases, you do not need to read any further.
2172 </para>
2173 </note>
2174
2175 <para>
2176 In order to upgrade older postgres95 version 1.01 or 1.02 databases to
2177 version 1.02.1, the following steps are required:
2178 </para>
2179 <procedure>
2180 <step>
2181 <para>
2182 Start up a new 1.02.1 postmaster
2183 </para>
2184 </step>
2185 <step>
2186 <para>
2187 Add the new built-in functions and operators of 1.02.1 to 1.01 or 1.02
2188    databases.  This is done by running the new 1.02.1 server against
2189    your own 1.01 or 1.02 database and applying the queries attached at
2190    the end of thie file.   This can be done easily through psql.  If your
2191    1.01 or 1.02 database is named "testdb" and you have cut the commands
2192    from the end of this file and saved them in addfunc.sql:
2193 <programlisting>
2194         % psql testdb -f addfunc.sql
2195 </programlisting>
2196
2197 Those upgrading 1.02 databases will get a warning when executing the
2198 last two statements in the file because they are already present in 1.02.  This is
2199 not a cause for concern.
2200 </para>
2201 </step>
2202 </procedure>
2203 </sect2>
2204
2205 <sect2>
2206 <title>Dump/Reload Procedure</title>
2207
2208 <para>
2209 If you are trying to reload a pg_dump or text-mode 'copy tablename to
2210 stdout' generated with a previous version, you will need to run the
2211 attached sed script on the ASCII file before loading it into the
2212 database.  The old format used '.' as end-of-data, while '\.' is now the
2213 end-of-data marker.  Also, empty strings are now loaded in as '' rather
2214 than NULL. See the copy manual page for full details.
2215
2216 <programlisting>
2217         sed 's/^\.$/\\./g' &lt;in_file &gt;out_file
2218 </programlisting>
2219 </para>
2220 <para>
2221 If you are loading an older binary copy or non-stdout copy, there is no
2222 end-of-data character, and hence no conversion necessary.
2223
2224 <programlisting>
2225 -- following lines added by agc to reflect the case-insensitive
2226 -- regexp searching for varchar (in 1.02), and bpchar (in 1.02.1)
2227 create operator ~* (leftarg = bpchar, rightarg = text, procedure = texticregexeq);
2228 create operator !~* (leftarg = bpchar, rightarg = text, procedure = texticregexne);
2229 create operator ~* (leftarg = varchar, rightarg = text, procedure = texticregexeq);
2230 create operator !~* (leftarg = varchar, rightarg = text, procedure = texticregexne);
2231 </programlisting>
2232 </para>
2233 </sect2>
2234
2235 <sect2>
2236 <title>Detailed Change List</title>
2237
2238 <para>
2239 <programlisting>
2240 Source code maintenance and development
2241  * worldwide team of volunteers
2242  * the source tree now in CVS at ftp.ki.net
2243
2244 Enhancements
2245  * psql (and underlying libpq library) now has many more options for
2246    formatting output, including HTML
2247  * pg_dump now output the schema and/or the data, with many fixes to
2248    enhance completeness.
2249  * psql used in place of monitor in administration shell scripts.
2250    monitor to be depreciated in next release.
2251  * date/time functions enhanced
2252  * NULL insert/update/comparison fixed/enhanced
2253  * TCL/TK lib and shell fixed to work with both tck7.4/tk4.0 and tcl7.5/tk4.1
2254
2255 Bug Fixes (almost too numerous to mention)
2256  * indexes
2257  * storage management
2258  * check for NULL pointer before dereferencing
2259  * Makefile fixes
2260
2261 New Ports
2262  * added SolarisX86 port
2263  * added BSDI 2.1 port
2264  * added DGUX port
2265 </programlisting>
2266 </para>
2267 <!--
2268 Contributors (appologies to any missed)
2269  * Kurt J. Lidl <lidl@va.pubnix.com> 
2270         (missed in first run, but no less important)
2271  * Erich Stamberger <eberger@gewi.kfunigraz.ac.at>
2272  * Jason Wright <jason@shiloh.vnet.net>
2273  * Cees de Groot <C.deGroot@inter.NL.net>
2274  * ernst.molitor@uni-bonn.de
2275  * michael.siebenborn@ae3.Hypo.DE (Michael Siebenborn (6929))
2276  * Brian E. Gallew <geek+@cmu.edu>
2277  * Vadim B. Mikheev <vadim@sable.krasnoyarsk.su>
2278  * Adam Sussman <myddryn@vidya.com>
2279  * Chris Dunlop <chris@onthe.net.au>
2280  * Marc G. Fournier <scrappy@ki.net>
2281  * Dan McGuirk <mcguirk@indirect.com>
2282  * Dr_George_D_Detlefsen <drgeorge@ilt.com>
2283  * Erich Stamberger <eberger@gewi.kfunigraz.ac.at>
2284  * Massimo Dal Zotto <dz@cs.unitn.it>
2285  * Randy Kunkee <kunkee@Starbase.NeoSoft.COM>
2286  * Rick Weldon <rick@wisetech.com>
2287  * Thomas van Reimersdahl <reimersd@dali.techinfo.rwth-aachen.de>
2288  * david bennett <dave@bensoft.com>
2289  * ernst.molitor@uni-bonn.de
2290  * Julian Assange <proff@suburbia.net>
2291  * Bruce Momjian <maillist@candle.pha.pa.us>
2292  * Paul "Shag" Walmsley <ccshag@cclabs.missouri.edu>
2293  * "Alistair G. Crooks" <azcb0@sde.uts.amdahl.com>
2294 -->
2295 </sect2>
2296 </sect1>
2297
2298 <sect1>
2299 <title>Release v1.01</title>
2300 <!--
2301 <docinfo>
2302 <authorgroup>
2303 <author>
2304 <firstname>Bruce</firstname>
2305 <surname>Momjian</surname>
2306 </author>
2307 </authorgroup>
2308 <date>
2309 Fri Feb 23 18:20:36 PST 1996
2310 </date>
2311 </docinfo>
2312 -->
2313
2314 <sect2>
2315 <title>Migration from v1.0 to v1.01</title>
2316
2317 <para>
2318 The following notes are for the benefit of users who want to migrate
2319 databases from postgres95 1.0 to postgres95 1.01.  
2320 </para>
2321 <para>
2322 If you are starting afresh with postgres95 1.01 and do not need
2323 to migrate old databases, you do not need to read any further.
2324 </para>
2325 <para>
2326 In order to postgres95 version 1.01 with databases created with
2327 postgres95 version 1.0, the following steps are required:  
2328 </para>
2329 <procedure>
2330 <step>
2331 <para>
2332 Set the definition of NAMEDATALEN in src/Makefile.global to 16
2333    and OIDNAMELEN to 20.
2334 </para>
2335 </step>
2336 <step>
2337 <para>
2338 Decide whether you want to use Host based authentication.  
2339 </para>
2340 <substeps>
2341 <step>
2342 <para>
2343 If you do, you must create a file name "pg_hba" in your top-level data
2344    directory (typically the value of your $PGDATA).  src/libpq/pg_hba
2345    shows an example syntax.
2346 </para>
2347 </step>
2348 <step>
2349 <para>
2350 If you do not want host-based authentication, you can comment out
2351    the line
2352 <programlisting>
2353         HBA = 1
2354 </programlisting>
2355    in src/Makefile.global
2356 </para>
2357 <para>
2358    Note that host-based authentication is turned on by default, and if
2359    you do not take steps A or B above, the out-of-the-box 1.01 will
2360    not allow you to connect to 1.0 databases.
2361 </para>
2362 </step>
2363 </substeps>
2364 </step>
2365
2366 <step>
2367 <para>
2368 Compile and install 1.01, but DO NOT do the initdb step.
2369 </para>
2370 </step>
2371 <step>
2372 <para>
2373 Before doing anything else, terminate your 1.0 postmaster, and
2374    backup your existing $PGDATA directory.   
2375 </para>
2376 </step>
2377 <step>
2378 <para>
2379 Set your PGDATA environment variable to your 1.0 databases, but set up
2380    path up so that 1.01 binaries are being used.
2381 </para>
2382 </step>
2383 <step>
2384 <para>
2385 Modify the file $PGDATA/PG_VERSION from 5.0 to 5.1
2386 </para>
2387 </step>
2388 <step>
2389 <para>
2390 Start up a new 1.01 postmaster
2391 </para>
2392 </step>
2393 <step>
2394 <para>
2395 Add the new built-in functions and operators of 1.01 to 1.0
2396    databases.  This is done by running the new 1.01 server against
2397    your own 1.0 database and applying the queries attached and saving 
2398    in the file 1.0_to_1.01.sql.   This can be done easily through psql.
2399    If your 1.0 database is name "testdb":
2400
2401 <programlisting>
2402         % psql testdb -f 1.0_to_1.01.sql
2403 </programlisting>
2404
2405 and then execute the following commands (cut and paste from here):
2406
2407 <programlisting>
2408 -- add builtin functions that are new to 1.01
2409
2410 create function int4eqoid (int4, oid) returns bool as 'foo'
2411 language 'internal';
2412 create function oideqint4 (oid, int4) returns bool as 'foo'
2413 language 'internal';
2414 create function char2icregexeq (char2, text) returns bool as 'foo'
2415 language 'internal';
2416 create function char2icregexne (char2, text) returns bool as 'foo'
2417 language 'internal';
2418 create function char4icregexeq (char4, text) returns bool as 'foo'
2419 language 'internal';
2420 create function char4icregexne (char4, text) returns bool as 'foo'
2421 language 'internal';
2422 create function char8icregexeq (char8, text) returns bool as 'foo'
2423 language 'internal';
2424 create function char8icregexne (char8, text) returns bool as 'foo'
2425 language 'internal';
2426 create function char16icregexeq (char16, text) returns bool as 'foo'
2427 language 'internal';
2428 create function char16icregexne (char16, text) returns bool as 'foo'
2429 language 'internal';
2430 create function texticregexeq (text, text) returns bool as 'foo'
2431 language 'internal';
2432 create function texticregexne (text, text) returns bool as 'foo'
2433 language 'internal';
2434
2435 -- add builtin functions that are new to 1.01
2436
2437 create operator = (leftarg = int4, rightarg = oid, procedure = int4eqoid);
2438 create operator = (leftarg = oid, rightarg = int4, procedure = oideqint4);
2439 create operator ~* (leftarg = char2, rightarg = text, procedure = char2icregexeq);
2440 create operator !~* (leftarg = char2, rightarg = text, procedure = char2icregexne);
2441 create operator ~* (leftarg = char4, rightarg = text, procedure = char4icregexeq);
2442 create operator !~* (leftarg = char4, rightarg = text, procedure = char4icregexne);
2443 create operator ~* (leftarg = char8, rightarg = text, procedure = char8icregexeq);
2444 create operator !~* (leftarg = char8, rightarg = text, procedure = char8icregexne);
2445 create operator ~* (leftarg = char16, rightarg = text, procedure = char16icregexeq);
2446 create operator !~* (leftarg = char16, rightarg = text, procedure = char16icregexne);
2447 create operator ~* (leftarg = text, rightarg = text, procedure = texticregexeq);
2448 create operator !~* (leftarg = text, rightarg = text, procedure = texticregexne);
2449 </programlisting>
2450 </para>
2451 </step>
2452 </procedure>
2453 </sect2>
2454
2455 <sect2>
2456 <title>Detailed Change List</title>
2457
2458 <para>
2459 <programlisting>
2460 Incompatibilities:
2461  * 1.01 is backwards compatible with 1.0 database provided the user
2462    follow the steps outlined in the MIGRATION_from_1.0_to_1.01 file.
2463    If those steps are not taken, 1.01 is not compatible with 1.0 database.
2464
2465 Enhancements:
2466  * added PQdisplayTuples() to libpq and changed monitor and psql to use it
2467  * added NeXT port (requires SysVIPC implementation)
2468  * added CAST .. AS ... syntax
2469  * added ASC and DESC keywords
2470  * added 'internal' as a possible language for CREATE FUNCTION
2471    internal functions are C functions which have been statically linked
2472    into the postgres backend.
2473  * a new type "name" has been added for system identifiers (table names,
2474    attribute names, etc.)  This replaces the old char16 type.   The
2475    of name is set by the NAMEDATALEN #define in src/Makefile.global
2476  * a readable reference manual that describes the query language.
2477  * added host-based access control.  A configuration file ($PGDATA/pg_hba)
2478    is used to hold the configuration data.  If host-based access control
2479    is not desired, comment out HBA=1 in src/Makefile.global.
2480  * changed regex handling to be uniform use of Henry Spencer's regex code
2481    regardless of platform.  The regex code is included in the distribution
2482  * added functions and operators for case-insensitive regular expressions. 
2483    The operators are ~* and !~*.
2484  * pg_dump uses COPY instead of SELECT loop for better performance
2485
2486 Bug fixes:
2487  * fixed an optimizer bug that was causing core dumps when 
2488    functions calls were used in comparisons in the WHERE clause
2489  * changed all uses of getuid to geteuid so that effective uids are used
2490  * psql now returns non-zero status on errors when using -c
2491  * applied public patches 1-14
2492 </programlisting>
2493 </para>
2494 </sect2>
2495 </sect1>
2496
2497 <sect1>
2498 <title>Release v1.0</title>
2499 <!--
2500 <docinfo>
2501 <authorgroup>
2502 <author>
2503 <firstname>Bruce</firstname>
2504 <surname>Momjian</surname>
2505 </author>
2506 </authorgroup>
2507 <date>
2508 Tue Sep  5 11:24:11 PDT 1995
2509 </date>
2510 </docinfo>
2511 -->
2512
2513 <sect2>
2514 <title>Detailed Change List</title>
2515
2516 <para>
2517 <programlisting>
2518 Copyright change:
2519  * The copyright of <productname>Postgres</productname> 1.0 has been loosened to be freely modifiable
2520    and modifiable for any purpose.  Please read the COPYRIGHT file.
2521    Thanks to Professor Michael Stonebraker for making this possible.
2522
2523 Incompatibilities:
2524  *  date formats have to be MM-DD-YYYY (or DD-MM-YYYY if you're using
2525    EUROPEAN STYLE).  This follows SQL-92 specs.
2526  *  "delimiters" is now a keyword
2527
2528 Enhancements:
2529  *  sql LIKE syntax has been added
2530  *  copy command now takes an optional USING DELIMITER specification.
2531    delimiters can be any single-character string. 
2532  *  IRIX 5.3 port has been added.
2533    Thanks to Paul Walmsley and others.
2534  *  updated pg_dump to work with new libpq
2535  *  \d has been added psql 
2536    Thanks to Keith Parks
2537  *  regexp performance for architectures that use POSIX regex has been
2538    improved due to caching of precompiled patterns.
2539    Thanks to Alistair Crooks
2540  *  a new version of libpq++
2541    Thanks to William Wanders
2542
2543 Bug fixes:
2544  *  arbitrary userids can be specified in the createuser script
2545  *  \c to connect to other databases in psql now works.
2546  *  bad pg_proc entry for float4inc() is fixed
2547  *  users with usecreatedb field set can now create databases without
2548    having to be usesuper
2549  *  remove access control entries when the entry no longer has any
2550    permissions
2551  *  fixed non-portable datetimes implementation
2552  *  added kerberos flags to the src/backend/Makefile
2553  *  libpq now works with kerberos
2554  *  typographic errors in the user manual have been corrected.
2555  *  btrees with multiple index never worked, now we tell you they don't
2556    work when you try to use them
2557 </programlisting>
2558 </para>
2559 </sect2>
2560 </sect1>
2561
2562 <sect1>
2563 <title><productname>Postgres95</productname> Beta 0.03</title>
2564 <!--
2565 <docinfo>
2566 <authorgroup>
2567 <author>
2568 <firstname>Bruce</firstname>
2569 <surname>Momjian</surname>
2570 </author>
2571 </authorgroup>
2572 <date>
2573 Fri Jul 21 14:49:31 PDT 1995
2574 </date>
2575 </docinfo>
2576 -->
2577
2578 <sect2>
2579 <title>Detailed Change List</title>
2580
2581 <para>
2582 <programlisting>
2583 Incompatible changes:
2584  * BETA-0.3 IS INCOMPATIBLE WITH DATABASES CREATED WITH PREVIOUS VERSIONS
2585    (due to system catalog changes and indexing structure changes).
2586  * double-quote (") is deprecated as a quoting character for string literals;
2587    you need to convert them to single quotes (').
2588  * name of aggregates (eg. int4sum) are renamed in accordance with the
2589    SQL standard (eg. sum).
2590  * CHANGE ACL syntax is replaced by GRANT/REVOKE syntax.
2591  * float literals (eg. 3.14) are now of type float4 (instead of float8 in
2592    previous releases); you might have to do typecasting if you depend on it
2593    being of type float8.  If you neglect to do the typecasting and you assign
2594    a float literal to a field of type float8, you may get incorrect values
2595    stored!
2596  * LIBPQ has been totally revamped so that frontend applications
2597    can connect to multiple backends
2598  * the usesysid field in pg_user has been changed from int2 to int4 to
2599    allow wider range of Unix user ids.
2600  * the netbsd/freebsd/bsd o/s ports have been consolidated into a
2601    single BSD44_derived port.  (thanks to Alistair Crooks)
2602
2603 SQL standard-compliance (the following details changes that makes postgres95
2604 more compliant to the SQL-92 standard):
2605  * the following SQL types are now built-in: smallint, int(eger), float, real,
2606    char(N), varchar(N), date and time.
2607
2608    The following are aliases to existing postgres types:
2609                 smallint -> int2
2610                 integer, int -> int4
2611                 float, real  -> float4
2612    char(N) and varchar(N) are implemented as truncated text types. In
2613    addition, char(N) does blank-padding. 
2614  * single-quote (') is used for quoting string literals; '' (in addition to
2615    \') is supported as means of inserting a single quote in a string
2616  * SQL standard aggregate names (MAX, MIN, AVG, SUM, COUNT) are used
2617    (Also, aggregates can now be overloaded, i.e. you can define your
2618    own MAX aggregate to take in a user-defined type.)
2619  * CHANGE ACL removed. GRANT/REVOKE syntax added.  
2620    - Privileges can be given to a group using the "GROUP" keyword.
2621         For example:
2622                 GRANT SELECT ON foobar TO GROUP my_group;
2623         The keyword 'PUBLIC' is also supported to mean all users.       
2624
2625         Privileges can only be granted or revoked to one user or group
2626         at a time.  
2627
2628         "WITH GRANT OPTION" is not supported.  Only class owners can change
2629         access control
2630    - The default access control is to to grant users readonly access.
2631      You must explicitly grant insert/update access to users.  To change
2632      this, modify the line in 
2633                 src/backend/utils/acl.h 
2634      that defines ACL_WORLD_DEFAULT 
2635
2636 Bug fixes:
2637  * the bug where aggregates of empty tables were not run has been fixed. Now,
2638    aggregates run on empty tables will return the initial conditions of the
2639    aggregates. Thus, COUNT of an empty  table will now properly return 0.
2640    MAX/MIN of an empty table will return a tuple of value NULL. 
2641  * allow the use of \; inside the monitor
2642  * the LISTEN/NOTIFY asynchronous notification mechanism now work
2643  * NOTIFY in rule action bodies now work
2644  * hash indices work, and access methods in general should perform better.
2645    creation of large btree indices should be much faster.  (thanks to Paul
2646    Aoki)
2647
2648 Other changes and enhancements:
2649  * addition of an EXPLAIN statement used for explaining the query execution
2650    plan (eg. "EXPLAIN SELECT * FROM EMP" prints out the execution plan for
2651    the query).
2652  * WARN and NOTICE messages no longer have timestamps on them. To turn on
2653    timestamps of error messages, uncomment the line in
2654    src/backend/utils/elog.h:
2655         /* define ELOG_TIMESTAMPS */ 
2656  * On an access control violation, the message
2657         "Either no such class or insufficient privilege"
2658    will be given.  This is the same message that is returned when
2659    a class is not found.  This dissuades non-privileged users from
2660    guessing the existence of privileged classes.
2661  * some additional system catalog changes have been made that are not
2662    visible to the user.
2663
2664 libpgtcl changes:
2665  * The -oid option has been added to the "pg_result" tcl command.
2666    pg_result -oid returns oid of the last tuple inserted.   If the
2667    last command was not an INSERT, then pg_result -oid returns "".
2668  * the large object interface is available as pg_lo* tcl commands:
2669    pg_lo_open, pg_lo_close, pg_lo_creat, etc.
2670
2671 Portability enhancements and New Ports:
2672  * flex/lex problems have been cleared up.  Now, you should be able to use
2673    flex instead of lex on any platforms.  We no longer make assumptions of
2674    what lexer you use based on the platform you use. 
2675  * The Linux-ELF port is now supported.  Various configuration have been 
2676    tested:  The following configuration is known to work:
2677         kernel 1.2.10, gcc 2.6.3, libc 4.7.2, flex 2.5.2, bison 1.24
2678    with everything in ELF format,
2679
2680 New utilities:
2681  * ipcclean added to the distribution
2682    ipcclean usually does not need to be run, but if your backend crashes
2683    and leaves shared memory segments hanging around, ipcclean will
2684    clean them up for you.
2685
2686 New documentation:
2687  * the user manual has been revised and libpq documentation added.
2688 </programlisting>
2689 </para>
2690 </sect2>
2691 </sect1>
2692
2693 <sect1>
2694 <title><productname>Postgres95</productname> Beta 0.02</title>
2695 <!--
2696 <docinfo>
2697 <authorgroup>
2698 <author>
2699 <firstname>Bruce</firstname>
2700 <surname>Momjian</surname>
2701 </author>
2702 </authorgroup>
2703 <date>
2704 Thu May 25 16:54:46 PDT 1995
2705 </date>
2706 </docinfo>
2707 -->
2708
2709 <sect2>
2710 <title>Detailed Change List</title>
2711
2712 <para>
2713 <programlisting>
2714 Incompatible changes:
2715  * The SQL statement for creating a database is 'CREATE DATABASE' instead
2716    of 'CREATEDB'. Similarly, dropping a database is 'DROP DATABASE' instead
2717    of 'DESTROYDB'. However, the names of the executables 'createdb' and 
2718    'destroydb' remain the same.
2719  
2720 New tools:
2721  * pgperl - a Perl (4.036) interface to Postgres95
2722  * pg_dump - a utility for dumping out a postgres database into a
2723         script file containing query commands. The script files are in a ASCII
2724         format and can be used to reconstruct the database, even on other
2725         machines and other architectures. (Also good for converting
2726         a Postgres 4.2 database to Postgres95 database.)
2727
2728 The following ports have been incorporated into postgres95-beta-0.02:
2729  * the NetBSD port by Alistair Crooks
2730  * the AIX port by Mike Tung
2731  * the Windows NT port by Jon Forrest (more stuff but not done yet)
2732  * the Linux ELF port by Brian Gallew
2733
2734 The following bugs have been fixed in postgres95-beta-0.02:
2735  * new lines not escaped in COPY OUT and problem with COPY OUT when first
2736    attribute is a '.' 
2737  * cannot type return to use the default user id in createuser
2738  * SELECT DISTINCT on big tables crashes
2739  * Linux installation problems
2740  * monitor doesn't allow use of 'localhost' as PGHOST
2741  * psql core dumps when doing \c or \l
2742  * the "pgtclsh" target missing from src/bin/pgtclsh/Makefile
2743  * libpgtcl has a hard-wired default port number
2744  * SELECT DISTINCT INTO TABLE hangs
2745  * CREATE TYPE doesn't accept 'variable' as the internallength
2746  * wrong result using more than 1 aggregate in a SELECT
2747 </programlisting>
2748 </para>
2749 </sect2>
2750 </sect1>
2751
2752 <sect1>
2753 <title><productname>Postgres95</productname> Beta 0.01</title>
2754 <!--
2755 <docinfo>
2756 <authorgroup>
2757 <author>
2758 <firstname>Bruce</firstname>
2759 <surname>Momjian</surname>
2760 </author>
2761 </authorgroup>
2762 <date>
2763 Mon May 1 19:03:10 PDT 1995
2764 </date>
2765 </docinfo>
2766 -->
2767
2768 <para>
2769 Initial release.
2770 </para>
2771 </sect1>
2772
2773   <sect1>
2774    <title>Timing Results</title>
2775
2776    <para>
2777     These timing results are from running the regression test with the commands
2778
2779     <programlisting>
2780 % cd src/test/regress
2781 % make all
2782 % time make runtest
2783     </programlisting>
2784    </para>
2785    <para>
2786     Timing under Linux 2.0.27 seems to have a roughly 5% variation from run
2787     to run, presumably due to the scheduling vagaries of multitasking systems.
2788    </para>
2789
2790    <sect2>
2791     <title>v6.5</title>
2792
2793     <para>
2794      As has been the case for previous releases, timing between
2795      releases is not directly comparable since new regression tests
2796      have been added. In general, v6.5 is faster than previous
2797      releases.
2798     </para>
2799
2800     <para>
2801      Timing with <function>fsync()</function> disabled:
2802
2803      <programlisting>
2804   Time   System
2805   02:00  Dual Pentium Pro 180, 224MB, UW-SCSI, Linux 2.0.36, gcc 2.7.2.3 -O2 -m486
2806   04:38  Sparc Ultra 1 143MHz, 64MB, Solaris 2.6
2807      </programlisting>
2808     </para>
2809
2810     <para>
2811      Timing with <function>fsync()</function> enabled:
2812
2813      <programlisting>
2814   Time   System
2815   04:21  Dual Pentium Pro 180, 224MB, UW-SCSI, Linux 2.0.36, gcc 2.7.2.3 -O2 -m486
2816      </programlisting>
2817
2818      For the linux system above, using UW-SCSI disks rather than (older) IDE
2819      disks leads to a 50% improvement in speed on the regression test.
2820     </para>
2821    </sect2>
2822
2823 <sect2>
2824 <title>v6.4beta</title>
2825
2826 <para>
2827 The times for this release are not directly comparable to those for previous releases
2828 since some additional regression tests have been included.
2829 In general, however, v6.4 should be slightly faster than the previous release (thanks, Bruce!).
2830 </para>
2831 <para>
2832 <programlisting>
2833   Time   System
2834   02:26  Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
2835 </programlisting>
2836 </para>
2837 </sect2>
2838
2839 <sect2>
2840 <title>v6.3</title>
2841
2842 <para>
2843 The times for this release are not directly comparable to those for previous releases
2844 since some additional regression tests have been included and some obsolete tests involving
2845 time travel have been removed.
2846 In general, however, v6.3 is substantially faster than previous releases (thanks, Bruce!).
2847 </para>
2848 <para>
2849 <programlisting>
2850   Time   System
2851   02:30  Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
2852   04:12  Dual Pentium Pro 180, 96MB, EIDE, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
2853 </programlisting>
2854 </para>
2855 </sect2>
2856
2857 <sect2>
2858 <title>v6.1</title>
2859
2860 <para>
2861 <programlisting>
2862   Time   System
2863   06:12  Pentium Pro 180, 32MB, EIDE, Linux 2.0.30, gcc 2.7.2 -O2 -m486
2864   12:06  P-100, 48MB, Linux 2.0.29, gcc
2865   39:58  Sparc IPC 32MB, Solaris 2.5, gcc 2.7.2.1 -O -g
2866 </programlisting>
2867 </para>
2868 </sect2>
2869 </sect1>
2870 </chapter>
2871
2872 <!-- Keep this comment at the end of the file
2873 Local variables:
2874 mode: sgml
2875 sgml-omittag:nil
2876 sgml-shorttag:t
2877 sgml-minimize-attributes:nil
2878 sgml-always-quote-attributes:t
2879 sgml-indent-step:1
2880 sgml-indent-data:t
2881 sgml-parent-document:nil
2882 sgml-default-dtd-file:"./reference.ced"
2883 sgml-exposed-tags:nil
2884 sgml-local-catalogs:"/usr/lib/sgml/catalog"
2885 sgml-local-ecat-files:nil
2886 End:
2887 -->