docs(lib): Fix formatting of parameter descriptions to solve doxygen warnings

Author: echoix

lib/gis/tempfile.c

@@ -155,7 +155,7 @@ void G_temp_element(char *element)
  *
  * \param[out] element element name
  * \param tmp TRUE to use G_make_mapset_element_tmp() instead of
- * G_make_mapset_element()
+ *            G_make_mapset_element()
  */
 void G__temp_element(char *element, int tmp)
 {

lib/gmath/la.c

@@ -1569,7 +1569,7 @@ mat_struct *G_matrix_resize(mat_struct *in, int rows, int cols)
 }
 
 /*!
- * \fn int G_matrix_read_stdin (mat_struct *out)
+ * \fn int G_matrix_stdin(mat_struct *out)
  *
  * \brief Read a matrix from standard input
  *

lib/ogsf/gs2.c

@@ -494,7 +494,7 @@ int GS_transp_is_set(void)
 /*!
    \brief Retrieves coordinates for lighting model position, at center of view
 
-   \param pos[out] coordinates
+   \param[out] pos coordinates
  */
 void GS_get_modelposition1(float pos[])
 {
@@ -522,8 +522,8 @@ void GS_get_modelposition1(float pos[])
    know position to calculate size, have two dependent variables
    (nearclip * 2) from eye.
 
-   \param siz[out] size
-   \param pos[out] coordinates (X, Y, Z)
+   \param[out] siz size
+   \param[out] pos coordinates (X, Y, Z)
  */
 void GS_get_modelposition(float *siz, float *pos)
 {

lib/ogsf/gsd_objs.c

@@ -1213,7 +1213,8 @@ int gsd_scalebar(float *pos2, float len, GLuint fontbase, unsigned long bar_clr,
 
    Adapted from gsd_scalebar A.Kratochvilova 2011
 
-   \param pos2 scalebar position
+   \param pos scalebar position
+   \param len
    \param fontbase font-base (unused)
    \param bar_clr barscale color
    \param text_clr text color (unused)

lib/raster3d/open.c

@@ -72,7 +72,7 @@ void *Rast3d_open_cell_old_no_header(const char *name, const char *mapset)
  *  \param name
  *  \param mapset
  *  \param window
- *  \param type
+ *  \param typeIntern
  *  \param cache
  *  \return void *
  */

lib/raster3d/open2.c

@@ -31,9 +31,11 @@
  *  \param doLzw Use the LZW compression algorithm
  *  \param doRle Use the Run-Length-Encoding algroithm for compression
  *  \param precision The precision used for the mantissa (0 - 52) or
- * RASTER3D_MAX_PRECISION \param tileX The number of cells in X direction of a
- * tile \param tileY The number of cells in Y direction of a tile \param tileZ
- * The number of cells in Z direction of a tile \return void *
+ *                   RASTER3D_MAX_PRECISION
+ *  \param tileX The number of cells in X direction of a tile
+ *  \param tileY The number of cells in Y direction of a tile
+ *  \param tileZ The number of cells in Z direction of a tile
+ *  \return void *
  */
 
 void *Rast3d_open_new_param(const char *name, int typeIntern, int cache,

lib/vector/Vlib/intersect2.c

@@ -665,6 +665,8 @@ static int boq_load(struct boq *q, struct line_pnts *Pnts,
  * \param BPoints second input line or NULL
  * \param[out] ALines array of new lines created from original A line
  * \param[out] BLines array of new lines created from original B line
+ * \param pABox
+ * \param pBBox
  * \param[out] nalines number of new lines (ALines)
  * \param[out] nblines number of new lines (BLines)
  * \param with_z 3D, not supported!

lib/vector/Vlib/net_analyze.c

@@ -480,19 +480,24 @@ int Vect_net_get_node_cost(struct Map_info *Map, int node, double *cost)
    \brief Find nearest node(s) on network.
 
    \param Map vector map with build graph (see Vect_net_ttb_build_graph and
-   Vect_net_build_graph) \param x,y,z point coordinates (z coordinate NOT USED
-   !) \param direction (GV_FORWARD - from point to net, GV_BACKWARD - from net
-   to point) \param maxdist maximum distance to the network \param[out] node1
-   pointer where to store the node number (or NULL) \param[out] node2 pointer
-   where to store the node number (or NULL) \param[out] ln    pointer where to
-   store the nearest line number (or NULL) \param[out] costs1 pointer where to
-   store costs on nearest line to node1 (not costs from x,y,z to the line) (or
-   NULL) \param[out] costs2 pointer where to store costs on nearest line to
-   node2 (not costs from x,y,z to the line) (or NULL) \param[out] Points1
-   pointer to structure where to store vertices on nearest line to node1 (or
-   NULL) \param[out] Points2 pointer to structure where to store vertices on
-   nearest line to node2 (or NULL) \param[out] pointer where to distance to the
-   line (or NULL) \param[out] distance
+              Vect_net_build_graph)
+   \param x,y,z point coordinates (z coordinate NOT USED!)
+   \param direction (GV_FORWARD - from point to net, GV_BACKWARD - from net
+                    to point)
+   \param maxdist maximum distance to the network
+   \param[out] node1 pointer where to store the node number (or NULL)
+   \param[out] node2 pointer where to store the node number (or NULL)
+   \param[out] ln    pointer where to store the nearest line number (or NULL)
+   \param[out] costs1 pointer where to store costs on nearest line to node1 (not
+                      costs from x,y,z to the line) (or NULL)
+   \param[out] costs2 pointer where to store costs on nearest line to node2
+                      (not costs from x,y,z to the line) (or NULL)
+   \param[out] Points1 pointer to structure where to store vertices on nearest
+                       line to node1 (or NULL)
+   \param[out] Points2 pointer to structure where to store vertices on nearest
+                       line to node2 (or NULL)
+  \param[out] pointer where to distance to the line (or NULL)
+  \param[out] distance
 
    \return number of nodes found (0,1,2)
  */

lib/vector/Vlib/read_nat.c

@@ -125,9 +125,10 @@ int V1_read_next_line_nat(struct Map_info *Map, struct line_pnts *line_p,
 
    \param Map pointer to Map_info struct
    \param[out] Points container used to store line points within (pointer to
-   line_pnts struct) \param[out] Cats container used to store line categories
-   within (pointer to line_cats struct) \param line feature id to read (starts
-   at 1)
+                      line_pnts struct)
+   \param[out] Cats container used to store line categories
+                    within (pointer to line_cats struct)
+   \param line feature id to read (starts at 1)
 
    \return feature type (GV_POINT, GV_LINE, ...)
    \return -2 nothing to read