]> granicus.if.org Git - postgresql/blob - doc/src/sgml/release.sgml
SGML source for new documentation.
[postgresql] / doc / src / sgml / release.sgml
1 <Chapter>
2 <Title>Release Notes</Title>
3
4 <Para>
5 <Note>
6 <Para>
7 Should include the migration notes from <FileName>migration/</FileName>.
8 </Para>
9 </Note>
10 </Para>
11
12 <Para>
13 The release notes have not yet been integrated into the new documentation.
14 Check for plain text files in the top of the distribution directory tree
15 and in the <FileName>migration/</FileName> directory for current information.
16
17 <Sect1>
18 <Title>Release 6.3</Title>
19
20 <Para>
21 TBD
22 </Para>
23
24 </Sect1>
25
26 <Sect1>
27 <Title>Release 6.2.1</Title>
28
29 <Para>
30 <Note>
31 <Para>
32 v6.2.1 was a bug-fix and usability release on v6.2. Needs only a few notes.
33 </Para>
34 </Note>
35 </Para>
36
37 </Sect1>
38
39 <Sect1>
40 <Title>Release 6.2</Title>
41
42 <Para>
43 <Note>
44 <Para>
45 This should include information based on Bruce's release summary.
46 </Para>
47 </Note>
48 </Para>
49
50 </Sect1>
51
52 <Sect1>
53 <Title>Release 6.1</Title>
54
55 <Para>
56 <Note>
57 <Para>
58 This should include information based on Bruce's release summary.
59 </Para>
60 </Note>
61 </Para>
62
63 <Para>
64   The regression tests have been adapted and extensively modified for the
65   v6.1 release of PostgreSQL.
66 </Para>
67
68 <Para>
69   Three new data types (datetime, timespan, and circle) have been added to
70   the native set of PostgreSQL types. Points, boxes, paths, and polygons
71   have had their output formats made consistant across the data types.
72   The polygon output in misc.out has only been spot-checked for correctness
73   relative to the original regression output.
74 </Para>
75
76 <Para>
77   PostgreSQL v6.1 introduces a new, alternate optimizer which uses <FirstTerm>genetic</FirstTerm>
78   algorithms. These algorithms introduce a random behavior in the ordering
79   of query results when the query contains multiple qualifiers or multiple
80   tables (giving the optimizer a choice on order of evaluation). Several
81   regression tests have been modified to explicitly order the results, and
82   hence are insensitive to optimizer choices. A few regression tests are
83   for data types which are inherently unordered (e.g. points and time
84   intervals) and tests involving those types are explicitly bracketed with
85   <Command>set geqo to 'off'</Command> and <Command>reset geqo</Command>.
86 </Para>
87
88 <Para>
89   The interpretation of array specifiers (the curly braces around atomic
90   values) appears to have changed sometime after the original regression
91   tests were generated. The current <FileName>./expected/*.out</FileName> files reflect this
92   new interpretation, which may not be correct!
93 </Para>
94
95 <Para>
96   The float8 regression test fails on at least some platforms. This is due
97   to differences in implementations of pow() and exp() and the signaling
98   mechanisms used for overflow and underflow conditions.
99 </Para>
100
101 <Para>
102   The "random" results in the random test should cause the "random" test
103   to be "failed", since the regression tests are evaluated using a simple
104   diff. However, "random" does not seem to produce random results on my 
105   test machine (Linux/gcc/i686).
106 </Para>
107
108 <Sect1>
109 <Title>Timing Results</Title>
110
111 <Para>
112 These timing results are from running the regression test with the command
113
114 <ProgramListing>
115 % time make runtest
116 </ProgramListing>
117
118 <Para>
119   Timing under Linux 2.0.27 seems to have a roughly 5% variation from run
120   to run, presumably due to the timing vagaries of multitasking systems.
121
122 <Sect2>
123 <Title>v6.3</Title>
124
125 <Para>
126 <ProgramListing>
127   Time   System
128   02:30  Dual Pentium Pro 180, 96MB, UW-SCSI, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
129   04:12  Dual Pentium Pro 180, 96MB, EIDE, Linux 2.0.30, gcc 2.7.2.1 -O2 -m486
130 </ProgramListing>
131
132 <Sect2>
133 <Title>v6.1</Title>
134
135 <Para>
136 <ProgramListing>
137   Time   System
138   06:12  Pentium Pro 180, 32MB, Linux 2.0.30, gcc 2.7.2 -O2 -m486
139   12:06  P-100, 48MB, Linux 2.0.29, gcc
140   39:58  Sparc IPC 32MB, Solaris 2.5, gcc 2.7.2.1 -O -g
141 </ProgramListing>
142
143 </Chapter>
144