From: Regina Obe <lr@pcorp.us>
Date: Tue, 29 Sep 2015 03:14:33 +0000 (+0000)
Subject: update ST_GDALDrivers example to demonstrate how to enable all drivers and also show... 
X-Git-Tag: 2.2.0~69
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7739ecac2d8617d0cd26837c005e4ae27bb41767;p=postgis

update ST_GDALDrivers example to demonstrate how to enable all drivers and also show some cool new offerings in GDAL 2.0

git-svn-id: http://svn.osgeo.org/postgis/trunk@14121 b70326c6-7e19-0410-871a-916f4a2858ee
---

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index cd2095cd4..43339fb85 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -1114,41 +1114,52 @@ postgis_raster_lib_version
 		<para>Returns a list of raster formats short_name,long_name and creator options of each format supported by your lib gdal.  Use the short_name as input in the <varname>format</varname> parameter of <xref linkend="RT_ST_AsGDALRaster" />.
 		Options vary depending on what drivers your libgdal was compiled with. <varname>create_options</varname> returns an xml formatted set of CreationOptionList/Option consisting of name and optional <varname>type</varname>, <varname>description</varname> and set of <varname>VALUE</varname> for each creator option for the specific driver.</para>
 		
+		 <para>Changed: 2.0.6, 2.1.3 - by default no drivers are enabled, unless GUC or Environment variable gdal_enabled_drivers is set.</para>
 		 <para>Availability: 2.0.0 - requires GDAL &gt;= 1.6.0. </para>
+		
 	  </refsection>
 
 	  <refsection>
 		<title>Examples: List of Drivers</title>
 
-		<programlisting>SELECT short_name, long_name
+		<programlisting>SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
+SELECT short_name, long_name
 FROM st_gdaldrivers()
 ORDER BY short_name;
-  short_name    |              long_name
-----------------+--------------------------------------
-AAIGrid         | Arc/Info ASCII Grid
-DTED            | DTED Elevation Raster
-EHdr            | ESRI .hdr Labelled
-FIT             | FIT Image
-GIF             | Graphics Interchange Format (.gif)
-GSAG            | Golden Software ASCII Grid (.grd)
-GSBG            | Golden Software Binary Grid (.grd)
-GTiff           | GeoTIFF
-HF2             | HF2/HFZ heightfield raster
-HFA             | Erdas Imagine Images (.img)
-ILWIS           | ILWIS Raster Map
-INGR            | Intergraph Raster
-JPEG            | JPEG JFIF
-KMLSUPEROVERLAY | Kml Super Overlay
-NITF            | National Imagery Transmission Format
-PNG             | Portable Network Graphics
-R               | R Object Data Store
-SAGA            | SAGA GIS Binary Grid (.sdat)
-SRTMHGT         | SRTMHGT File Format
-USGSDEM         | USGS Optional ASCII DEM (and CDED)
-VRT             | Virtual Raster
-XPM             | X11 PixMap Format
-
-</programlisting>
+   short_name    |              long_name
+-----------------+--------------------------------------
+ AAIGrid         | Arc/Info ASCII Grid
+ ARG             | Azavea Raster Grid format
+ DTED            | DTED Elevation Raster
+ EHdr            | ESRI .hdr Labelled
+ FIT             | FIT Image
+ GIF             | Graphics Interchange Format (.gif)
+ GPKG            | GeoPackage
+ GS7BG           | Golden Software 7 Binary Grid (.grd)
+ GSAG            | Golden Software ASCII Grid (.grd)
+ GSBG            | Golden Software Binary Grid (.grd)
+ GTiff           | GeoTIFF
+ HF2             | HF2/HFZ heightfield raster
+ HFA             | Erdas Imagine Images (.img)
+ ILWIS           | ILWIS Raster Map
+ INGR            | Intergraph Raster
+ JPEG            | JPEG JFIF
+ KMLSUPEROVERLAY | Kml Super Overlay
+ LCP             | FARSITE v.4 Landscape File (.lcp)
+ MFF             | Vexcel MFF Raster
+ NITF            | National Imagery Transmission Format
+ PNG             | Portable Network Graphics
+ R               | R Object Data Store
+ RST             | Idrisi Raster A.1
+ SAGA            | SAGA GIS Binary Grid (.sdat)
+ SRTMHGT         | SRTMHGT File Format
+ USGSDEM         | USGS Optional ASCII DEM (and CDED)
+ VRT             | Virtual Raster
+ WMS             | OGC Web Map Service
+ XPM             | X11 PixMap Format
+ XYZ             | ASCII Gridded XYZ
+ ZMap            | ZMap Plus Grid
+(31 rows)</programlisting>
 </refsection>
 <refsection><title>Example: List of options for each driver</title>
 <programlisting>-- Output the create options XML column of JPEG as a table  --
@@ -1271,7 +1282,7 @@ WHERE short_name = 'GTiff') As g;
 	  <refsection>
 		<title>See Also</title>
 
-		<para><xref linkend="RT_ST_AsGDALRaster" />, <xref linkend="ST_SRID" /> </para>
+		<para><xref linkend="RT_ST_AsGDALRaster" />, <xref linkend="ST_SRID" />, <xref linked="postgis_gdal_enabled_drivers" /> </para>
 	  </refsection>
 	</refentry>