reference_accessor.xml \
reference_constructor.xml \
reference_editor.xml \
- reference_exception.xml \
reference_guc.xml \
reference_lrs.xml \
reference_management.xml \
reference_raster.xml \
reference_temporal.xml \
reference_transaction.xml \
+ reference_troubleshooting.xml \
reference_type.xml \
+ reference_version.xml \
reference.xml \
release_notes.xml \
reporting.xml \
<!ENTITY reference_temporal SYSTEM "reference_temporal.xml">
<!ENTITY reference_transaction SYSTEM "reference_transaction.xml">
<!ENTITY reference_misc SYSTEM "reference_misc.xml">
-<!ENTITY reference_exception SYSTEM "reference_exception.xml">
+<!ENTITY reference_troubleshooting SYSTEM "reference_troubleshooting.xml">
+<!ENTITY reference_version SYSTEM "reference_version.xml">
<!ENTITY reference_raster SYSTEM "reference_raster.xml">
<!ENTITY faq_raster SYSTEM "faq_raster.xml">
<!ENTITY extras SYSTEM "extras.xml">
</note>
&reference_type;
- &reference_guc;
&reference_management;
&reference_constructor;
&reference_accessor;
&reference_temporal;
&reference_transaction;
&reference_misc;
- &reference_exception;
+ &reference_version;
+ &reference_guc;
+ &reference_troubleshooting;
</chapter>
<sect1 id="PostGIS_GUC">
<sect1info>
<abstract>
- <para>This section lists custom PostGIS Grand Unified Custom Variables(GUC). These can be set globally, by database, by session or by transaction. Best set at global or database level.</para>
+ <para>This section lists custom PostGIS Grand Unified Custom Variables (GUC).
+These can be set globally, by database, by session or by transaction. Best set at global or database level.</para>
</abstract>
</sect1info>
- <title>PostGIS Grand Unified Custom Variables (GUCs)</title>
+ <title>Grand Unified Custom Variables (GUCs)</title>
<refentry id="postgis_backend">
<refnamediv>
<?xml version="1.0" encoding="UTF-8"?>
<sect1 id="Management_Functions">
- <title>Management Functions</title>
+ <sect1info>
+ <abstract>
+ <para>These functions assist in defining tables containing geometry columns.
+ </para>
+ </abstract>
+ </sect1info>
+
+ <title>Table Management Functions</title>
<refentry id="AddGeometryColumn">
<refnamediv>
</refsection>
</refentry>
-<refentry id="PostGIS_Extensions_Upgrade">
- <refnamediv>
- <refname>PostGIS_Extensions_Upgrade</refname>
-
- <refpurpose>
-Packages and upgrades postgis extensions (e.g. postgis_sfcgal,
-postgis_topology, postgis_sfcgal) to latest available version.
- </refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Extensions_Upgrade</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Packages and upgrades postgis extensions
- to latest version. Only extensions you have installed in the
- database will be packaged and upgraded if needed.
- Reports full postgis version and build configuration infos after.
- This is short-hand for doing multiple CREATE EXTENSION .. FROM
- unpackaged and ALTER EXTENSION .. UPDATE for each postgis extension.
- Currently only tries to upgrade extensions postgis,
- postgis_raster, postgis_sfcgal, postgis_topology, and postgis_tiger_geocoder.</para>
-
- <para>Availability: 2.5.0</para>
- <note>
- <para>Changed: 3.0.0 to repackage loose extensions and support postgis_raster.</para>
- </note>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Extensions_Upgrade();</programlisting>
-<screen>
-NOTICE: Packaging extension postgis
-NOTICE: Packaging extension postgis_raster
-NOTICE: Packaging extension postgis_sfcgal
-NOTICE: Extension postgis_topology is not available or not packagable for some reason
-NOTICE: Extension postgis_tiger_geocoder is not available or not packagable for some reason
-
- postgis_extensions_upgrade
-----------------------------------------------------------------------------------
-POSTGIS="3.0.0dev r16878" [EXTENSION] PGSQL="96"
-GEOS="3.8.0dev-CAPI-1.11.0 a67b6f86" SFCGAL="1.3.5" PROJ="Rel. 4.9.3,
-15 August 2016" GDAL="GDAL 2.3.0dev, released 2017/99/99"
-LIBXML="2.9.4" LIBJSON="0.12.1" LIBPROTOBUF="1.2.1" TOPOLOGY
-[UNPACKAGED!] RASTER
-(1 row)</screen>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para>
- <xref linkend="upgrading" />,
- <xref linkend="PostGIS_GEOS_Version" />,
- <xref linkend="PostGIS_Lib_Version" />,
- <xref linkend="PostGIS_LibXML_Version" />,
- <xref linkend="PostGIS_PROJ_Version" />,
- <xref linkend="PostGIS_Version" />
- </para>
- </refsection>
- </refentry>
-
-
-
- <refentry id="PostGIS_Full_Version">
- <refnamediv>
- <refname>PostGIS_Full_Version</refname>
-
- <refpurpose>Reports full postgis version and build configuration
- infos.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Full_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Reports full postgis version and build configuration
- infos. Also informs about synchronization between
- libraries and scripts suggesting upgrades as needed.</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Full_Version();
- postgis_full_version
-----------------------------------------------------------------------------------
-POSTGIS="3.0.0dev r17211" [EXTENSION] PGSQL="110" GEOS="3.8.0dev-CAPI-1.11.0 df24b6bb" SFCGAL="1.3.6" PROJ="Rel. 5.2.0, September 15th, 2018"
-GDAL="GDAL 2.3.2, released 2018/09/21" LIBXML="2.9.9" LIBJSON="0.13.1" LIBPROTOBUF="1.3.1" WAGYU="0.4.3 (Internal)" TOPOLOGY RASTER
-(1 row)
-</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para>
- <xref linkend="upgrading" />,
- <xref linkend="PostGIS_GEOS_Version" />,
- <xref linkend="PostGIS_Lib_Version" />,
- <xref linkend="PostGIS_LibXML_Version" />,
- <xref linkend="PostGIS_PROJ_Version" />,
- <xref linkend="PostGIS_Wagyu_Version" />,
- <xref linkend="PostGIS_Version" />
- </para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_GEOS_Version">
- <refnamediv>
- <refname>PostGIS_GEOS_Version</refname>
-
- <refpurpose>Returns the version number of the GEOS
- library.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_GEOS_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns the version number of the GEOS library, or
- <varname>NULL</varname> if GEOS support is not enabled.</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_GEOS_Version();
- postgis_geos_version
-----------------------
- 3.1.0-CAPI-1.5.0
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_Lib_Version" />, <xref
- linkend="PostGIS_LibXML_Version" />, <xref
- linkend="PostGIS_PROJ_Version" />, <xref
- linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Liblwgeom_Version">
- <refnamediv>
- <refname>PostGIS_Liblwgeom_Version</refname>
-
- <refpurpose>Returns the version number of the liblwgeom
- library. This should match the version of PostGIS.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Liblwgeom_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns the version number of the liblwgeom library/</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Liblwgeom_Version();
-postgis_liblwgeom_version
---------------------------
-2.3.3 r15473
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_Lib_Version" />, <xref
- linkend="PostGIS_LibXML_Version" />, <xref
- linkend="PostGIS_PROJ_Version" />, <xref
- linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_LibXML_Version">
- <refnamediv>
- <refname>PostGIS_LibXML_Version</refname>
-
- <refpurpose>Returns the version number of the libxml2
- library.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_LibXML_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns the version number of the LibXML2 library.</para>
- <para>Availability: 1.5</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_LibXML_Version();
- postgis_libxml_version
-----------------------
- 2.7.6
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_Lib_Version" />, <xref
- linkend="PostGIS_PROJ_Version" />, <xref
- linkend="PostGIS_GEOS_Version" />, <xref
- linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Lib_Build_Date">
- <refnamediv>
- <refname>PostGIS_Lib_Build_Date</refname>
-
- <refpurpose>Returns build date of the PostGIS library.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Lib_Build_Date</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns build date of the PostGIS library.</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Lib_Build_Date();
- postgis_lib_build_date
-------------------------
- 2008-06-21 17:53:21
-(1 row)</programlisting>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Lib_Version">
- <refnamediv>
- <refname>PostGIS_Lib_Version</refname>
-
- <refpurpose>Returns the version number of the PostGIS
- library.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Lib_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns the version number of the PostGIS library.</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Lib_Version();
- postgis_lib_version
----------------------
- 1.3.3
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_GEOS_Version" />, <xref
- linkend="PostGIS_LibXML_Version" />, <xref
- linkend="PostGIS_PROJ_Version" />, <xref
- linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_PROJ_Version">
- <refnamediv>
- <refname>PostGIS_PROJ_Version</refname>
-
- <refpurpose>Returns the version number of the PROJ4
- library.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_PROJ_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns the version number of the PROJ4 library, or
- <varname>NULL</varname> if PROJ4 support is not enabled.</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_PROJ_Version();
- postgis_proj_version
--------------------------
- Rel. 4.4.9, 29 Oct 2004
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_GEOS_Version" />, <xref
- linkend="PostGIS_Lib_Version" />, <xref
- linkend="PostGIS_LibXML_Version" />, <xref
- linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Wagyu_Version">
- <refnamediv>
- <refname>PostGIS_Wagyu_Version</refname>
-
- <refpurpose>Returns the version number of the internal Wagyu library.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Wagyu_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns the version number of the internal Wagyu library, or
- <varname>NULL</varname> if Wagyu support is not enabled.</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Wagyu_Version();
- postgis_wagyu_version
------------------------
- 0.4.3 (Internal)
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_GEOS_Version" />, <xref
- linkend="PostGIS_PROJ_Version" />, <xref
- linkend="PostGIS_Lib_Version" />, <xref
- linkend="PostGIS_LibXML_Version" />, <xref
- linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Scripts_Build_Date">
- <refnamediv>
- <refname>PostGIS_Scripts_Build_Date</refname>
-
- <refpurpose>Returns build date of the PostGIS scripts.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Scripts_Build_Date</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns build date of the PostGIS scripts.</para>
-
- <para>Availability: 1.0.0RC1</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Scripts_Build_Date();
- postgis_scripts_build_date
--------------------------
- 2007-08-18 09:09:26
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_GEOS_Version" />, <xref
- linkend="PostGIS_Lib_Version" />, <xref
- linkend="PostGIS_LibXML_Version" />, <xref
- linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Scripts_Installed">
- <refnamediv>
- <refname>PostGIS_Scripts_Installed</refname>
-
- <refpurpose>Returns version of the postgis scripts installed in this
- database.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Scripts_Installed</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns version of the postgis scripts installed in this
- database.</para>
-
- <note>
- <para>If the output of this function doesn't match the output of
- <xref linkend="PostGIS_Scripts_Released" />
- you probably missed to properly upgrade an existing database.
- See the <link linkend="upgrading">Upgrading</link> section for
- more info.</para>
- </note>
-
- <para>Availability: 0.9.0</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Scripts_Installed();
- postgis_scripts_installed
--------------------------
- 1.5.0SVN
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref linkend="PostGIS_Scripts_Released" />, <xref linkend="PostGIS_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Scripts_Released">
- <refnamediv>
- <refname>PostGIS_Scripts_Released</refname>
-
- <refpurpose>Returns the version number of the postgis.sql script
- released with the installed postgis lib.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Scripts_Released</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns the version number of the postgis.sql script
- released with the installed postgis lib.</para>
-
- <note>
- <para>Starting with version 1.1.0 this function returns the same
- value of <xref linkend="PostGIS_Lib_Version" />. Kept
- for backward compatibility.</para>
- </note>
-
- <para>Availability: 0.9.0</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Scripts_Released();
- postgis_scripts_released
--------------------------
- 1.3.4SVN
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref linkend="PostGIS_Scripts_Installed" />, <xref linkend="PostGIS_Lib_Version" /></para>
- </refsection>
- </refentry>
-
- <refentry id="PostGIS_Version">
- <refnamediv>
- <refname>PostGIS_Version</refname>
-
- <refpurpose>Returns PostGIS version number and compile-time
- options.</refpurpose>
- </refnamediv>
-
- <refsynopsisdiv>
- <funcsynopsis>
- <funcprototype>
- <funcdef>text <function>PostGIS_Version</function></funcdef>
-
- <paramdef></paramdef>
- </funcprototype>
- </funcsynopsis>
- </refsynopsisdiv>
-
- <refsection>
- <title>Description</title>
-
- <para>Returns PostGIS version number and compile-time options.</para>
- </refsection>
-
- <refsection>
- <title>Examples</title>
-
- <programlisting>SELECT PostGIS_Version();
- postgis_version
----------------------------------------
- 1.3 USE_GEOS=1 USE_PROJ=1 USE_STATS=1
-(1 row)</programlisting>
- </refsection>
-
- <refsection>
- <title>See Also</title>
-
- <para><xref linkend="PostGIS_Full_Version" />, <xref
- linkend="PostGIS_GEOS_Version" />, <xref
- linkend="PostGIS_Lib_Version" />, <xref
- linkend="PostGIS_LibXML_Version" />, <xref
- linkend="PostGIS_PROJ_Version" /></para>
- </refsection>
- </refentry>
-
<refentry id="Populate_Geometry_Columns">
<refnamediv>
<refname>Populate_Geometry_Columns</refname>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+ <sect1 id="Troubleshooting_Functions">
+ <sect1info>
+ <abstract>
+ <para>These functions are utilities for troubleshooting and repairing geometry data.
+ They are only needed if the geometry data is corrupted in some way,
+ which should never happen under normal circumstances.</para>
+ </abstract>
+ </sect1info>
+ <title>Troubleshooting Functions</title>
+
+ <refentry id="PostGIS_AddBBox">
+ <refnamediv>
+ <refname>PostGIS_AddBBox</refname>
+
+ <refpurpose>Add bounding box to the geometry.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry <function>PostGIS_AddBBox</function></funcdef>
+ <paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Add bounding box to the geometry. This would make bounding
+ box based queries faster, but will increase the size of the
+ geometry.</para>
+
+ <note>
+ <para>Bounding boxes are automatically added to geometries so in general this is not needed
+ unless the generated bounding box somehow becomes corrupted or you have an old install that is lacking bounding boxes. Then you need to drop the old and readd.</para>
+ </note>
+
+ <para>&curve_support;</para>
+ </refsection>
+
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>UPDATE sometable
+ SET the_geom = PostGIS_AddBBox(the_geom)
+ WHERE PostGIS_HasBBox(the_geom) = false;</programlisting>
+ </refsection>
+
+ <!-- Optionally add a "See Also" section -->
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_DropBBox" />, <xref linkend="PostGIS_HasBBox" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_DropBBox">
+ <refnamediv>
+ <refname>PostGIS_DropBBox</refname>
+
+ <refpurpose>Drop the bounding box cache from the geometry.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>geometry <function>PostGIS_DropBBox</function></funcdef>
+ <paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Drop the bounding box cache from the geometry. This reduces
+ geometry size, but makes bounding-box based queries slower. It is also used to drop a corrupt bounding box. A tale-tell sign of a corrupt cached bounding box
+ is when your ST_Intersects and other relation queries leave out geometries that rightfully should return true.</para>
+
+ <note>
+ <para>Bounding boxes are automatically added to geometries and improve speed of queries so in general this is not needed
+ unless the generated bounding box somehow becomes corrupted or you have an old install that is lacking bounding boxes.
+ Then you need to drop the old and readd. This kind of corruption has been observed in 8.3-8.3.6 series whereby cached bboxes were not always recalculated when a geometry changed and upgrading to a newer version without a dump reload will not
+ correct already corrupted boxes. So one can manually correct using below and readd the bbox or do a dump reload.</para>
+ </note>
+
+ <para>&curve_support;</para>
+ </refsection>
+
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>--This example drops bounding boxes where the cached box is not correct
+ --The force to ST_AsBinary before applying Box2D forces a recalculation of the box, and Box2D applied to the table geometry always
+ -- returns the cached bounding box.
+ UPDATE sometable
+ SET the_geom = PostGIS_DropBBox(the_geom)
+ WHERE Not (Box2D(ST_AsBinary(the_geom)) = Box2D(the_geom));
+
+ UPDATE sometable
+ SET the_geom = PostGIS_AddBBox(the_geom)
+ WHERE Not PostGIS_HasBBOX(the_geom);
+
+
+ </programlisting>
+ </refsection>
+
+ <!-- Optionally add a "See Also" section -->
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_AddBBox" />, <xref linkend="PostGIS_HasBBox" />, <xref linkend="Box2D" /></para>
+ </refsection>
+ </refentry>
+
+
+ <refentry id="PostGIS_HasBBox">
+ <refnamediv>
+ <refname>PostGIS_HasBBox</refname>
+
+ <refpurpose>Returns TRUE if the bbox of this geometry is cached, FALSE otherwise.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>boolean <function>PostGIS_HasBBox</function></funcdef>
+ <paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns TRUE if the bbox of this geometry is cached, FALSE
+ otherwise. Use <xref linkend="PostGIS_AddBBox" /> and <xref linkend="PostGIS_DropBBox" /> to control caching.</para>
+
+ <para>&curve_support;</para>
+ </refsection>
+
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT the_geom
+FROM sometable WHERE PostGIS_HasBBox(the_geom) = false;</programlisting>
+ </refsection>
+
+ <!-- Optionally add a "See Also" section -->
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_AddBBox" />, <xref linkend="PostGIS_DropBBox" /></para>
+ </refsection>
+ </refentry>
+
+ </sect1>
<sect1 id="PostGIS_Types">
<sect1info>
<abstract>
- <para>This section lists the PostgreSQL data types installed by PostGIS. Note we describe the casting behavior of these which is very
- important especially when designing your own functions.
+ <para>This section lists the custom PostgreSQL
+ data types installed by PostGIS to represent spatial data.
</para>
- <para>A Cast is when one type is coerced into another type. PostgreSQL
- is unique from most databases in that it allows you to define casting behavior for custom types and the functions used for casting.
- A cast can be specified as automatic in which case, you do not have to do a CAST(myfoo As otherfootype) or myfoo::otherfootype
- if you are feeding it to a function that only works with otherfootype and there is an automatic cast in place for it.
- </para>
- <para>The danger of relying on automatic cast behavior is when you have an overloaded function say one that takes a box2d and one that takes a box3d
- but no geometry. What happens is that both functions are equally good to use with geometry since geometry has an autocast for both
- -- so you end up with an ambiguous function error. To force PostgreSQL to choose, you do a CAST(mygeom As box3d) or mygeom::box3d.</para>
+ <para>Each data type describes its type casting behaviour.
+ A <ulink url="https://www.postgresql.org/docs/current/sql-expressions.html#SQL-SYNTAX-TYPE-CASTS">type cast</ulink> converts values of one data type into another type.
+ PostgreSQL allows defining casting behavior for custom types, along with the functions used to convert type values.
+ Casts can be defined as <emphasis role="bold">automatic</emphasis>.
+ This allows PostgreSQL to automatically convert a function argument to a type supported by the function.
+ Casts can also be specified <emphasis role="bold">explicitly</emphasis>,
+ using the syntax <varname>CAST(myval As sometype)</varname> or <varname>myval::sometype</varname>.
+ This allows avoiding an issue that can occur when using an overloaded function which does not support a given type
+ (for example, one that accepts a box2d or a box3d, but not a geometry.)
+ Since geometry has an automatic cast to both box types, this will produce an "ambiguous function" error.
+ To prevent the error use an explicit cast to the desired box type.</para>
- <para><emphasis>At least as of PostgreSQL 8.3</emphasis> - Everything can be CAST to text (presumably because of the magical unknown type), so no defined CASTS for that need to be present for you to CAST an object to text.</para>
+ <para>All data types can be CAST to <varname>text</varname>, so these do not need to be specified explicitly.</para>
</abstract>
</sect1info>
- <title>PostgreSQL PostGIS Geometry/Geography/Box Types</title>
+ <title>PostGIS Geometry/Geography/Box Data Types</title>
<refentry id="box2d_type">
<refnamediv>
<refname>box2d</refname>
- <refpurpose>A box composed of x min, ymin, xmax, ymax. Often used to return the 2d enclosing box of a geometry. </refpurpose>
+ <refpurpose>A 2-dimensional bounding box.
+ Often used to describe the 2D extent of a geometry or collection of geometries. </refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
- <para>box2d is a spatial data type used to represent the enclosing box of a geometry or set of geometries. ST_Extent in earlier versions prior to PostGIS 1.4 would return a box2d.</para>
+ <para><varname>box2d</varname> is a spatial data type used to represent
+ the two-dimensional enclosing box of a geometry or collection of geometries.
+ For example, the <xref linkend="ST_Extent" /> aggregate function returns a <varname>box2d</varname> object.</para>
+ <para>The representation contains the values <varname>xmin, ymin, xmax, ymax</varname>.
+ These are the minimum and maxium values of the X and Y extents.
+ </para>
</refsection>
+
+ <refsection>
+ <title>See Also</title>
+ <para><xref linkend="PostGIS_BoxFunctions" /></para>
+ </refsection>
</refentry>
+
<refentry id="box3d_type">
<refnamediv>
<refname>box3d</refname>
- <refpurpose>A box composed of x min, ymin, zmin, xmax, ymax, zmax. Often used to return the 3d extent of a geometry or collection of geometries. </refpurpose>
+ <refpurpose>A 3-dimensional bounding box.
+ Often used to describe the 3D extent of a geometry or collection of geometries. </refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
- <para>box3d is a postgis spatial data type used to represent the enclosing box of a geometry or set of geometries. ST_3DExtent returns a box3d object.</para>
+ <para><varname>box3d</varname> is a postgis spatial data type used to represent
+ the three-dimensional enclosing box of a geometry or collection of geometries.
+ For example, the <xref linkend="ST_3DExtent" /> aggregate function returns a <varname>box3d</varname> object.
+ </para>
+ <para>The representation contains the values <varname>xmin, ymin, zmin, xmax, ymax, zmax</varname>.
+ These are the minimum and maxium values of the X, Y and Z extents.
+ </para>
</refsection>
<refsection>
</tgroup>
</informaltable>
</refsection>
+
+ <refsection>
+ <title>See Also</title>
+ <para><xref linkend="PostGIS_BoxFunctions" /></para>
+ </refsection>
+
</refentry>
<refentry id="geometry">
<refnamediv>
<refname>geometry</refname>
- <refpurpose>Planar spatial data type.</refpurpose>
+ <refpurpose>The type representing spatial features with planar coordinate systems.</refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
- <para>geometry is a fundamental PostGIS spatial data type used to represent a feature in the Euclidean coordinate system.</para>
- <para>All spatial operations on geometry are using units of the Spatial Reference System the geomtry is in.</para>
+ <para><varname>geometry</varname> is a fundamental PostGIS spatial data type used to represent a feature in planar (Euclidean) coordinate systems.</para>
+ <para>All spatial operations on geometry use the units of the Spatial Reference System the geometry is in.</para>
</refsection>
<refsection>
<refsection>
<title>See Also</title>
- <para><xref linkend="RefObject" /></para>
+ <para><xref linkend="RefObject" />, <xref linkend="PostGIS_SQLMM_Functions" /></para>
</refsection>
</refentry>
<refentry id="geometry_dump">
<refnamediv>
<refname>geometry_dump</refname>
- <refpurpose>A spatial datatype with two fields - geom (holding a geometry object)
- and path[] (a 1-d array holding the position of the geometry within the dumped object.)</refpurpose>
+ <refpurpose>A composite type used to describe the parts of complex geometry.</refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
- <para>geometry_dump is a compound data type consisting of a geometry object referenced by the .geom field
- and path[] a 1-dimensional integer array (starting at 1 e.g. path[1] to get first element) array that defines the navigation path within the dumped geometry to find this element.
- It is used by the ST_Dump* family of functions as an output type to explode a more complex geometry into its
- constituent parts and location of parts.</para>
+ <para><varname>geometry_dump</varname> is a
+ <ulink url="https://www.postgresql.org/docs/current/rowtypes.html">composite data type</ulink>
+ containing the fields:</para>
+ <itemizedlist>
+ <listitem>
+ <para><varname>geom</varname> - a references to a component geometry</para>
+ </listitem>
+ <listitem>
+ <para><varname>path[]</varname> - a 1-dimensional integer array
+ that defines the navigation path within the dumped geometry to the <varname>geom</varname> component.
+ The path array starts at 1 (e.g. <varname>path[1]</varname> is the first element.)</para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ It is used by the <varname>ST_Dump*</varname> family of functions as an output type to explode a complex geometry into its
+ constituent parts.</para>
</refsection>
<refsection>
<title>See Also</title>
<refentry id="geography">
<refnamediv>
<refname>geography</refname>
- <refpurpose>Ellipsoidal spatial data type.</refpurpose>
+ <refpurpose>The type representing spatial features with geodetic (ellipsoidal) coordinate systems.</refpurpose>
</refnamediv>
<refsection>
<title>Description</title>
- <para>geography is a spatial data type used to represent a feature in the round-earth coordinate system.</para>
+ <para><varname>geography</varname> is a spatial data type used to represent a feature in geodetic coordinate systems.
+ Geodetic coordinate systems model the earth using an ellipsoid.
+ </para>
+ <para>
+ Spatial operations on the geography type provide more accurate results
+ by taking the ellipsoidal model into account.
+ </para>
</refsection>
<refsection>
<refsection>
<title>See Also</title>
- <para><xref linkend="PostGIS_GeographyFunctions" />, <xref linkend="PostGIS_Geography" /></para>
+ <para><xref linkend="PostGIS_Geography" />, <xref linkend="PostGIS_GeographyFunctions" /></para>
</refsection>
</refentry>
</sect1>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+ <sect1 id="Version_Functions">
+ <sect1info>
+ <abstract>
+ <para>These functions report and upgrade PostGIS versions.
+ </para>
+ </abstract>
+ </sect1info>
+
+ <title>Version Functions</title>
+
+<refentry id="PostGIS_Extensions_Upgrade">
+ <refnamediv>
+ <refname>PostGIS_Extensions_Upgrade</refname>
+
+ <refpurpose>
+Packages and upgrades postgis extensions (e.g. postgis_raster,
+postgis_topology, postgis_sfcgal) to latest available version.
+ </refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Extensions_Upgrade</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Packages and upgrades postgis extensions
+ to latest version. Only extensions you have installed in the
+ database will be packaged and upgraded if needed.
+ Reports full postgis version and build configuration infos after.
+ This is short-hand for doing multiple CREATE EXTENSION .. FROM
+ unpackaged and ALTER EXTENSION .. UPDATE for each postgis extension.
+ Currently only tries to upgrade extensions postgis,
+ postgis_raster, postgis_sfcgal, postgis_topology, and postgis_tiger_geocoder.</para>
+
+ <para>Availability: 2.5.0</para>
+ <note>
+ <para>Changed: 3.0.0 to repackage loose extensions and support postgis_raster.</para>
+ </note>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Extensions_Upgrade();</programlisting>
+<screen>
+NOTICE: Packaging extension postgis
+NOTICE: Packaging extension postgis_raster
+NOTICE: Packaging extension postgis_sfcgal
+NOTICE: Extension postgis_topology is not available or not packagable for some reason
+NOTICE: Extension postgis_tiger_geocoder is not available or not packagable for some reason
+
+ postgis_extensions_upgrade
+----------------------------------------------------------------------------------
+POSTGIS="3.0.0dev r16878" [EXTENSION] PGSQL="96"
+GEOS="3.8.0dev-CAPI-1.11.0 a67b6f86" SFCGAL="1.3.5" PROJ="Rel. 4.9.3,
+15 August 2016" GDAL="GDAL 2.3.0dev, released 2017/99/99"
+LIBXML="2.9.4" LIBJSON="0.12.1" LIBPROTOBUF="1.2.1" TOPOLOGY
+[UNPACKAGED!] RASTER
+(1 row)</screen>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para>
+ <xref linkend="upgrading" />,
+ <xref linkend="PostGIS_GEOS_Version" />,
+ <xref linkend="PostGIS_Lib_Version" />,
+ <xref linkend="PostGIS_LibXML_Version" />,
+ <xref linkend="PostGIS_PROJ_Version" />,
+ <xref linkend="PostGIS_Version" />
+ </para>
+ </refsection>
+ </refentry>
+
+
+
+ <refentry id="PostGIS_Full_Version">
+ <refnamediv>
+ <refname>PostGIS_Full_Version</refname>
+
+ <refpurpose>Reports full postgis version and build configuration
+ infos.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Full_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Reports full postgis version and build configuration
+ infos. Also informs about synchronization between
+ libraries and scripts suggesting upgrades as needed.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Full_Version();
+ postgis_full_version
+----------------------------------------------------------------------------------
+POSTGIS="3.0.0dev r17211" [EXTENSION] PGSQL="110" GEOS="3.8.0dev-CAPI-1.11.0 df24b6bb" SFCGAL="1.3.6" PROJ="Rel. 5.2.0, September 15th, 2018"
+GDAL="GDAL 2.3.2, released 2018/09/21" LIBXML="2.9.9" LIBJSON="0.13.1" LIBPROTOBUF="1.3.1" WAGYU="0.4.3 (Internal)" TOPOLOGY RASTER
+(1 row)
+</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para>
+ <xref linkend="upgrading" />,
+ <xref linkend="PostGIS_GEOS_Version" />,
+ <xref linkend="PostGIS_Lib_Version" />,
+ <xref linkend="PostGIS_LibXML_Version" />,
+ <xref linkend="PostGIS_PROJ_Version" />,
+ <xref linkend="PostGIS_Wagyu_Version" />,
+ <xref linkend="PostGIS_Version" />
+ </para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_GEOS_Version">
+ <refnamediv>
+ <refname>PostGIS_GEOS_Version</refname>
+
+ <refpurpose>Returns the version number of the GEOS
+ library.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_GEOS_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns the version number of the GEOS library, or
+ <varname>NULL</varname> if GEOS support is not enabled.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_GEOS_Version();
+ postgis_geos_version
+----------------------
+ 3.1.0-CAPI-1.5.0
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_Lib_Version" />, <xref
+ linkend="PostGIS_LibXML_Version" />, <xref
+ linkend="PostGIS_PROJ_Version" />, <xref
+ linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Liblwgeom_Version">
+ <refnamediv>
+ <refname>PostGIS_Liblwgeom_Version</refname>
+
+ <refpurpose>Returns the version number of the liblwgeom
+ library. This should match the version of PostGIS.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Liblwgeom_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns the version number of the liblwgeom library/</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Liblwgeom_Version();
+postgis_liblwgeom_version
+--------------------------
+2.3.3 r15473
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_Lib_Version" />, <xref
+ linkend="PostGIS_LibXML_Version" />, <xref
+ linkend="PostGIS_PROJ_Version" />, <xref
+ linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_LibXML_Version">
+ <refnamediv>
+ <refname>PostGIS_LibXML_Version</refname>
+
+ <refpurpose>Returns the version number of the libxml2
+ library.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_LibXML_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns the version number of the LibXML2 library.</para>
+ <para>Availability: 1.5</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_LibXML_Version();
+ postgis_libxml_version
+----------------------
+ 2.7.6
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_Lib_Version" />, <xref
+ linkend="PostGIS_PROJ_Version" />, <xref
+ linkend="PostGIS_GEOS_Version" />, <xref
+ linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Lib_Build_Date">
+ <refnamediv>
+ <refname>PostGIS_Lib_Build_Date</refname>
+
+ <refpurpose>Returns build date of the PostGIS library.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Lib_Build_Date</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns build date of the PostGIS library.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Lib_Build_Date();
+ postgis_lib_build_date
+------------------------
+ 2008-06-21 17:53:21
+(1 row)</programlisting>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Lib_Version">
+ <refnamediv>
+ <refname>PostGIS_Lib_Version</refname>
+
+ <refpurpose>Returns the version number of the PostGIS
+ library.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Lib_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns the version number of the PostGIS library.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Lib_Version();
+ postgis_lib_version
+---------------------
+ 1.3.3
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_GEOS_Version" />, <xref
+ linkend="PostGIS_LibXML_Version" />, <xref
+ linkend="PostGIS_PROJ_Version" />, <xref
+ linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_PROJ_Version">
+ <refnamediv>
+ <refname>PostGIS_PROJ_Version</refname>
+
+ <refpurpose>Returns the version number of the PROJ4
+ library.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_PROJ_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns the version number of the PROJ4 library, or
+ <varname>NULL</varname> if PROJ4 support is not enabled.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_PROJ_Version();
+ postgis_proj_version
+-------------------------
+ Rel. 4.4.9, 29 Oct 2004
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_GEOS_Version" />, <xref
+ linkend="PostGIS_Lib_Version" />, <xref
+ linkend="PostGIS_LibXML_Version" />, <xref
+ linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Wagyu_Version">
+ <refnamediv>
+ <refname>PostGIS_Wagyu_Version</refname>
+
+ <refpurpose>Returns the version number of the internal Wagyu library.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Wagyu_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns the version number of the internal Wagyu library, or
+ <varname>NULL</varname> if Wagyu support is not enabled.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Wagyu_Version();
+ postgis_wagyu_version
+-----------------------
+ 0.4.3 (Internal)
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_GEOS_Version" />, <xref
+ linkend="PostGIS_PROJ_Version" />, <xref
+ linkend="PostGIS_Lib_Version" />, <xref
+ linkend="PostGIS_LibXML_Version" />, <xref
+ linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Scripts_Build_Date">
+ <refnamediv>
+ <refname>PostGIS_Scripts_Build_Date</refname>
+
+ <refpurpose>Returns build date of the PostGIS scripts.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Scripts_Build_Date</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns build date of the PostGIS scripts.</para>
+
+ <para>Availability: 1.0.0RC1</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Scripts_Build_Date();
+ postgis_scripts_build_date
+-------------------------
+ 2007-08-18 09:09:26
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_GEOS_Version" />, <xref
+ linkend="PostGIS_Lib_Version" />, <xref
+ linkend="PostGIS_LibXML_Version" />, <xref
+ linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Scripts_Installed">
+ <refnamediv>
+ <refname>PostGIS_Scripts_Installed</refname>
+
+ <refpurpose>Returns version of the postgis scripts installed in this
+ database.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Scripts_Installed</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns version of the postgis scripts installed in this
+ database.</para>
+
+ <note>
+ <para>If the output of this function doesn't match the output of
+ <xref linkend="PostGIS_Scripts_Released" />
+ you probably missed to properly upgrade an existing database.
+ See the <link linkend="upgrading">Upgrading</link> section for
+ more info.</para>
+ </note>
+
+ <para>Availability: 0.9.0</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Scripts_Installed();
+ postgis_scripts_installed
+-------------------------
+ 1.5.0SVN
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref linkend="PostGIS_Scripts_Released" />, <xref linkend="PostGIS_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Scripts_Released">
+ <refnamediv>
+ <refname>PostGIS_Scripts_Released</refname>
+
+ <refpurpose>Returns the version number of the postgis.sql script
+ released with the installed postgis lib.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Scripts_Released</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns the version number of the postgis.sql script
+ released with the installed postgis lib.</para>
+
+ <note>
+ <para>Starting with version 1.1.0 this function returns the same
+ value of <xref linkend="PostGIS_Lib_Version" />. Kept
+ for backward compatibility.</para>
+ </note>
+
+ <para>Availability: 0.9.0</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Scripts_Released();
+ postgis_scripts_released
+-------------------------
+ 1.3.4SVN
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref linkend="PostGIS_Scripts_Installed" />, <xref linkend="PostGIS_Lib_Version" /></para>
+ </refsection>
+ </refentry>
+
+ <refentry id="PostGIS_Version">
+ <refnamediv>
+ <refname>PostGIS_Version</refname>
+
+ <refpurpose>Returns PostGIS version number and compile-time
+ options.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>text <function>PostGIS_Version</function></funcdef>
+
+ <paramdef></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Returns PostGIS version number and compile-time options.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT PostGIS_Version();
+ postgis_version
+---------------------------------------
+ 1.3 USE_GEOS=1 USE_PROJ=1 USE_STATS=1
+(1 row)</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+
+ <para><xref linkend="PostGIS_Full_Version" />, <xref
+ linkend="PostGIS_GEOS_Version" />, <xref
+ linkend="PostGIS_Lib_Version" />, <xref
+ linkend="PostGIS_LibXML_Version" />, <xref
+ linkend="PostGIS_PROJ_Version" /></para>
+ </refsection>
+ </refentry>
+
+ </sect1>
projects / postgis / commitdiff