[postgis-tickets] [SCM] PostGIS branch master updated. 3.1.0rc1-508-gf6cbffe

git at osgeo.org git at osgeo.org
Fri Sep 10 11:02:27 PDT 2021


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".

The branch, master has been updated
       via  f6cbffe2367c641fab33d30bd3a68e49f70926e4 (commit)
      from  0833eab8f6d97770f5bc3f7dee18d68d6dfc9337 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit f6cbffe2367c641fab33d30bd3a68e49f70926e4
Author: Martin Davis <mtnclimb at gmail.com>
Date:   Fri Sep 10 11:02:23 2021 -0700

    Improve doc type descriptions

diff --git a/doc/reference_type.xml b/doc/reference_type.xml
index 87582cc..496b55f 100644
--- a/doc/reference_type.xml
+++ b/doc/reference_type.xml
@@ -29,20 +29,43 @@
 	<refentry id="box2d_type">
       <refnamediv>
         <refname>box2d</refname>
-        <refpurpose>A 2-dimensional bounding box.
-				Used to describe the 2D extent of a geometry or collection of geometries. </refpurpose>
+        <refpurpose>The type representing a 2-dimensional bounding box. </refpurpose>
       </refnamediv>
 
       <refsection>
         <title>Description</title>
         <para><varname>box2d</varname> is a spatial data type used to represent
-				the two-dimensional enclosing box of a geometry or collection of geometries.
-				For example, the <xref linkend="ST_Extent" /> aggregate function returns a <varname>box2d</varname> object.</para>
-				<para>The representation contains the values <varname>xmin, ymin, xmax, ymax</varname>.
-				These are the minimum and maximum values of the X and Y extents.
-				</para>
+            the two-dimensional bounding box enclosing a geometry or collection of geometries.
+            For example, the <xref linkend="ST_Extent" /> aggregate function returns a <varname>box2d</varname> object.</para>
+
+            <para>The representation contains the values <varname>xmin, ymin, xmax, ymax</varname>.
+            These are the minimum and maximum values of the X and Y extents.
+            </para>
+
+            <para><varname>box2d</varname> objects have a text representation which looks like <code>BOX(1 2,5 6)</code>.
+            </para>
       </refsection>
 
+      <refsection>
+		<title>Casting Behavior</title>
+		<para>This table lists the automatic and explicit casts allowed for this data type:</para>
+		<informaltable rowsep="1" frame="all">
+		<tgroup cols="2">
+			<tbody>
+			  <row>
+				<entry>Cast To</entry>  <entry>Behavior</entry>
+			  </row>
+			  <row>
+				<entry>box3d</entry>	<entry>automatic</entry>
+			  </row>
+			  <row>
+				<entry>geometry</entry>	<entry>automatic</entry>
+			  </row>
+			</tbody>
+		</tgroup>
+		</informaltable>
+		</refsection>
+
 		<refsection>
 			<title>See Also</title>
 			<para><xref linkend="PostGIS_BoxFunctions" /></para>
@@ -52,24 +75,27 @@
 	<refentry id="box3d_type">
       <refnamediv>
         <refname>box3d</refname>
-        <refpurpose>A 3-dimensional bounding box.
-				Used to describe the 3D extent of a geometry or collection of geometries. </refpurpose>
+        <refpurpose>The type representing a 3-dimensional bounding box. </refpurpose>
       </refnamediv>
 
       <refsection>
         <title>Description</title>
         <para><varname>box3d</varname> is a PostGIS spatial data type used to represent
-				the three-dimensional enclosing box of a geometry or collection of geometries.
-				For example, the <xref linkend="ST_3DExtent" /> aggregate function returns a <varname>box3d</varname> object.
-				</para>
-				<para>The representation contains the values <varname>xmin, ymin, zmin, xmax, ymax, zmax</varname>.
-				These are the minimum and maxium values of the X, Y and Z extents.
-				</para>
-      </refsection>
+            the three-dimensional bounding box enclosing a geometry or collection of geometries.
+            For example, the <xref linkend="ST_3DExtent" /> aggregate function returns a <varname>box3d</varname> object.
+            </para>
+
+            <para>The representation contains the values <varname>xmin, ymin, zmin, xmax, ymax, zmax</varname>.
+            These are the minimum and maxium values of the X, Y and Z extents.
+            </para>
+
+            <para><varname>box3d</varname> objects have a text representation which looks like <code>BOX3D(1 2 3,5 6 5)</code>.
+            </para>
+        </refsection>
 
       <refsection>
 		<title>Casting Behavior</title>
-		<para>This section lists the automatic as well as explicit casts allowed for this data type</para>
+		<para>This table lists the automatic and explicit casts allowed for this data type:</para>
 		<informaltable rowsep="1" frame="all">
 		<tgroup cols="2">
 			<tbody>
@@ -115,7 +141,7 @@
 
 		<refsection>
 		<title>Casting Behavior</title>
-		<para>This section lists the automatic as well as explicit casts allowed for this data type</para>
+		<para>This table lists the automatic and explicit casts allowed for this data type:</para>
 		<informaltable rowsep="1" frame="all">
 		<tgroup cols="2">
 			<tbody>
@@ -209,7 +235,7 @@
 
 		<refsection>
 		<title>Casting Behavior</title>
-		<para>This section lists the automatic as well as explicit casts allowed for this data type</para>
+		<para>This table lists the automatic and explicit casts allowed for this data type:</para>
 		<informaltable rowsep="1" frame="all">
 		<tgroup cols="2">
 			<tbody>

-----------------------------------------------------------------------

Summary of changes:
 doc/reference_type.xml | 64 +++++++++++++++++++++++++++++++++++---------------
 1 file changed, 45 insertions(+), 19 deletions(-)


hooks/post-receive
-- 
PostGIS


More information about the postgis-tickets mailing list