fix some doxygen warnings

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

lib/bitmap/bitmap.c

@@ -84,7 +84,7 @@ struct BM *BM_create(int x, int y)
 /*!
  * \brief Destroy bitmap and free all associated memory
  *
- *  \param struct BM *map
+ *  \param map
  *  \return int returns 0
  */
 int BM_destroy(struct BM *map)
@@ -141,8 +141,8 @@ int BM_destroy(struct BM *map)
  *
  * returns 0 on success or -1 on error
  *
- *  \param int mode
- *  \param int size
+ *  \param mode
+ *  \param size
  *  \return int
  */
 

lib/gis/alloc.c

@@ -26,7 +26,7 @@
  *
  * \param file file name
  * \param line line number
- * \param t number of elements
+ * \param n number of elements
  */
 
 void *G__malloc(const char *file, int line, size_t n)

lib/gis/asprintf.c

@@ -36,6 +36,7 @@
  *
  * \param[out] out
  * \param[in] fmt
+ * \param ap
  * \return number of bytes written
  */
 
@@ -88,8 +89,9 @@ int G_asprintf(char **out, const char *fmt, ...)
  * times in a loop.
  *
  * \param[out] out
- * \param[out] size
+ * \param[out] osize
  * \param[in] fmt
+ * \param ap
  * \return number of bytes written
  */
 

lib/raster3d/alloc.c

@@ -64,7 +64,7 @@ void *Rast3d_realloc(void *ptr, int nBytes)
  *
  *  Same as <em>free (ptr)</em>.
  *
- *  \param ptr
+ *  \param buf
  *  \return void
  */
 

lib/vector/Vlib/ascii.c

@@ -283,7 +283,8 @@ int Vect_read_ascii_head(FILE *dascii, struct Map_info *Map)
 /*!
   \brief Write data to GRASS ASCII vector format
 
-  \param dascii pointer to the ASCII file
+  \param ascii  pointer to the ASCII file
+  \param att    att file (< version 5 only)
   \param Map    pointer to Map_info structure
   \param ver    version number 4 or 5
   \param format format GV_ASCII_FORMAT_POINT or GV_ASCII_FORMAT_STD

lib/vector/Vlib/buffer2.c

@@ -984,7 +984,7 @@ static void buffer_lines(struct line_pnts *area_outer, struct line_pnts **area_i
 
    See also Vect_line_buffer().
 
-   \param InPoints input line geometry
+   \param Points input line geometry
    \param da distance along major axis
    \param db distance along minor axis
    \param dalpha angle between 0x and major axis
@@ -1119,11 +1119,11 @@ void Vect_area_buffer2(const struct Map_info *Map, int area, double da, double d
    \param px input point x-coordinate
    \param py input point y-coordinate
    \param da distance along major axis
-   \param da distance along minor axis
+   \param db distance along minor axis
    \param dalpha angle between 0x and major axis
    \param round make corners round
    \param tol maximum distance between theoretical arc and output segments
-   \param[out] nPoints output polygon outer border (ccw order)
+   \param[out] oPoints output polygon outer border (ccw order)
  */
 void Vect_point_buffer2(double px, double py, double da, double db,
 			double dalpha, int round, double tol,

lib/vector/neta/bridge.c

@@ -26,10 +26,9 @@
    Bridge is an array containing the indices of the bridges.
 
    \param graph input graph
-   \param[out] bridges_list list of bridges
+   \param[out] bridge_list list of bridges
 
-   \return number of bridges
-   \return -1 on error
+   \return number of bridges, -1 on error
  */
 int NetA_compute_bridges(dglGraph_s * graph, struct ilist *bridge_list)
 {

lib/vector/vedit/break.c

@@ -23,6 +23,7 @@ static int connect_lines(struct Map_info *, int, int, int,
   \param Map pointer to Map_info
   \param List list of selected lines
   \param coord points location
+  \param thresh threshold
   \param[out] List_updated list of rewritten features (or NULL)
   
   \return number of modified lines