[GRASS-SVN] r62957 - grass/branches/releasebranch_7_0/lib/gis

[svn_grass at osgeo.org]

Author: neteler
Date: 2014-11-26 01:00:46 -0800 (Wed, 26 Nov 2014)
New Revision: 62957

Modified:
   grass/branches/releasebranch_7_0/lib/gis/basename.c
   grass/branches/releasebranch_7_0/lib/gis/mapset_nme.c
   grass/branches/releasebranch_7_0/lib/gis/nme_in_mps.c
Log:
Minor doxygen sync to trunk

Modified: grass/branches/releasebranch_7_0/lib/gis/basename.c
===================================================================
--- grass/branches/releasebranch_7_0/lib/gis/basename.c	2014-11-26 08:48:02 UTC (rev 62956)
+++ grass/branches/releasebranch_7_0/lib/gis/basename.c	2014-11-26 09:00:46 UTC (rev 62957)
@@ -1,17 +1,15 @@
 
-/**
- * \file basename.c
+/*!
+ * \file lib/gis/basename.c
  *
  * \brief GIS Library - Program basename routines.
  *
- * (C) 2001-2008 by the GRASS Development Team
+ * (C) 2001-2014 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 GRASS GIS Development Team
- *
- * \date 1999-2007
  */
 
 #include <grass/gis.h>
@@ -23,7 +21,7 @@
 #include <stdlib.h>
 
 
-/**
+/*!
  * \brief Truncates filename to the base part (before the last '.')
  * if it matches the extension, otherwise leaves it unchanged.
  * 
@@ -31,12 +29,12 @@
  * (case insensitive) and if so, truncates the string to the
  * base file name (cf. basename Unix command)
  *
- * \param[in] filename string containing filename
- * \param[in] desired_ext string containing extension to look for (case
+ * \param filename string containing filename
+ * \param desired_ext string containing extension to look for (case
  * insensitive)
- * \return Pointer to filename
+ *
+ * \return pointer to filename
  */
-
 char *G_basename(char *filename, const char *desired_ext)
 {
     /* Find the last . in the filename */
@@ -106,9 +104,13 @@
 
 
 /*!
- * \brief Return the environmental basename variable or the default value
+ * \brief Return the environmental basename variable or the default
+ * value
+ *
+ * return pointer to basename separator
  */
-char *G_get_basename_separator(){
+char *G_get_basename_separator()
+{
     char *envvar = "GRASS_BASENAME_SEPARATOR";
     char *envsep;
 

Modified: grass/branches/releasebranch_7_0/lib/gis/mapset_nme.c
===================================================================
--- grass/branches/releasebranch_7_0/lib/gis/mapset_nme.c	2014-11-26 08:48:02 UTC (rev 62956)
+++ grass/branches/releasebranch_7_0/lib/gis/mapset_nme.c	2014-11-26 09:00:46 UTC (rev 62957)
@@ -30,7 +30,7 @@
 static void new_mapset(const char *);
 
 /*!
-   \brief Get name of the n'th mapset from the mapset_name[] list.
+   \brief Get name of the n'th mapset from the current mapset search path.
 
    The first call will initialize the list.
 
@@ -97,8 +97,6 @@
 
 /*!
    \brief Define alternative mapset search path
-
-   \return 0
  */
 void G_create_alt_search_path(void)
 {
@@ -110,8 +108,6 @@
 
 /*!
    \brief Switch mapset search path
-
-   \return 0
  */
 void G_switch_search_path(void)
 {
@@ -130,8 +126,6 @@
 
 /*!
    \brief Reset number of mapsets
-
-   \return 0
  */
 void G_reset_mapsets(void)
 {

Modified: grass/branches/releasebranch_7_0/lib/gis/nme_in_mps.c
===================================================================
--- grass/branches/releasebranch_7_0/lib/gis/nme_in_mps.c	2014-11-26 08:48:02 UTC (rev 62956)
+++ grass/branches/releasebranch_7_0/lib/gis/nme_in_mps.c	2014-11-26 09:00:46 UTC (rev 62957)
@@ -122,10 +122,10 @@
    - <i>name, xname</i> are char array of size GNAME_MAX
    - <i>mapset, xmapset</i> are char array of size GMAPSET_MAX
 
-  \param fullname map name
-  \param map mapset to check or NULL
-  \param[out] name map name
-  \param[out] mapset mapset name
+  \param name map name
+  \param mapset mapset to check or NULL
+  \param[out] xname map name
+  \param[out] xmapset mapset name
 
   \return  1 if input map name is fully qualified
   \return  0 if name is not fully qualified