basic spell-checking of the documentation

Author: Markus Nullmeier

doc/appendixes.sgm

@@ -14,7 +14,7 @@
           </listitem>
           <listitem>
             <para>
-               Remove btree index. It was used to cluster the index.
+               Remove B-tree index. It was used to cluster the index.
             </para>
           </listitem>
           <listitem>

doc/constructors.sgm

@@ -5,7 +5,7 @@
         <para>
           Constructors within <application>pgSphere</application> are
           functions needed to create spherical data types from other data
-          types. In usage, there isn't a difference from
+          types. For actual use, there isn't a difference to
           <emphasis>usual</emphasis> <application>PostgreSQL</application>
           functions.  <application>pgSphere</application> constructor
           functions are named by returned data type. Constructor functions
@@ -51,7 +51,7 @@
             Euler transformation
           </title>
           <para>
-            There are two constructor functions for a Euler transformation:
+            There are two constructor functions for an Euler transformation:
           </para>
           <funcsynopsis>
             <funcprototype>
@@ -77,7 +77,7 @@
             For more information about that parameter, see <xref linkend="dt.strans"/>.
           </para>
           <example>
-            <title>Create a Euler transformation object</title>
+            <title>Create an Euler transformation object</title>
             <simpara>
               Create a transformation object to rotate a spherical object
               counterclockwise, first 20&deg; around
@@ -114,7 +114,7 @@
             Otherwise, this function returns an error.
           </para>
           <example>
-            <title>A circle around the Noth Pole</title>
+            <title>A circle around the north pole</title>
             <simpara>
              Get a spherical circle around the North Pole with a radius
              of 30&deg;.
@@ -144,7 +144,7 @@
             The input of spherical lines using Euler transformation and
             length is quite circumstantial (see <xref linkend="dt.sline"/>). 
             For short lines it is easier to input a line specifying the
-            begining and the end of the line.
+            beginning and the end of the line.
           </para>              
           <funcsynopsis>
             <funcprototype>

doc/examples.sgm

@@ -91,11 +91,11 @@
           <para>or</para>
           <synopsis> object + strans (&ohgr;, i, &OHgr;)</synopsis>
           <example>
-            <title>Perihel and aphel coordinates of a comet orbit</title>
+            <title>perihelion and aphelion coordinates of a comet's orbit</title>
             <simpara>
              We are assuming the orbital elements of a comet are
              &OHgr;=30&deg;, i=60&deg; and &ohgr;=90&deg;. We get the
-             spherical position of perihel and aphel with:
+             spherical position of perihelion and aphelion with:
             </simpara>
             <programlisting>
 <![CDATA[sql> SELECT set_sphere_output('DEG');]]>
@@ -104,14 +104,14 @@
 <![CDATA[ SET DEG]]>
 <![CDATA[(1 row)]]>
 <![CDATA[]]>
-<![CDATA[sql> SELECT spoint '(0,0)' + strans '90d,60d,30d' AS perihel;]]>
-<![CDATA[   perihel]]>
+<![CDATA[sql> SELECT spoint '(0,0)' + strans '90d,60d,30d' AS perihelion;]]>
+<![CDATA[   perihelion]]>
 <![CDATA[--------------]]>
 <![CDATA[ (120d , 60d)]]>
 <![CDATA[(1 row)]]>
 <![CDATA[]]>
-<![CDATA[sql> SELECT spoint '(180d,0)' + strans '90d,60d,30d' AS aphel;]]>
-<![CDATA[      aphel]]>
+<![CDATA[sql> SELECT spoint '(180d,0)' + strans '90d,60d,30d' AS aphelion;]]>
+<![CDATA[      aphelion]]>
 <![CDATA[---------------]]>
 <![CDATA[ (300d , -60d)]]>
 <![CDATA[(1 row)]]>

doc/functions.sgm

@@ -95,15 +95,15 @@
               </funcprototype>
             </funcsynopsis>
             <para>
-              return the cartesian
+              return the Cartesian
               <literal>x</literal>, <literal>y</literal> or
               <literal>z</literal> value of a spherical position
               <parameter>p</parameter>. The returned values are always
               between <literal>-1.0</literal> and <literal>+1.0</literal>.
             </para>
             <example>
               <title>
-                Get the cartesian <literal>z</literal>-value
+                Get the Cartesian <literal>z</literal>-value
                 of a spherical point
               </title>
               <programlisting>
@@ -115,7 +115,7 @@
               </programlisting>
             </example>
             <para>
-              You can get a <type>float8</type> array of cartesian values using the function
+              You can get a <type>float8</type> array of Cartesian values using the function
             </para>
             <funcsynopsis>
               <funcprototype>
@@ -125,7 +125,7 @@
             </funcsynopsis>
             <example>
               <title>
-                Get the cartesian values of a spherical point
+                Get the Cartesian values of a spherical point
               </title>
               <programlisting>
 <![CDATA[sql> SELECT xyz ( spoint '(0d,0d)' ) AS cart;]]>
@@ -151,14 +151,14 @@
                 <para>
                     Using the function
                     <function>strans_zxz(strans),</function> you can convert
-                    a Euler transformation to <literal>ZXZ</literal>-axes
+                    an Euler transformation to <literal>ZXZ</literal> axes
                     transformation.
                 </para>
                 <example>
                   <title>Change the transformation axes to <literal>ZXZ</literal></title>
                   <simpara>
                     Convert the transformation <literal>strans '20d, -270d, 70.5d,
