update ST_GDALDrivers example to demonstrate how to enable all drivers and also show...

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 cd2095cd437781e5b535dabbcee006a242bbd65e..43339fb8514ebd6dda117cbbb3ecabf2f93dc752 100644 (file)
--- 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>