libgis: minor doxygen header updates (backport)

git-svn-id: https://svn.osgeo.org/grass/grass/branches/releasebranch_7_0@63641 15284696-431f-4ddb-bdfa-cd5b030d7da7

lib/gis/adj_cellhd.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/adj_cellhd.c
+ * \file lib/gis/adj_cellhd.c
  *
  * \brief GIS Library - CELL header adjustment.
  *

lib/gis/area.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/area.c
+ * \file lib/gis/area.c
  *
  * \brief GIS Library - Area calculation functions.
  *

lib/gis/area_ellipse.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/area_ellipse.c
+ * \file lib/gis/area_ellipse.c
  *
  * \brief GIS Library - Ellipse area routines.
  *

lib/gis/area_poly1.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/area_poly1.c
+ * \file lib/gis/area_poly1.c
  *
  * \brief GIS Library - Polygon area calculation routines.
  *

lib/gis/area_poly2.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/area_poly2.c
+ * \file lib/gis/area_poly2.c
  *
  * \brief GIS Library - Planimetric polygon area calculation routines.
  *

lib/gis/area_sphere.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/area_sphere.c
+ * \file lib/gis/area_sphere.c
  *
  * \brief GIS Library - Sphereical area calculation routines.
  *

lib/gis/ascii_chk.c

@@ -1,17 +1,17 @@
 
-/**
- * \file ascii_chk.c
+/*!
+ * \file lib/gis/ascii_chk.c
  *
  * \brief GIS Library - Remove non-ascii characters
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <grass/gis.h>

lib/gis/asprintf.c

@@ -1,6 +1,6 @@
 
-/**
- * \file asprintf.c
+/*!
+ * \file lib/gis/asprintf.c
  *
  * \brief GIS Library - GRASS implementation of asprintf().
  *
@@ -9,7 +9,7 @@
  * Rewritten by Glynn Clements, Sat, 6 Feb 2010
  * Assumes that vsnprintf() is available
  *
- * (C) 2001-2008 by the GRASS Development Team
+ * (C) 2002-2014 by the GRASS Development Team
  * (C) 2010 by Glynn Clements
  *
  * This program is free software under the GNU General Public License

lib/gis/bres_line.c

@@ -1,9 +1,9 @@
 /*
- * \file gis/bres_line.c
+ * \file lib/gis/bres_line.c
  *
  * \brief GIS Library - Bresenham line 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.

lib/gis/color_str.c

@@ -1,9 +1,9 @@
 /*!
-   \file gis/color_str.c
+   \file lib/gis/color_str.c
 
    \brief GIS library - color management, named color to RGB triplet
 
-   (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). 

lib/gis/commas.c

@@ -1,17 +1,17 @@
 
-/**
- * \file commas.c
+/*!
+ * \file lib/gis/commas.c
  *
  * \brief GIS Library - Comma string functions.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <string.h>

lib/gis/date.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/date.c
+ * \file lib/gis/date.c
  *
  * \brief GIS Library - Date functions.
  *

lib/gis/debug.c

@@ -1,5 +1,5 @@
-/**
- * \file debug.c
+/*!
+ * \file lib/gis/debug.c
  *
  * \brief GIS Library - Debug functions.
  *

lib/gis/done_msg.c

@@ -1,17 +1,17 @@
 
-/**
- * \file done_msg.c
+/*!
+ * \file lib/gis/done_msg.c
  *
  * \brief GIS Library - Done message functions.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <stdarg.h>

lib/gis/endian.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/endian.c
+ * \file lib/gis/endian.c
  *
  * \brief GIS Library - Functions to determine architecture endian.
  *

lib/gis/find_file.c

@@ -1,5 +1,5 @@
 /*!
-   \file gis/find_file.c
+   \file lib/gis/find_file.c
 
    \brief GIS library - Find GRASS data base files
 

lib/gis/find_rast.c

@@ -1,5 +1,5 @@
 /*!
- * \file strings.c
+ * \file lib/gis/strings.c
  * 
  * \brief GIS Library - Find raster map
  *

lib/gis/find_vect.c

@@ -1,5 +1,5 @@
 /*!
-  \file gis/find_vect.c
+  \file lib/gis/find_vect.c
   
   \brief GIS library - Find a vector map
   

lib/gis/geodist.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/geodist.c
+ * \file lib/gis/geodist.c
  *
  * \brief GIS Library - Geodesic distance routines.
  *

lib/gis/get_ellipse.c

@@ -1,5 +1,5 @@
 /*!
-  \file gis/get_ellipse.c
+  \file lib/gis/get_ellipse.c
 
   \brief GIS Library - Getting ellipsoid parameters from the database.
 

lib/gis/getl.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/getl.c
+ * \file lib/gis/getl.c
  *
  * \brief GIS Library - Get line of text from file
  *

lib/gis/gisdbase.c

@@ -1,5 +1,5 @@
 /*!
-   \file gis/gisdbase.c
+   \file lib/gis/gisdbase.c
 
    \brief GIS library - environment routines (gisdbase)
 

lib/gis/is.c

@@ -1,17 +1,17 @@
 
-/**
- * \file is.c
+/*!
+ * \file lib/gis/is.c
  *
  * \brief GIS Library - Tests for file existence.
  *
- * (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 2001-2008
+ * \date 2001-2014
  */
 
 #include <stdio.h>

