From 7e4c22248a4734dda15e34dd88822c6a927b9dda Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Tue, 6 Dec 2011 14:40:21 +0000
Subject: [PATCH] put some obsolete notes in existing management functions. 
 Now that raster_columns is a view no longer need to use management functions
 to drop or add raster columns or tables.  Will document the new
 addconstraints etc. taht replaces much of these soon.

git-svn-id: http://svn.osgeo.org/postgis/trunk@8308 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/reference_raster.xml | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index 9b26a7a42..505e9b966 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -461,7 +461,7 @@ VALUES (1,
 	  <refnamediv>
 		<refname>AddRasterColumn</refname>
 
-		<refpurpose>Adds a raster column to an existing table and generates column constraint on the new column to enforce srid.</refpurpose>
+		<refpurpose>deprecated: Adds a raster column to an existing table and generates column constraint on the new column to enforce srid.</refpurpose>
 	  </refnamediv>
 
 	  <refsynopsisdiv>
@@ -611,8 +611,8 @@ VALUES (1,
 		<para><varname>raster2pgsql.py</varname> loader uses this function to register raster tables</para>
 
 		<note>
-			<para>Views and derivatively created spatial tables will need to be registered in raster_columns manually,
-				since AddRasterColumn also adds a raster column which is not needed when you already have a raster column.  
+			<para>This function is deprecated and will be removed in later versions.  Instead just create a raster column
+				using <programlisting>CREATE TABLE .. or ALTER TABLE .. ADD COLUMN rast raster;</programlisting> and then use the AddRasterConstraints function.
 			</para>
 		</note>
 	  </refsection>
@@ -651,7 +651,7 @@ UPDATE raster_columns SET extent = (SELECT ST_Union(ST_Envelope(rast)) FROM myra
 	  <refnamediv>
 		<refname>DropRasterColumn</refname>
 
-		<refpurpose>Removes a raster column from a table.</refpurpose>
+		<refpurpose>Obsolete: just use sql ALTER TABLE DROP COLUMN: Removes a raster column from a table.</refpurpose>
 	  </refnamediv>
 
 	  <refsynopsisdiv>
@@ -700,18 +700,20 @@ UPDATE raster_columns SET extent = (SELECT ST_Union(ST_Envelope(rast)) FROM myra
 	  <refsection>
 		<title>Description</title>
 
-		<para>Removes a raster column from a table. Note that
-		schema_name will need to match the r_table_schema field of the table's
-		row in the raster_columns table.</para>
+		<para><note>Obsolete and will be removed in later versions.  Instead just drop the column using standard SQL.</note></para>
 	  </refsection>
 	  <refsection>
 		<title>Examples</title>
 
 		<programlisting>
-			SELECT DropRasterColumn ('my_schema','my_raster_table','rast');
-			----RESULT output ---
-			my_schema.my_raster_table.rast effectively removed.
+-- NOTE this is obsolete
+SELECT DropRasterColumn ('my_schema','my_raster_table','rast');
+----RESULT output ---
+my_schema.my_raster_table.rast effectively removed.
 		</programlisting>
+		
+		<programlisting>-- Instead do --
+ALTER TABLE my_schema.my_raster_table DROP COLUMN rast;</programlisting>
 	  </refsection>
 	  <refsection>
 		<title>See Also</title>
@@ -724,7 +726,7 @@ UPDATE raster_columns SET extent = (SELECT ST_Union(ST_Envelope(rast)) FROM myra
 	  <refnamediv>
 		<refname>DropRasterTable</refname>
 
-		<refpurpose>Drops a table and all its references in
+		<refpurpose>Obsolete: Instead use DROP TABLE mytable. Drops a table and all its references in
 		raster_columns.</refpurpose>
 	  </refnamediv>
 
-- 
2.40.0