From: Regina Obe <lr@pcorp.us>
Date: Mon, 4 May 2009 18:00:05 +0000 (+0000)
Subject: more doxygen comment cleanup
X-Git-Tag: 1.4.0b1~62
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=75bded91e6efb66ef8bc6ce1e5503f0ee38421ec;p=postgis

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 e1e987540..51f02a215 100644
--- 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 5c500fd9f..d1273d837 100644
--- 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 8f4e86088..d9cf0a2aa 100644
--- 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