doxygen strings for token.c

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@39614 15284696-431f-4ddb-bdfa-cd5b030d7da7

lib/db/dbmi_base/token.c

@@ -1,3 +1,16 @@
+/*!
+  \file db/dbmi_base/token.c
+  
+  \brief DBMI Library (base) - tokens management
+  
+  (C) 1999-2009 by the GRASS Development Team
+  
+  This program is free software under the GNU General Public
+  License (>=v2). Read the file COPYING that comes with GRASS
+  for details.
+  
+  \author Joel Jones (CERL/UIUC), Radim Blazek
+*/
 #include <grass/dbmi.h>
 
 /* these routines manage a mapping between tokens (ints) and memory addresses */
@@ -7,11 +20,13 @@ static dbAddress *list = NONE;
 static dbToken count = 0;
 
 /*!
-   \fn 
-   \brief 
-   \return 
-   \param 
- */
+  \brief Find token
+
+  \param token pointer to dbToken
+
+  \return dbAddress
+  \return NULL if no token found
+*/
 dbAddress db_find_token(dbToken token)
 {
     if (token >= 0 && token < count)
@@ -20,11 +35,10 @@ dbAddress db_find_token(dbToken token)
 }
 
 /*!
-   \fn 
-   \brief 
-   \return 
-   \param 
- */
+  \brief Drop token
+
+  \param token pointer to dbToken
+*/
 void db_drop_token(dbToken token)
 {
     if (token >= 0 && token < count)
@@ -32,10 +46,11 @@ void db_drop_token(dbToken token)
 }
 
 /*!
-   \fn 
-   \brief 
-   \return 
-   \param 
+  \brief Add new token
+
+  \param address dbAddress of token to be added
+
+  \return dbToken
  */
 dbToken db_new_token(dbAddress address)
 {