<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
                    "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [

<!-- This value is automatically generated by the Makefile -->
<!ENTITY last_release_version "@@LAST_RELEASE_VERSION@@">
<!ENTITY last_minor_version "3.1">

<!-- ONCE Tagged, this need to change to http://download.osgeo.org/postgis/source/postgis-@@LAST_RELEASE_VERSION@@.tar.gz -->
<!-- In dev should be, this need to change to http://postgis.net/stuff/postgis-@@LAST_RELEASE_VERSION@@.tar.gz -->
<!ENTITY postgis_download_url "@@POSTGIS_DOWNLOAD_URL@@/postgis-@@LAST_RELEASE_VERSION@@.tar.gz">

<!-- Change these values to update the version numbers referenced within the documentation -->
<!ENTITY last_proj_release_version "7.0.1">
<!ENTITY last_geos_release_version "3.8.1">
<!ENTITY min_postgres_version "9.6">

<!ENTITY introduction SYSTEM "introduction.xml">
<!ENTITY installation SYSTEM "installation.xml">
<!ENTITY administration SYSTEM "administration.xml">
<!ENTITY using_postgis_dataman SYSTEM "using_postgis_dataman.xml">
<!ENTITY using_postgis_query SYSTEM "using_postgis_query.xml">
<!ENTITY using_raster_dataman SYSTEM "using_raster_dataman.xml">
<!ENTITY using_postgis_app SYSTEM "using_postgis_app.xml">
<!ENTITY performance_tips SYSTEM "performance_tips.xml">
<!ENTITY database_tuning SYSTEM "database_tuning.xml">
<!ENTITY faq SYSTEM "faq.xml">
<!ENTITY reference SYSTEM "reference.xml">
<!ENTITY postgis_aggs_mm SYSTEM "postgis_aggs_mm.xml">
<!ENTITY reporting SYSTEM "reporting.xml">
<!ENTITY release_notes SYSTEM "release_notes.xml">
<!ENTITY reference_type SYSTEM "reference_type.xml">
<!ENTITY reference_guc SYSTEM "reference_guc.xml">
<!ENTITY reference_management SYSTEM "reference_management.xml">
<!ENTITY reference_cluster SYSTEM "reference_cluster.xml">
<!ENTITY reference_constructor SYSTEM "reference_constructor.xml">
<!ENTITY reference_accessor SYSTEM "reference_accessor.xml">
<!ENTITY reference_bbox SYSTEM "reference_bbox.xml">
<!ENTITY reference_editor SYSTEM "reference_editor.xml">
<!ENTITY reference_input SYSTEM "reference_input.xml">
<!ENTITY reference_output SYSTEM "reference_output.xml">
<!ENTITY reference_operator SYSTEM "reference_operator.xml">
<!ENTITY reference_measure SYSTEM "reference_measure.xml">
<!ENTITY reference_relationship SYSTEM "reference_relationship.xml">
<!ENTITY reference_sfcgal SYSTEM "reference_sfcgal.xml">
<!ENTITY reference_overlay SYSTEM "reference_overlay.xml">
<!ENTITY reference_processing SYSTEM "reference_processing.xml">
<!ENTITY reference_lrs SYSTEM "reference_lrs.xml">
<!ENTITY reference_srs SYSTEM "reference_srs.xml">
<!ENTITY reference_trajectory SYSTEM "reference_trajectory.xml">
<!ENTITY reference_transaction SYSTEM "reference_transaction.xml">
<!ENTITY reference_transformation SYSTEM "reference_transformation.xml">
<!ENTITY reference_misc SYSTEM "reference_misc.xml">
<!ENTITY reference_troubleshooting SYSTEM "reference_troubleshooting.xml">
<!ENTITY reference_validation SYSTEM "reference_validation.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">
<!ENTITY extras_topology SYSTEM "extras_topology.xml">
<!ENTITY extras_tigergeocoder SYSTEM "extras_tigergeocoder.xml">
<!ENTITY extras_historytable SYSTEM "extras_historytable.xml">
<!ENTITY extras_address_standardizer SYSTEM "extras_address_standardizer.xml">

