From: Peter Eisentraut Date: Fri, 21 Sep 2001 18:37:05 +0000 (+0000) Subject: Readd test/regress/README file, this time with a well-defined and simple X-Git-Tag: REL7_2_BETA1~356 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=4e77b4a5487c074e3e9882feef816f87e3a03a18;p=postgresql Readd test/regress/README file, this time with a well-defined and simple rule to remake it when necessary. --- diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile index bf3c70f853..3e7c0a8bc3 100644 --- a/doc/src/sgml/Makefile +++ b/doc/src/sgml/Makefile @@ -8,7 +8,7 @@ # # # IDENTIFICATION -# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.39 2001/09/18 12:08:26 petere Exp $ +# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.40 2001/09/21 18:37:05 petere Exp $ # #---------------------------------------------------------------------------- @@ -148,10 +148,10 @@ $(addsuffix .tex, $(ALLBOOKS)): %.tex: %.sgml $(ALLSGML) stylesheet.dsl JADE.text = $(JADE) $(JADEFLAGS) $(SGMLINCLUDE) -c $(CATALOG) -d stylesheet.dsl -i output-text -t sgml -INSTALL HISTORY: % : %.html +INSTALL HISTORY regress_README: % : %.html @echo "|";\ - echo "| You should now take \`$<', save it as a text file in Netscape,";\ - echo "| and put it in place of the existing \`$@' file.";\ + echo "| You should now take '$<', save it as a text file in Netscape,";\ + echo "| and put it in place of the existing '$@' file.";\ echo "|" INSTALL.html: standalone-install.sgml installation.sgml @@ -163,6 +163,13 @@ HISTORY.html: release.sgml $(JADE.text) -V nochunks tempfile_HISTORY.sgml >$@ rm tempfile_HISTORY.sgml +regress_README.html: regress.sgml + ( echo ' ]>'; \ + cat $< ) >tempfile_regress_README.sgml + $(JADE.text) -V nochunks tempfile_regress_README.sgml >$@ + rm tempfile_regress_README.sgml + ## ## Check diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml index 1c295a1a11..3d12e4e2e2 100644 --- a/doc/src/sgml/docguide.sgml +++ b/doc/src/sgml/docguide.sgml @@ -1,4 +1,4 @@ - + Documentation @@ -901,21 +901,9 @@ exit The file HISTORY can be created similarly, - using the command gmake HISTORY. The table - of contents should be removed manually from the resulting text - file. - - - - Since it does not change very often, the generation of the file - src/test/regress/README is not fully - automated. After building the HTML version of - the Administrator's Guide, convert the - resulting files regress.html and - regress-platform.html to text, using - Netscape. Then paste the text files - together and edit them to taste (e.g., remove the navigation - bars, remove the references to other chapters). + using the command gmake HISTORY. For the + file src/test/regress/README the command is + gmake regress_README. + @@ -100,6 +100,11 @@ - - - + + + diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 3aee49adf7..49bb5c2dcc 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -1,7 +1,7 @@ - + - <![%flattext-install-include[<productname>PostgreSQL</>]]> + <title><![%standalone-include[<productname>PostgreSQL</>]]> Installation Instructions @@ -27,8 +27,8 @@ su - postgres /usr/local/pgsql/bin/psql test The long version is the rest of this - - + + @@ -156,7 +156,7 @@ su - postgres - Getting The Source @@ -221,8 +221,8 @@ su - postgres foreign keys), then use the option when running pg_dumpall. pg_dumpall does not save large objects. Check - Administrator's Guide]]> - ]]> + Administrator's Guide]]> + ]]> if you need to do this. @@ -290,8 +290,8 @@ su - postgres You can also install the new version in parallel with the old one to decrease the downtime. These topics are discussed at length in - Administrator's Guide,]]> - ,]]> + Administrator's Guide,]]> + ,]]> which you are encouraged to read in any case. @@ -531,8 +531,8 @@ su - postgres Enables single-byte character set recode support. See - Administrator's Guide]]> - ]]> about this feature. + Administrator's Guide]]> + ]]> about this feature. @@ -544,8 +544,8 @@ su - postgres Allows the use of multibyte character encodings. This is primarily for languages like Japanese, Korean, and Chinese. Read - Administrator's Guide]]> - ]]> + Administrator's Guide]]> + ]]> for details. @@ -902,10 +902,10 @@ All of PostgreSQL is successfully made. Ready to install. It is possible that some tests fail, due to differences in error message wording or floating point results. - src/test/regress/README and the Administrator's Guide contain]]> - contains]]> + contains]]> detailed information about interpreting the test results. You can repeat this test at any later time by issuing the same command. @@ -1127,7 +1127,7 @@ MANPATH=$MANPATH:/usr/local/pgsql/man - Getting Started @@ -1634,8 +1634,8 @@ gunzip -c user.ps.gz \ 2001-03-26, Magnus Hagander (mha@sollentuna.net) client-side libraries (libpq and psql) or ODBC/JDBC, no server-side; - -]]> + +]]> for instructions diff --git a/doc/src/sgml/regress.sgml b/doc/src/sgml/regress.sgml index bdeadfb9bf..ab36ff87e3 100644 --- a/doc/src/sgml/regress.sgml +++ b/doc/src/sgml/regress.sgml @@ -1,13 +1,10 @@ - + Regression Tests - - - Regression test instructions and analysis - - + + Introduction The regression tests are a comprehensive set of tests for the SQL @@ -20,6 +17,11 @@ the regression tests are current for every official release. + + + + Running the Tests + The regression test can be run against an already installed and running server, or using a temporary installation within the build @@ -97,9 +99,9 @@ - To run the tests after installation (see ), initialize a data area and start the - server, as explained in , then type + To run the tests after installation)]]>, + initialize a data area and start the + server, , ]]> then type $ gmake installcheck @@ -107,6 +109,7 @@ default port number, unless directed otherwise by PGHOST and PGPORT environment variables. + Test Evaluation @@ -255,7 +258,7 @@ PGTZ='PST8PDT7,M04.01.0,M10.05.03'; export PGTZ Several of the tests involve operations on geographic data about - the Oakland/Berkeley, CA street map. The map data is expressed as + the Oakland/Berkeley, California street map. The map data is expressed as polygons whose vertices are represented as pairs of double precision numbers (decimal latitude and longitude). Initially, some tables are created and loaded with @@ -277,15 +280,15 @@ SELECT * from iexit; - Tuple ordering differences + Row ordering differences -You might see differences in which the same tuples are output in a +You might see differences in which the same rows are output in a different order than what appears in the expected file. In most cases this is not, strictly speaking, a bug. Most of the regression test scripts are not so pedantic as to use an ORDER BY for every single -SELECT, and so their result tuple orderings are not well-defined -according to the letter of the SQL spec. In practice, since we are +SELECT, and so their result row orderings are not well-defined +according to the letter of the SQL specification. In practice, since we are looking at the same queries being executed on the same data by the same software, we usually get the same result ordering on all platforms, and so the lack of ORDER BY isn't a problem. Some queries do exhibit @@ -325,12 +328,13 @@ diff results/random.out expected/random.out not worry unless the random test always fails in repeated attempts. (On the other hand, if the random test is never reported to fail even in many trials - of the regress tests, you probably should + of the regression tests, you probably should worry.) + Platform-specific comparison files @@ -384,6 +388,7 @@ horology/hppa=horology-no-DST-before-1970 +]]> diff --git a/doc/src/sgml/standalone-install.sgml b/doc/src/sgml/standalone-install.sgml index 88914cb5a7..2e657acb93 100644 --- a/doc/src/sgml/standalone-install.sgml +++ b/doc/src/sgml/standalone-install.sgml @@ -1,4 +1,4 @@ - + - - + +