From 1cf549f70a0ebc5d83bdb1f358e5d7099103ea6c Mon Sep 17 00:00:00 2001
From: Bborie Park <bkpark at ucdavis.edu>
Date: Thu, 20 Jun 2013 15:57:59 +0000
Subject: [PATCH] Added docs regarding postgis.gdal.datapath GUC and
 postgis_gdal_version()

git-svn-id: http://svn.osgeo.org/postgis/trunk@11556 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/reference_raster.xml | 102 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 101 insertions(+), 1 deletion(-)

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index b769a9339..dd330dc94 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -333,6 +333,68 @@ VALUES (1,
 			</refsection>
 		</refentry>
 
+  </sect1>
+
+	<sect1 id="Raster_Config">
+		<sect1info>
+			<abstract>
+				<para>
+					This section lists the configuration variables available to control the behavior of raster functions. 
+				</para>	
+			</abstract>
+		</sect1info>
+
+		<title>Raster Configuration Options</title>
+
+		<refentry id="postgis_gdal_datapath">
+			<refnamediv>
+				<refname>postgis.gdal.datapath</refname>
+				<refpurpose>
+					A configuration option to assign the value of GDAL's GDAL_DATA option.
+				</refpurpose>
+			</refnamediv>
+
+			<refsection>
+				<title>Description</title>
+				<para>
+					A PostgreSQL GUC variable for setting the value of GDAL's GDAL_DATA option. The <varname>postgis.gdal.datapath</varname> value should be the complete physical path to GDAL's data files.
+				</para>
+				<para>
+					This configuration option is of most use for Windows platforms where GDAL's data files path is not hard-coded. This option should also be set when GDAL's data files are not located in GDAL's expected path.
+				</para>
+
+				<note>
+					<para>
+						This option can be set in PostgreSQL's configuration file postgresql.conf. It can also be set by connection or transaction.
+					</para>
+				</note>
+
+				<note>
+					<para>
+						Additional information about GDAL_DATA is available at GDAL's <ulink url="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</ulink>.
+					</para>
+				</note>
+
+			</refsection>
+
+			<refsection>
+				<title>Examples</title>
+				<para>Set and reset <varname>postgis.gdal.datapath</varname></para>
+
+				<programlisting>
+SET postgis.gdal.datapath TO '/usr/local/share/gdal.hidden';
+SET postgis.gdal.datapath TO default;
+				</programlisting>
+			</refsection>
+
+			<refsection>
+				<title>See Also</title>
+				<para>
+					<xref linkend="RT_PostGIS_GDAL_Version" />
+				</para>
+			</refsection>
+		</refentry>
+
   </sect1>
 
   <sect1 id="Raster_Management_Functions">
@@ -704,6 +766,44 @@ SELECT srid, scale_x, scale_y, blocksize_x, blocksize_y, num_bands, pixel_types,
 	  </refsection>
 	</refentry>
 	
+		<refentry id="RT_PostGIS_GDAL_Version">
+			<refnamediv>
+				<refname>PostGIS_GDAL_Version</refname>
+				<refpurpose>Reports the version of the GDAL library in use by PostGIS.</refpurpose>
+			</refnamediv>
+
+			<refsynopsisdiv>
+				<funcsynopsis>
+					<funcprototype>
+						<funcdef>text <function>PostGIS_GDAL_Version</function></funcdef> 
+						<paramdef></paramdef>
+					</funcprototype>
+				</funcsynopsis>
+			</refsynopsisdiv>
+
+			<refsection>
+				<title>Description</title>
+				<para>Reports the version of the GDAL library in use by PostGIS. Will also check and report if GDAL can find its data files.</para>
+			</refsection>
+
+			<refsection>
+				<title>Examples</title>
+				<programlisting>
+SELECT PostGIS_GDAL_Version();
+       postgis_gdal_version        
+-----------------------------------
+ GDAL 1.11dev, released 2013/04/13
+				</programlisting>
+			</refsection>
+
+			<refsection>
+				<title>See Also</title>
+				<para>
+					<xref linkend="postgis_gdal_datapath" />
+				</para>
+			</refsection>
+		</refentry>
+
 	<refentry id="RT_PostGIS_Raster_Lib_Build_Date">
 	  <refnamediv>
 		<refname>PostGIS_Raster_Lib_Build_Date</refname>
@@ -787,7 +887,7 @@ postgis_raster_lib_version
 	  </refsection>
 	  
 	</refentry>
-	
+
 	<refentry id="RT_ST_GDALDrivers">
 	  <refnamediv>
 		<refname>ST_GDALDrivers</refname>
-- 
2.50.1