lib/gis/key_value4.c

@@ -1,9 +1,9 @@
 /*!
-   \file key_value4.c
+   \file lib/gis/key_value4.c
 
    \brief Key_Value management.
 
-   (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). 

lib/gis/locale.c

@@ -1,10 +1,10 @@
 
-/**
- * \file locale.c
+/*!
+ * \file lib/gis/locale.c
  *
  * \brief GIS Library - Functions to handle locale.
  *
- * (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.

lib/gis/ls.c

@@ -1,6 +1,6 @@
 
 /**
-   \file ls.c
+   \file lib/gis/ls.c
 
    \brief Functions to list the files in a directory.
 

lib/gis/ls_filter.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/ls_filter.c
+ * \file lib/gis/ls_filter.c
  *
  * \brief GIS Library - Filename filter functions
  *

lib/gis/mapset_msc.c

@@ -1,9 +1,9 @@
 /*!
-   \file mapset_msc.c
+   \file lib/gis/mapset_msc.c
 
    \brief GIS library - Mapset user permission routines.
 
-   (C) 1999-2008 The GRASS development team
+   (C) 1999-2014 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.

lib/gis/myname.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/myname.c
+ * \file lib/gis/myname.c
  *
  * \brief GIS Library - Database name functions.
  *

lib/gis/open.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/open.c
+ * \file lib/gis/open.c
  * 
  * \brief GIS Library - Open file functions
  *

lib/gis/parser_interface.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/parser_interface.c
+ * \file lib/gis/parser_interface.c
  *
  * \brief GIS Library - Argument parsing functions (interface)
  *

lib/gis/pole_in_poly.c

@@ -1,5 +1,5 @@
 /*!
-  \file gis/pole_in_poly.c
+  \file lib/gis/pole_in_poly.c
 
   \brief GIS Library - Pole in polygon
   

lib/gis/put_window.c

@@ -1,5 +1,5 @@
 /*!
-  \file gis/put_window.c
+  \file lib/gis/put_window.c
 
   \brief GIS Library - Modify window (i.e. GRASS region)
 

lib/gis/radii.c

@@ -1,5 +1,5 @@
 /*!
-  \file gis/radii.c
+  \file lib/gis/radii.c
 
   \brief GIS Library - Calculating the Meridional Radius of Curvature
   

lib/gis/remove.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/remove.c
+ * \file lib/gis/remove.c
  *
  * \brief GIS Library - File remove functions.
  *

lib/gis/rename.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/rename.c
+ * \file lib/gis/rename.c
  *
  * \brief GIS Library - Rename file functions.
  *

lib/gis/rhumbline.c

@@ -1,6 +1,6 @@
 
-/**
- * \file rhumbline.c
+/*!
+ * \file lib/gis/rhumbline.c
  *
  * \brief GIS Library - Rhumbline calculation routines.
  *
@@ -17,14 +17,14 @@
  * <br>
  * <b>WARNING:</b> This code is preliminary. It may not even be correct.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <math.h>

lib/gis/rotate.c

@@ -1,9 +1,9 @@
 /*!
- * \file rotate.c
+ * \file lib/gis/rotate.c
  *
  * \brief GIS Library - rotate
  *
- * (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

lib/gis/short_way.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/short_way.c
+ * \file lib/gis/short_way.c
  *
  * \brief GIS Library - Shortest path functions.
  *

lib/gis/snprintf.c

@@ -1,6 +1,6 @@
 
-/**
- * \file snprintf.c
+/*!
+ * \file lib/gis/snprintf.c
  *
  * \brief GIS Library - snprintf() clone functions.
  *
@@ -10,7 +10,7 @@
  *   - http://www.ijs.si/software/snprintf/
  *   - openssh's snprintf() implementation: bsd-snprintf.c
  *
- * (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.

lib/gis/spawn.c

@@ -1,10 +1,10 @@
 
-/**
- * \file spawn.c
+/*!
+ * \file lib/gis/spawn.c
  *
  * \brief GIS Library -  Handles process spawning.
  *
- * (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.

lib/gis/timestamp.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/timestamp.c
+ * \file lib/gis/timestamp.c
  *
  * \brief GIS Library - Timestamp management
  *

lib/gis/trim_dec.c

@@ -1,5 +1,5 @@
 /*!
- * \file trim_dec.c
+ * \file lib/gis/trim_dec.c
  *
  * \brief GIS Library - Trim string decimal functions.
  *

lib/gis/units.c

@@ -1,5 +1,5 @@
 /*!
-  \file gis/units.c
+  \file lib/gis/units.c
 
   \brief GIS Library - Units management and conversion
   

lib/gis/user_config.c

@@ -1,6 +1,6 @@
 
-/**
- * \file user_config.c
+/*!
+ * \file lib/gis/user_config.c
  *
  * \brief GIS Library - Routines related to user's GRASS configuration, tmp, and 
  * miscellaneous files.
@@ -15,7 +15,7 @@
  * subdirectories. There may be more functionality desired (such as 
  * deletion routines, directory globs).<br>
  *
- * (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.

lib/gis/view.c

@@ -1,10 +1,10 @@
 
-/**
- * \file view.c
+/*!
+ * \file lib/gis/view.c
  *
  * \brief GIS Library - 3D View functions.
  *
- * (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.

lib/gis/whoami.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/whoami.c
+ * \file lib/gis/whoami.c
  *
  * \brief GIS Library - Login name functions.
  *

lib/gis/wind_2_box.c

@@ -1,17 +1,17 @@
 
-/**
- * \file wind_2_box.c
+/*!
+ * \file lib/gis/wind_2_box.c
  *
  * \brief GIS Library - Window box functions.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <grass/gis.h>

lib/gis/wind_format.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/wind_format.c
+ * \file lib/gis/wind_format.c
  *
  * \brief GIS Library - Window formatting functions.
  *

lib/gis/wind_in.c

@@ -1,6 +1,6 @@
 
-/**
- * \file wind_in.c
+/*!
+ * \file lib/gis/wind_in.c
  *
  * \brief Point in region functions.
  *

lib/gis/wind_limits.c

@@ -1,17 +1,17 @@
 
-/**
- * \file wind_limits.c
+/*!
+ * \file lib/gis/wind_limits.c
  *
  * \brief GIS Library - Projection limit functions.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <grass/gis.h>

lib/gis/wind_overlap.c

@@ -1,17 +1,17 @@
 
-/**
- * \file wind_overlap.c
+/*!
+ * \file lib/gis/wind_overlap.c
  *
  * \brief GIS Library - Window overlap functions.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <grass/gis.h>

lib/gis/worker.c

@@ -1,3 +1,15 @@
+/*!
+ * \file lib/gis/worker.c
+ *
+ * \brief GIS Library - Worker functions.
+ *
+ * (C) 2008-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 Glynn Clements
+ */
 
 #include <stdio.h>
 #include <stdlib.h>

