From: Sandro Santilli <strk@keybit.net>
Date: Mon, 14 Jul 2014 14:36:55 +0000 (+0000)
Subject: Add note about extent ratainment in ST_Resize, cross link docs
X-Git-Tag: 2.2.0rc1~980
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ef613f89c6323d57feeaff0f36a57a39148de5db;p=postgis

Add note about extent ratainment in ST_Resize, cross link docs

Closes #2833

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

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index 36882ccca..e75f21c4c 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -5974,7 +5974,11 @@ FROM (
 
 			<refsection>
 				<title>See Also</title>
-				<para><xref linkend="RT_ST_Rescale" />, <xref linkend="RT_ST_Transform" /></para>
+				<para>
+					<xref linkend="RT_ST_Rescale" />,
+					<xref linkend="RT_ST_Resize" />,
+					<xref linkend="RT_ST_Transform" />
+				</para>
 			</refsection>
 		</refentry>
 		
@@ -6014,7 +6018,7 @@ FROM (
 				
 				<para><varname>scalex</varname> and <varname>scaley</varname> define the new pixel size. scaley must often be negative to get well oriented raster.</para>
 				
-				<para>When the new scalex or scaley is not a divisor of the raster width or height, the extent of the resulting raster is expanded to encompass the extent of the provided raster.</para>
+				<para>When the new scalex or scaley is not a divisor of the raster width or height, the extent of the resulting raster is expanded to encompass the extent of the provided raster. If you want to be sure to retain exact input extent see <xref linkend="RT_ST_Resize" /></para>
 				
 				<para>A maxerror percent of 0.125 is used if no <varname>maxerr</varname> is specified.</para>
 				
@@ -6048,7 +6052,14 @@ SELECT ST_PixelWidth(ST_Rescale(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 0.
 
 			<refsection>
 				<title>See Also</title>
-				<para><xref linkend="RT_ST_SetScale" />, <xref linkend="RT_ST_ScaleX" />, <xref linkend="RT_ST_ScaleY" />, <xref linkend="RT_ST_Resample" />, <xref linkend="RT_ST_Transform" /></para>
+				<para>
+					<xref linkend="RT_ST_Resize" />,
+					<xref linkend="RT_ST_Resample" />,
+					<xref linkend="RT_ST_SetScale" />,
+					<xref linkend="RT_ST_ScaleX" />,
+					<xref linkend="RT_ST_ScaleY" />,
+					<xref linkend="RT_ST_Transform" />
+				</para>
 			</refsection>
 		</refentry>
 		
@@ -6244,7 +6255,7 @@ SELECT ST_UpperLeftX(ST_SnapToGrid(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0
 				<title>Description</title>
 
 				<para>
-					Resize a raster to a new width/height.  The new width/height can be specified in exact number of pixels or a percentage of the raster's width/height.
+					Resize a raster to a new width/height. The new width/height can be specified in exact number of pixels or a percentage of the raster's width/height. The extent of the the new raster will be the same as the extent of the provided raster.
 				</para>
 
 				<para>