-                    XZY'</literal> to a <literal>ZXZ</literal>-transformation.
+                    XZY'</literal> to a <literal>ZXZ</literal> transformation.
                   </simpara>
                   <programlisting>
 <![CDATA[sql> SELECT strans_zxz ( strans '20d, -270d, 70.5d, XZY' );]]>
@@ -502,7 +502,7 @@
           </title>
           <sect3 id="funcs.spoly.npts">
             <title>
-              Cnunt of edges
+              Count of edges
             </title>
             <para>
               Similar to an <type>spath</type> (<xref linkend="funcs.spath.npts"/>), 

doc/indices.sgm

@@ -8,7 +8,7 @@
         </title>
         <para>
           <application>pgSphere</application> uses <literal>GiST</literal>
-          to create spherical indices. An index speeds up the executation
+          to create spherical indices. An index speeds up the execution
           time of operators <link
           linkend="op.over"><literal>@</literal></link>, <link
           linkend="op.over"><literal>&amp;&amp;</literal></link>, <link

doc/install.sgm

@@ -32,7 +32,7 @@
                 Then, change into <filename>POSTGRESQL_SRC/src/contrib</filename>. 
                 If the sources are not yet installed and the directory
                 <filename>pg_sphere</filename> does not exist, take the
-                gzipped <application>pgSphere</application> sources ( e.g.,
+                gzipped <application>pgSphere</application> sources ( e. g.,
                 <filename>pg_sphere_xxx.tgz</filename> ) and run:
             </para>
             <programlisting>

doc/operators.sgm

@@ -307,7 +307,7 @@
             </title>
             <para>
                 The length/circumference operator <literal>@-@</literal> is
-                a non-boolean unary operator returning the cirumference or
+                a non-boolean unary operator returning the circumference or
                 length of an object.  In the current implementation,
                 <application>pgSphere</application> supports only
                 circumferences of circles, polygons, and boxes.  It supports
@@ -365,7 +365,7 @@
             <para>
                 The unary operator <literal>-</literal> changes the
                 direction of <type>sline</type> or <type>spath</type>
-                objects. You can use it with a Euler transformation object
+                objects. You can use it with an Euler transformation object
                 in the figurative sense, too (<xref linkend="op.trans"/>).
             </para>
             <example>

doc/types.sgm

@@ -105,7 +105,7 @@
                 </imageobject>
               </mediaobject>
                A spherical point is an object without expanse
-               but with a position. Usage cases are:
+               but with a position. Use cases are:
             </para>
             <itemizedlist>
                 <listitem>
@@ -194,10 +194,10 @@
                   <imagedata fileref="&graph1003;" width="160px" format="JPEG"/>
                 </imageobject>
               </mediaobject>
-              A Euler transformation is done with three counterclockwise
+              An Euler transformation is done with three counterclockwise
               object rotations around following the axes:
               <literal>x</literal>-axis, <literal>y</literal>-axis, or
-              <literal>z</literal>-axis.  Usage cases are:
+              <literal>z</literal>-axis.  Use cases are:
             </para>
             <itemizedlist>
                 <listitem>
@@ -212,7 +212,7 @@
                 </listitem>
             </itemizedlist>
             <para>
-              The input syntax of a Euler transformation is:
+              The input syntax of an Euler transformation is:
             </para>
             <synopsis>angle1, angle2, angle3 &lsqb;, axes &rsqb;</synopsis>
             <para>
@@ -269,7 +269,7 @@
               </mediaobject>
               A spherical circle is an area
               around a point, where all points inside the circle have a
-              distance less than or equal to the radius of the circle.  Usage
+              distance less than or equal to the radius of the circle.  Use
               cases are:
             </para>
             <itemizedlist>
@@ -323,7 +323,7 @@
                 </imageobject>
               </mediaobject>
               A spherical line is part of a great circle (meridian) that has
-              a beginning and an end and hence, a direction.  Usage cases are:
+              a beginning and an end and hence, a direction.  Use cases are:
             </para>
             <itemizedlist>
                 <listitem>
@@ -345,7 +345,7 @@ i             syntax is a somewhat complex.
               A general located line with a length
               <parameter>length</parameter> is defined as a line starting at
               position <literal>(0d,0d)</literal> and ending at position
-              <literal>(length,0d)</literal> transformed with a Euler
+              <literal>(length,0d)</literal> transformed with an Euler
               transformation <parameter>euler</parameter>.  The input syntax
               is :
             </para>
@@ -369,7 +369,7 @@ i             syntax is a somewhat complex.
                   <listitem>
                       <para>
                           The transformation <parameter>euler</parameter>
-                          will always be converted to a Euler
+                          will always be converted to an Euler
                           transformation using axes <literal>Z</literal>,
                           <literal>X</literal>, and <literal>Z</literal>.
                       </para>
@@ -413,7 +413,7 @@ i             syntax is a somewhat complex.
                </para>
             </blockquote>
             <para>
-                Usage cases are:
+                Use cases are:
             </para>
             <itemizedlist>
                 <listitem>
@@ -510,7 +510,7 @@ i             syntax is a somewhat complex.
                 </imageobject>
               </mediaobject>
               A spherical path is a
-              concatination of spherical lines.  Usage cases are:
+              concatenation of spherical lines.  Use cases are:
             </para>
             <itemizedlist>
                 <listitem>
@@ -573,7 +573,7 @@ i             syntax is a somewhat complex.
             <para>
               A spherical polygon is a
               closed spherical path where line segments cannot be crossed.
-              One main usage case are areas on the earth and sky sphere.
+              One main use case are areas on the earth and sky sphere.
               Polygons within <application>pgSphere</application> 
               have the same input syntax as paths:
             </para>