lib/gis/wr_cellhd.c

@@ -1,17 +1,17 @@
 
-/**
- * \file wr_cellhd.c
+/*!
+ * \file lib/gis/wr_cellhd.c
  *
  * \brief GIS Library - Write Cell Header functions.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <stdio.h>

lib/gis/writ_zeros.c

@@ -1,17 +1,17 @@
 
-/**
- * \file writ_zeros.c
+/*!
+ * \file lib/gis/writ_zeros.c
  *
  * \brief GIS Library - Write zero functions.
  *
- * (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-2008
+ * \date 1999-2014
  */
 
 #include <unistd.h>

lib/gis/xdr.c

@@ -1,3 +1,15 @@
+/*!
+ * \file lib/gis/xdr.c
+ *
+ * \brief GIS Library - XDR related functions.
+ *
+ * (C) 2012-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 Glynn Clements
+ */
 
 #include <stdlib.h>
 #include <string.h>

lib/gis/zero.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/zero.c
+ * \file lib/gis/zero.c
  *
  * \brief GIS Library - Zeroing functions.
  *

lib/gis/zone.c

@@ -1,5 +1,5 @@
 /*!
- * \file gis/zone.c
+ * \file lib/gis/zone.c
  *
  * \brief GIS Library - Cartographic zone functions.
  *