more doxygen comment cleanup

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

diff --git a/liblwgeom/lwmpoly.c b/liblwgeom/lwmpoly.c
index e1e9875400328348a48066faa2c431d0a7e70c32..51f02a215f05bd12c5292f6caa34749fd0090824 100644 (file)
--- a/liblwgeom/lwmpoly.c
+++ b/liblwgeom/lwmpoly.c
@@ -71,11 +71,10 @@ lwmpoly_deserialize(uchar *srl)
        return result;
 }
 
-/*
+/**
  * Add 'what' to this multiline at position 'where'.
- * where=0 == prepend
- * where=-1 == append
- * Returns a MULTIPOLY or a COLLECTION
+ * @param where if 0 == prepend, if = -1 then append
+ * @return a {@link #MULTIPOLY} or a {@link #COLLECTION}
  */
 LWGEOM *
 lwmpoly_add(const LWMPOLY *to, uint32 where, const LWGEOM *what)

diff --git a/liblwgeom/wktparse.h b/liblwgeom/wktparse.h
index 5c500fd9ff9e52b68addc01741223502b49f9b78..d1273d83774d1694e0c978e19454efa022689bd5 100644 (file)
--- a/liblwgeom/wktparse.h
+++ b/liblwgeom/wktparse.h
@@ -119,9 +119,9 @@ void popc(void);
 
 void alloc_wkb(const char* parser);
 
-/*
-       Use these functions to parse and unparse lwgeoms
-       You are responsible for freeing the returned memory.
+/**
+       @file Use these functions to parse and unparse lwgeoms
+                       You are responsible for freeing the returned memory.
 */
 
 int parse_lwg(LWGEOM_PARSER_RESULT *lwg_parser_result, const char* wkt, int flags, allocator allocfunc,report_error errfunc);

diff --git a/postgis/lwgeom_kml.c b/postgis/lwgeom_kml.c
index 8f4e86088e05b4b198e9918ae39ae2db8160ddb4..d9cf0a2aa3474f50d1da6158b39e96e0cbeb8f61 100644 (file)
--- a/postgis/lwgeom_kml.c
+++ b/postgis/lwgeom_kml.c
@@ -8,8 +8,10 @@
  * This is free software; you can redistribute and/or modify it under
  * the terms of hte GNU General Public Licence. See the COPYING file.
  *
- **********************************************************************
- *
+ **********************************************************************/
+ 
+ /**
+ * @file
  * KML output routines based on lwgeom_gml.c
  * Written by: Eduin Carrillo <yecarrillo@cas.gov.co>
  *             © 2006 Corporacion Autonoma Regional de Santander - CAS