Fix some comments

Author: Alexander Korotkov

gnomo.c

@@ -7,9 +7,14 @@
 
 #include <math.h>
 
-/* point gnomonic_proj(spoint spherical_point, spoint tangential_point) */
-
 PG_FUNCTION_INFO_V1(gnomonic_proj);
+PG_FUNCTION_INFO_V1(gnomonic_inv);
+
+/*
+ * Direct gnomonic projection.
+ *
+ * point gnomonic_proj(spoint spherical_point, spoint tangential_point)
+ */
 Datum gnomonic_proj(PG_FUNCTION_ARGS)
 {
 	Point*  g = (Point*)  palloc(sizeof(Point));
@@ -33,9 +38,11 @@ Datum gnomonic_proj(PG_FUNCTION_ARGS)
 	PG_RETURN_POINTER(g);
 }
 
-/* spoint gnomonic_inv(point plane_point, spoint tangential_point) */
-
-PG_FUNCTION_INFO_V1(gnomonic_inv);
+/*
+ * Inverse gnomonic projection.
+ *
+ * spoint gnomonic_inv(point plane_point, spoint tangential_point)
+ */
 Datum gnomonic_inv(PG_FUNCTION_ARGS)
 {
 	SPoint* p = (SPoint*) palloc(sizeof(SPoint));

line.h

@@ -89,15 +89,12 @@ int8		sphereline_circle_pos(const SLine *sl, const SCIRCLE *sc);
 bool		sline_circle_touch(const SLine *sl, const SCIRCLE *sc);
 
 /*
- * Returns the relationship between two lines \param l1  pointer to
- * first line \param l2  pointer to second line \return relationship as a
- * \link PGS_LINE_LINE_REL int8 value \endlink (\ref  PGS_LINE_LINE_REL )
+ * Returns the relationship between two lines as PGS_LINE_LINE_REL int8 value.
  */
 int8		sline_sline_pos(const SLine *l1, const SLine *l2);
 
 /*
- * Checks, whether the point is on line \param p	pointer to given
- * point \param sl pointer to the line \return bool, true if point at line
+ * Returns true if the point is on line.
  */
 bool		spoint_at_sline(const SPoint *p, const SLine *sl);