docs: Rename param tags to match signature in doxygen docstrings

Author: echoix

lib/gis/paths.c

@@ -120,7 +120,7 @@ char *G_convert_dirseps_from_host(char *path)
  * Returns information about the specified file.
  *
  * \param file_name file name
- * \param stat pointer to structure filled with file information
+ * \param buf pointer to structure filled with file information
  *
  * \return Return value from system lstat function
  **/
@@ -137,7 +137,7 @@ int G_stat(const char *file_name, struct stat *buf)
  *
  * \param file_name file name, in the case of a symbolic link, the
  *                  link itself is stat-ed, not the file that it refers to
- * \param stat pointer to structure filled with file information
+ * \param buf pointer to structure filled with file information
  *
  * \return Return value from system lstat function
  **/

lib/gis/tempfile.c

@@ -180,7 +180,7 @@ void G__temp_element(char *element, int tmp)
  * \brief Populates element with a path string (internal use only!)
  *
  * \param[out] element element name
- * \param tmp
+ * \param basedir
  */
 void G__temp_element_basedir(char *element, const char *basedir)
 {

lib/gis/wind_format.c

@@ -62,7 +62,7 @@ void G_format_easting(double east, char *buf, int projection)
  * Converts the double representation of the <i>resolution</i> to its
  * ASCII representation (into <i>buf</i>).
  *
- * \param resolution resolution value
+ * \param res resolution value
  * \param[out] buf buffer to hold formatted string
  * \param projection projection code, or -1 to force full precision FP
  */

lib/gis/wind_scan.c

@@ -91,7 +91,7 @@ int G_scan_easting(const char *buf, double *easting, int projection)
    - PROJECTION_OTHER
 
    \param buf buffer containing string resolution
-   \param[out] resolution resolution value
+   \param[out] res resolution value
    \param projection projection code
 
    \return 0 on error

lib/imagery/manage_signatures.c

@@ -105,9 +105,9 @@ int I_signatures_remove(I_SIGFILE_TYPE type, const char *name)
  * It is safe to pass fully qualified names.
  *
  * \param type I_SIGFILE_TYPE signature type
- * \param name of old signature
- * \param mapset of old signature
- * \param name of new signature
+ * \param old_name of old signature
+ * \param old_mapset of old signature
+ * \param new_name of new signature
  * \return 0 on success
  * \return 1 on failure
  */

lib/imagery/sig.c

@@ -237,8 +237,8 @@ int I_read_signatures(FILE *fd, struct Signature *S)
  * I_fopen_signature_file_new()
  * It is up to caller to fclose the file stream afterwards.
  *
- * \param pointer to FILE*
- * \param pointer to struct Signature *S
+ * \param fd to FILE*
+ * \param Sr to struct Signature *S
  *
  * \return always 1
  */
@@ -314,8 +314,8 @@ int I_write_signatures(FILE *fd, struct Signature *S)
  * \code if (ret && ret[1]) printf("List of imagery group bands without
  * signatures: %s\n, ret[1]); \endcode
  *
- * \param *Signature existing signatures to check & sort
- * \param *Ref group reference
+ * \param Signature existing signatures to check & sort
+ * \param Ref group reference
  *
  * \return NULL successfully sorted
  * \return err_array two comma separated lists of mismatches

lib/imagery/sigset.c

@@ -133,8 +133,8 @@ struct SubSig *I_NewSubSig(struct SigSet *S, struct ClassSig *C)
  * There is no need to initialise struct SigSet in advance, as this
  * function internally calls I_InitSigSet.
  *
- * \param pointer to FILE*
- * \param pointer to struct SigSet *S
+ * \param fd pointer to FILE*
+ * \param S pointer to struct SigSet *S
  *
  * \return 1 on success, -1 on failure
  */

lib/ogsf/gs.c

@@ -350,7 +350,7 @@ void print_frto(float (*ft)[4])
 
    \todo G_debug ?
 
-   \param ft pointer to coordinates
+   \param rt pointer to coordinates
  */
 void print_realto(float *rt)
 {
@@ -364,7 +364,7 @@ void print_realto(float *rt)
 
    \todo G_debug ?
 
-   \param ft pointer to buffer
+   \param buff pointer to buffer
  */
 void print_256lookup(int *buff)
 {

lib/ogsf/gs2.c

@@ -1524,7 +1524,7 @@ int GS_num_surfs(void)
 
    Must be freed when not needed!
 
-   \param[out] numsurf number of available surfaces
+   \param[out] numsurfs number of available surfaces
 
    \return pointer to surface array
    \return NULL on error

lib/ogsf/gsd_objs.c

@@ -300,7 +300,7 @@ void gsd_x(geosurf *gs, float *center, int colr, float siz)
 
    \param center center point
    \param colr color value
-   \param size size value
+   \param siz size value
  */
 void gsd_diamond(float *center, unsigned long colr, float siz)
 {