[postgis-tickets] [SCM] PostGIS branch master updated. 3.4.0rc1-689-g20a22b1a6

[git at osgeo.org]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".

The branch, master has been updated
       via  20a22b1a63fdd2ed062872cfceda23ca6bc339c3 (commit)
      from  5e8783b89cb989c06e9b57a1ecf85a905c05f23e (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 20a22b1a63fdd2ed062872cfceda23ca6bc339c3
Author: Sandro Santilli <strk at kbt.io>
Date:   Tue Oct 17 15:12:59 2023 +0200

    Update regress/README

diff --git a/regress/README b/regress/README
index 093d1dd14..7e29fd909 100644
--- a/regress/README
+++ b/regress/README
@@ -3,81 +3,35 @@ Requirements for run_test.pl
 
 run_test.pl requires the following Perl modules to be installed
 
- Text::Diff;
- File::Which;
- File::Basename;
- File::Temp 'tempdir';
- File::Copy;
- File::Path 'make_path';
- File::Path 'remove_tree';
- Cwd 'abs_path';
- Getopt::Long;
+ File::Basename
+ Time::HiRes
+ File::Temp
+ File::Copy
+ File::Path
+ Cwd
+ Getopt::Long
 
-Most distributions of Perl will have everything except Text::Diff and File::Which.
-To install them from the command-line, as root run
-
- cpan Text::Diff
- cpan File::Which
+Most distributions of Perl will have everything
 
 
 How to add a regression test
 ----------------------------
 
-1. Write a /regress/<testname>.sql file with data and sql queries for testing
-2. Write a /regress/<testname>_expected or <testname>_expected.in file with
-   expected results per query
-   The expected results provided in the <testname>_expected file must be
-   formatted using the following psql options:
-      -a -- unaligned columns
-      -f | -- use | (pipe) as the field separator between columns
-      -t -- output rows only, ie. no table header
+1. Write a ${test}.sql file with test sql queries
 
-   cat file.sql | psql -F\| -t -A > file_expected
+2. Generate and tweak ${test}_expected file:
+   regress/run_test.pl --expect ${test} && vi ${test}_expected
 
-3. Edit regress/Makefile adding <testname> to the TESTS variable.
-   Any _expected.in files need to be added to the PREPROC variable.
+3. Add ${test} to $(dirname ${test})/tests.mk*
 
 Optional:
    If your test has unusual setup or teardown requirements, you may create
    any of the following optional files (they will run in this order):
-        /regress/<testname>-pre.sh
-        /regress/<testname>-pre.sql   (run via psql)
+        ${test}-pre.sh
+        ${test}-pre.sql   (run via psql)
                  (The test itself is run here.)
-        /regress/<testname>-post.sql  (run via psql)
-        /regress/<testname>-post.sh
-
-Notes about changes in regression tests introduces with PostGIS 1.1.0
----------------------------------------------------------------------
-
-- Mixed-dimensioned geometries are no longer supported
-  (previous behaviour was to fill Z with a 0 value)
-  [ updated to use new behaviour ]
-
-- geometry_same operator (=~) now requires all dimensions equality
-  Previously only x/y were checked
-
-- geometry_same operator (=~) now requires geom type equality
-  Previous behaviour:
-     GEOMETRYCOLLECTION(POINT(0 1), POINT(2 3)) =~  MULTIPOINT(0 1,2 3)
-
-- numb_sub_geometries does not exist anymore
-  [updated to use numgeometries]
-
-- truly_inside does not exist anymore
-  [updated to use within]
-
-Notes about <testname>_expected.in
-----------------------------------
-
-The first line of the <testname>_expected.in should include the postgis
-configuration header.
-
-  #include "../postgis_config.h"
-
-The ability to run a c preprocessor over the expected results prior to
-regression testing was needed for testing curved string functionality that
-would elicit different responses from JTS vs GEOS compilations.  Since
-JTS is no longer supported, this may not be required anymore.
+        ${test}-post.sql  (run via psql)
+        ${test}-post.sh
 
 Notes about running individual regression tests
 -----------------------------------------------

-----------------------------------------------------------------------

Summary of changes:
 regress/README | 78 ++++++++++++----------------------------------------------
 1 file changed, 16 insertions(+), 62 deletions(-)


hooks/post-receive
-- 
PostGIS