[postgis-tickets] [SCM] PostGIS branch master updated. 3.2.0-8-gc9dfab579
git at osgeo.org
git at osgeo.org
Mon Dec 20 01:46:02 PST 2021
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 c9dfab57937b0e9454dbded9f4f7eaebbd79d0bd (commit)
via b4cf86d0ddae1cf4c48c170fed0a226599147bd6 (commit)
from 7678d927de8c1822a9b655966c3d2eb58ad1ae59 (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 c9dfab57937b0e9454dbded9f4f7eaebbd79d0bd
Author: Sandro Santilli <strk at kbt.io>
Date: Sun Dec 19 23:29:53 2021 +0100
Update docs about ST_AsKML
diff --git a/doc/reference_output.xml b/doc/reference_output.xml
index f58c3d37b..1c55f2bb7 100644
--- a/doc/reference_output.xml
+++ b/doc/reference_output.xml
@@ -979,7 +979,7 @@ SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0
<refnamediv>
<refname>ST_AsKML</refname>
- <refpurpose>Return the geometry as a KML element. Several variants. Default version=2, default maxdecimaldigits=15</refpurpose>
+ <refpurpose>Return the geometry as a KML element.</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -1005,9 +1005,9 @@ SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0
<refsection>
<title>Description</title>
- <para>Return the geometry as a Keyhole Markup Language (KML) element. There are several variants of this function.
- maximum number of decimal places used in
- output (defaults to 15), version default to 2 and default namespace is no prefix.</para>
+ <para>Return the geometry as a Keyhole Markup Language (KML) element.
+ default maximum number of decimal places is 15,
+ default namespace is no prefix.</para>
<warning>
<para>Using the <parameter>maxdecimaldigits</parameter> parameter
@@ -1017,9 +1017,6 @@ SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0
</para>
</warning>
- <para>Version 1: ST_AsKML(geom_or_geog, maxdecimaldigits) / version=2 / maxdecimaldigits=15 </para>
- <para>Version 2: ST_AsKML(version, geom_or_geog, maxdecimaldigits, nprefix) maxdecimaldigits=15 / nprefix=NULL </para>
-
<note>
<para>Requires PostGIS be compiled with Proj support. Use <xref linkend="PostGIS_Full_Version" /> to confirm you have proj support compiled in.</para>
</note>
@@ -1028,10 +1025,10 @@ SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0
<para>Availability: 1.2.2 - later variants that include version param came in 1.3.2</para>
</note>
<note>
- <para>Enhanced: 2.0.0 - Add prefix namespace. Default is no prefix</para>
+ <para>Enhanced: 2.0.0 - Add prefix namespace, use default and named args</para>
</note>
<note>
- <para>Changed: 2.0.0 - uses default args and supports named args</para>
+ <para>Changed: 3.0.0 - Removed the "versioned" variant signature</para>
</note>
<note>
commit b4cf86d0ddae1cf4c48c170fed0a226599147bd6
Author: Sandro Santilli <strk at kbt.io>
Date: Sun Dec 19 22:48:45 2021 +0100
Replace ST_AsKML deprecated signatures drop with Replaces comments
Includes regression test
diff --git a/postgis/geography.sql.in b/postgis/geography.sql.in
index 7d7b6da5f..90ca01723 100644
--- a/postgis/geography.sql.in
+++ b/postgis/geography.sql.in
@@ -452,6 +452,7 @@ CREATE OR REPLACE FUNCTION ST_AsGML(text)
-- AsKML(geography,precision)
-- Changed: 2.0.0 to use default args and named args
+-- Replaces ST_AsKML(geography, int4) deprecated in 2.0.0
CREATE OR REPLACE FUNCTION ST_AsKML(geog geography, maxdecimaldigits int4 DEFAULT 15, nprefix text DEFAULT '')
RETURNS text
AS 'MODULE_PATHNAME','geography_as_kml'
diff --git a/postgis/postgis.sql.in b/postgis/postgis.sql.in
index 0beca01aa..5c8ef4c2b 100644
--- a/postgis/postgis.sql.in
+++ b/postgis/postgis.sql.in
@@ -4789,6 +4789,7 @@ CREATE OR REPLACE FUNCTION ST_AsGML(version int4, geom geometry, maxdecimaldigit
-- Availability: 1.2.2
-- Changed: 2.0.0 to use default args and allow named args
+-- Replaces ST_AsKML(geometry, int4) deprecated in 2.0.0
CREATE OR REPLACE FUNCTION ST_AsKML(geom geometry, maxdecimaldigits int4 DEFAULT 15, nprefix TEXT default '')
RETURNS TEXT
AS 'MODULE_PATHNAME','LWGEOM_asKML'
diff --git a/postgis/postgis_after_upgrade.sql b/postgis/postgis_after_upgrade.sql
index a7b929ffd..bab8d358e 100644
--- a/postgis/postgis_after_upgrade.sql
+++ b/postgis/postgis_after_upgrade.sql
@@ -197,7 +197,6 @@ DROP FUNCTION IF EXISTS ST_Distance(geography, geography, float8, boolean);
DROP FUNCTION IF EXISTS ST_Buffer(geometry, float8, cstring);
DROP FUNCTION IF EXISTS ST_IsValidDetail(geometry);
DROP FUNCTION IF EXISTS ST_AsKML(int4, geometry, int4, text);
-DROP FUNCTION IF EXISTS ST_AsKML(geometry, int4);
DROP FUNCTION IF EXISTS ST_AsGeoJson(int4, geometry, int4, int4);
DROP FUNCTION IF EXISTS _ST_AsGeoJson(int4, geometry, int4, int4);
diff --git a/postgis/postgis_before_upgrade.sql b/postgis/postgis_before_upgrade.sql
index 3ba6956bf..ea84c524f 100644
--- a/postgis/postgis_before_upgrade.sql
+++ b/postgis/postgis_before_upgrade.sql
@@ -195,12 +195,6 @@ SELECT _postgis_drop_function_if_needed
);
--- FUNCTION st_askml changed to add defaults in 3.0 / r17357
--- These signatures were superseeded
-DROP FUNCTION IF EXISTS st_askml(geometry, integer); -- Does not conflict
-DROP FUNCTION IF EXISTS st_askml(geography, integer); -- Does not conflict
-
-
-- FUNCTION st_buffer changed to add defaults in 3.0
-- This signature was superseeded
DROP FUNCTION IF EXISTS st_buffer(geometry, double precision); -- Does not conflict
diff --git a/regress/hooks/hook-after-upgrade.sql b/regress/hooks/hook-after-upgrade.sql
index daf31951d..3caffb063 100644
--- a/regress/hooks/hook-after-upgrade.sql
+++ b/regress/hooks/hook-after-upgrade.sql
@@ -3,4 +3,5 @@ DROP VIEW IF EXISTS upgrade_view_test_unaryunion;
DROP VIEW IF EXISTS upgrade_view_test_subdivide;
DROP VIEW IF EXISTS upgrade_view_test_union;
DROP VIEW IF EXISTS upgrade_view_test_force_dims;
+DROP VIEW IF EXISTS upgrade_view_test_askml;
DROP TABLE upgrade_test;
diff --git a/regress/hooks/hook-before-upgrade.sql b/regress/hooks/hook-before-upgrade.sql
index 07c54dda1..e5e541888 100644
--- a/regress/hooks/hook-before-upgrade.sql
+++ b/regress/hooks/hook-before-upgrade.sql
@@ -58,3 +58,11 @@ SELECT
ST_Force3DM(g1) as geometry_force3dm,
ST_Force4D(g1) as geometry_force4d
FROM upgrade_test;
+
+-- Add view using ST_AsKML function
+-- NOTE: 2.0.0 changed them to add default params
+CREATE VIEW upgrade_view_test_askml AS
+SELECT
+ ST_AsKML(g1) as geometry_askml,
+ ST_AsKML(g2) as geography_askml
+FROM upgrade_test;
-----------------------------------------------------------------------
Summary of changes:
doc/reference_output.xml | 15 ++++++---------
postgis/geography.sql.in | 1 +
postgis/postgis.sql.in | 1 +
postgis/postgis_after_upgrade.sql | 1 -
postgis/postgis_before_upgrade.sql | 6 ------
regress/hooks/hook-after-upgrade.sql | 1 +
regress/hooks/hook-before-upgrade.sql | 8 ++++++++
7 files changed, 17 insertions(+), 16 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list