minor comment fixes

Author: funbringer

circle.h

@@ -148,7 +148,7 @@ Datum	spherecircle_circ(PG_FUNCTION_ARGS);
 Datum	spheretrans_circle(PG_FUNCTION_ARGS);
 
 /*
- * Inverse transformation of a circle using Euler transformation.
+ * Inverse transformation of a circle using an Euler transformation.
  */
 Datum	spheretrans_circle_inverse(PG_FUNCTION_ARGS);
 

ellipse.c

@@ -918,8 +918,10 @@ sellipse_circle_pos(const SELLIPSE *se, const SCIRCLE *sc)
 	}
 	else
 	{
-		/* now ellipse is a real ellipse and */
-		/* circle is a real circle */
+		/*
+		 * now ellipse is a real ellipse and
+		 * circle is a real circle
+		 */
 
 		float8	dist;
 		SPoint	c;

euler.c

@@ -108,8 +108,9 @@ spheretrans_from_float8_and_type(PG_FUNCTION_ARGS)
 	d[0] = PG_GETARG_DATUM(0);
 	d[1] = PG_GETARG_DATUM(1);
 	d[2] = PG_GETARG_DATUM(2);
-	se = (SEuler *) DatumGetPointer(DirectFunctionCall3(spheretrans_from_float8,
-														d[0], d[1], d[2]));
+	se = (SEuler *) DatumGetPointer(
+						DirectFunctionCall3(spheretrans_from_float8,
+											d[0], d[1], d[2]));
 
 	for (i = 0; i < 3; i++)
 	{

euler.h

@@ -68,7 +68,7 @@ void	spheretrans_inv(SEuler *se);
 void	strans_zxz(SEuler *ret, const SEuler *se);
 
 /*
- * Transforms an Euler transformation 'in' into 'out' using se'. The result
+ * Transforms an Euler transformation 'in' into 'out' using 'se'. The result
  * is always a ZXZ-axis transformation. Returns the pointer to the transformed
  * transformation.
  */
@@ -123,8 +123,8 @@ Datum	spheretrans_zxz(PG_FUNCTION_ARGS);
 
 /*
  * This function creates an Euler transformation from 3 angle values in
- * radians and three letter code used for axes. A letter can be X,Y or Z
- * (not case sensitive).
+ * radians and three letter code used for axes. A letter can be X, Y or Z
+ * (case-insensitive).
  */
 Datum	spheretrans_from_float8_and_type(PG_FUNCTION_ARGS);
 
@@ -154,7 +154,7 @@ Datum	spheretrans_trans_inv(PG_FUNCTION_ARGS);
 Datum	spheretrans_point(PG_FUNCTION_ARGS);
 
 /*
- * Perform inverse transform of a spherical point.
+ * Perform inverse transformation of a spherical point.
  */
 Datum	spheretrans_point_inverse(PG_FUNCTION_ARGS);
 

polygon.c

@@ -58,12 +58,10 @@ PG_FUNCTION_INFO_V1(spherepoly_add_points_finalize);
 
 
  /*
-  * "Center" of a polygon.
+  * Writes "center" of a polygon into 'v'.
   *
   * v    - pointer to the center of a polygon
   * poly - pointer to the polygon
-  *
-  * Returns true if crossing.
   */
 static void
 spherepoly_center(Vector3D *v, const SPOLY *poly)
@@ -97,11 +95,7 @@ spherepoly_center(Vector3D *v, const SPOLY *poly)
 
 
 /*
- * Checks crossing of line segments.
- *
- * poly - pointer to a polygon
- *
- * Returns true if crossing.
+ * Checks if line segments cross.
  */
 static bool
 spherepoly_check(const SPOLY *poly)
@@ -277,9 +271,6 @@ euler_spoly_trans(SPOLY *out, const SPOLY *in, const SEuler *se)
 /*
  * Returns the relationship between polygon and circle as
  * PGS_CIRCLE_POLY_REL int8 value.
- *
- * circ - pointer to the circle
- * poly - is the pointer to the polygon
  */
 static int8
 poly_circle_pos(const SPOLY *poly, const SCIRCLE *circ)
@@ -348,9 +339,6 @@ poly_circle_pos(const SPOLY *poly, const SCIRCLE *circ)
 /*
  * Returns the relationship between a polygon and an ellipse
  * as PGS_ELLIPSE_POLY_REL int8 value.
- *
- * ell  - pointer to the ellipse
- * poly - pointer to the polygon
  */
 static int8
 poly_ellipse_pos(const SPOLY *poly, const SELLIPSE *ell)
@@ -496,9 +484,6 @@ poly_poly_pos(const SPOLY *p1, const SPOLY *p2, bool recheck)
 /*
  * Checks whether two polygons are equal.
  *
- * p1 - pointer to the first polygon
- * p2 - pointer to the second polygon
- *
  * If 'dir' is true, check with reverse polygon of 'p2'.
  */
 bool