@@ -26,21 +26,11 @@ Preparation
26
26
./expected/*.out files. The localization replaces macros in the source
27
27
files with absolute pathnames and user names.
28
28
29
- The postmaster should be invoked with the system time zone set for
30
- Berkeley, California. On many systems, this can be accomplished by
31
- setting the TZ environment variable before starting the postmaster
32
- (for csh/bash; use set/export for some other shells):
33
-
34
- setenv TZ PST8PDT
35
- date
36
- /usr/local/pgsql/bin/postmaster -s
37
-
38
- The "date" command above should have returned the current system time
39
- in the PST8PDT time zone. If the PST8PDT database is not available, then
40
- your system may have returned the time in GMT. If the PST8PDT time zone
41
- is not available, you can set the time zone rules explicitly:
42
-
43
- setenv TZ PST8PDT7,M04.01.0,M10.05.03
29
+ It was formerly necessary to run the postmaster with system time zone
30
+ set to PST, but this is no longer required. You can run the regression
31
+ tests under your normal postmaster configuration. The test script will
32
+ set the PGTZ environment variable to ensure that timezone-dependent tests
33
+ produce the expected results.
44
34
45
35
Directory Layout
46
36
@@ -78,6 +68,9 @@ Comparing expected/actual output
78
68
79
69
The results are in files in the ./results directory. These results
80
70
can be compared with results in the ./expected directory using 'diff'.
71
+ (The test script now does this for you, and leaves the differences
72
+ in ./regression.diffs.)
73
+
81
74
The files might not compare exactly. The following paragraphs attempt
82
75
to explain the differences.
83
76
@@ -106,22 +99,24 @@ OID differences
106
99
107
100
DATE/TIME differences
108
101
109
- On many supported platforms, you can force PostgreSQL to believe that it
110
- is running in the same time zone as Berkeley, California. See details in
111
- the section on how to run the regression tests.
102
+ Most of the date and time results are dependent on timezone environment.
103
+ The reference files are generated for timezone PST8PDT (Berkeley,
104
+ California) and there will be apparent failures if the tests are not
105
+ run with that timezone setting. The regression test driver sets
106
+ environment variable PGTZ to PST8PDT to ensure proper results.
112
107
113
- If you do not explicitly set your time zone environment to PST8PDT, then
114
- most of the date and time results will reflect your local time zone and
115
- will fail the regression testing .
108
+ There appear to be some systems which do not accept the recommended syntax
109
+ for explicitly setting the local time zone rules; you may need to use
110
+ a different PGTZ setting on such machines .
116
111
117
- There appears to be some systems which do not accept the recommended syntax
118
- for explicitly setting the local time zone rules. Some systems using the
119
- public domain time zone package exhibit minor problems with pre-1970 PDT
120
- times, representing them in PST instead .
112
+ Some systems using older timezone libraries fail to apply daylight-savings
113
+ corrections to pre-1970 dates, causing pre-1970 PDT times to be displayed
114
+ in PST instead. This will result in localized differences in the test
115
+ results .
121
116
122
117
FLOATING POINT differences
123
118
124
- Some of the tests involve computing 64-bit (FLOAT8) number from table
119
+ Some of the tests involve computing 64-bit (FLOAT8) numbers from table
125
120
columns. Differences in results involving mathematical functions of
126
121
FLOAT8 columns have been observed. These differences occur where
127
122
different operating systems are used on the same platform ie:
@@ -137,7 +132,7 @@ FLOATING POINT differences
137
132
138
133
POLYGON differences
139
134
140
- Several of the tests involve operations on geographic date about the
135
+ Several of the tests involve operations on geographic data about the
141
136
Oakland/Berkley CA street map. The map data is expressed as polygons
142
137
whose vertices are represented as pairs of FLOAT8 numbers (decimal
143
138
latitude and longitude). Initially, some tables are created and
@@ -147,7 +142,7 @@ POLYGON differences
147
142
148
143
When comparing the results from different platforms, differences occur
149
144
in the 2nd or 3rd place to the right of the decimal point. The SQL
150
- statements where these problems occur are the folowing :
145
+ statements where these problems occur are the following :
151
146
152
147
QUERY: SELECT * from street;
153
148
QUERY: SELECT * from iexit;
0 commit comments