Improve documentation

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

diff --git a/liblwgeom/liblwgeom_topo.h b/liblwgeom/liblwgeom_topo.h
index d2057c98483fbe4fd7b63964ea26a7c2e86eba7f..9cfc1ac20f8b813df8de9fb7af1cbae293a71717 100644 (file)
--- a/liblwgeom/liblwgeom_topo.h
+++ b/liblwgeom/liblwgeom_topo.h
@@ -495,10 +495,16 @@ typedef struct LWT_TOPOLOGY_T LWT_TOPOLOGY;
  *******************************************************************/
 
 /**
- * Initializes a new topology in the database
+ * Initializes a new topology
  *
- * Topology support must be already enabled for the database
- * (see lwt_EnableTopology).
+ * @param iface the backend interface handler (see lwt_CreateBackendIface)
+ * @param name name of the new topology
+ * @param srid the topology SRID
+ * @param prec the topology precision/tolerance
+ * @param hasz non-zero if topology primitives should have a Z ordinate
+ *
+ * @return the handler of the topology, or NULL on error
+ *         (liblwgeom error handler will be invoked with error message)
  */
 LWT_TOPOLOGY *lwt_CreateTopology(LWT_BE_IFACE *iface, const char *name,
                         int srid, double prec, int hasz);
@@ -506,6 +512,9 @@ LWT_TOPOLOGY *lwt_CreateTopology(LWT_BE_IFACE *iface, const char *name,
 /**
  * Loads an existing topology by name from the database
  *
+ * @param iface the backend interface handler (see lwt_CreateBackendIface)
+ * @param name name of the topology to load
+ *
  * @return the handler of the topology, or NULL on error
  *         (liblwgeom error handler will be invoked with error message)
  */
@@ -513,10 +522,15 @@ LWT_TOPOLOGY *lwt_LoadTopology(LWT_BE_IFACE *iface, const char *name);
 
 /**
  * Drop a topology and all its associated objects from the database
+ *
+ * @param topo the topology to drop
  */
 void lwt_DropTopology(LWT_TOPOLOGY* topo);
 
-/** Release memory associated with an LWT_TOPOLOGY */
+/** Release memory associated with an LWT_TOPOLOGY
+ *
+ * @param topo the topology to release (it's not removed from db)
+ */
 void lwt_FreeTopology(LWT_TOPOLOGY* topo);
 
 /*******************************************************************