<!ENTITY sfs_compliant
"<inlinemediaobject>
   <imageobject><imagedata fileref='images/check.png' /></imageobject>
 </inlinemediaobject>
 This method implements the <ulink
 url='http://www.opengeospatial.org/standards/sfs'>OGC Simple Features
 Implementation Specification for SQL 1.1.</ulink>">

<!ENTITY sqlmm_compliant
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject> This method implements the SQL/MM specification.">

<!ENTITY sfcgal_enhanced
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject> This method is also provided by SFCGAL backend.">

<!ENTITY sfcgal_required
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject> This method needs SFCGAL backend.">

<!ENTITY address_standardizer_required
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject> This method needs address_standardizer extension.">

<!ENTITY curve_support
"<inlinemediaobject>
   <imageobject><imagedata fileref='images/check.png' /></imageobject>
 </inlinemediaobject>
 This method supports Circular Strings and Curves">

<!ENTITY Z_support
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject>
 This function supports 3d and will not drop the z-index.">

<!ENTITY M_support
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject>
 This function supports M coordinates.">

<!ENTITY P_support
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject>
 This function supports Polyhedral surfaces.">

<!ENTITY T_support
"<inlinemediaobject>
   <imageobject>
     <imagedata fileref='images/check.png' />
   </imageobject>
 </inlinemediaobject>
 This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).">

<!ENTITY index_aware
"This function automatically includes a bounding box comparison
that makes use of any spatial indexes that are available on the geometries.">

]>

<book>
  <title>PostGIS &last_release_version; Manual</title>

  <bookinfo>

	<corpauthor>The PostGIS Development Group</corpauthor>
	<editor>
		<firstname>Paul</firstname>

		<surname>Ramsey</surname>

		<affiliation>
		<orgname><ulink url="http://www.cleverelephant.ca">clever elephant</ulink></orgname>

		<address><city>Victoria</city>
		<state>British Columbia</state> <country>Canada</country>
		<email>pramsey@cleverelephant.ca</email></address>
		</affiliation>
	</editor>


	<productname>PostGIS</productname>
    <productnumber>&last_release_version;</productnumber>

    <abstract>
      <para>PostGIS is an extension to the <ulink url="https://www.postgresql.org/">PostgreSQL</ulink> object-relational
      database system which allows GIS (Geographic Information Systems)
      objects to be stored in the database. PostGIS includes support for
      GiST-based R-Tree spatial indexes, and functions for analysis and
      processing of GIS objects.</para>

      <para><inlinemediaobject><imageobject><imagedata fileref='images/PostGIS_logo.png' /></imageobject></inlinemediaobject>
            <inlinemediaobject><imageobject><imagedata fileref='images/osgeo_logo.png' /></imageobject></inlinemediaobject>
      </para>
      <para>This is the manual for version &last_release_version;</para>
      <para><inlinemediaobject><imageobject><imagedata fileref='images/ccbysa.png' /></imageobject></inlinemediaobject> This work is licensed under a <ulink url="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution-Share Alike 3.0 License</ulink>.
      Feel free to use this material any way you like, but we ask that you attribute credit to the PostGIS Project
      and wherever possible, a link back to <ulink url="http://postgis.net">http://postgis.net</ulink>.</para>
    </abstract>
  </bookinfo>

  &introduction;
  &installation;
  &administration;
  &using_postgis_dataman;
  &using_postgis_query;
  &performance_tips;
  &using_postgis_app;
  &reference;
  &faq;
  &extras_topology;
  &using_raster_dataman;
  &reference_raster;
  &faq_raster;
  &extras;
  &postgis_aggs_mm;
  &reporting;
  &release_notes;

</book>
