veditlib: doxygen clean up

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

lib/vector/vedit/break.c

@@ -1,16 +1,14 @@
-/**
-   \file vector/vedit/break.c
-
-   \brief Vedit library - split, break, connect lines
-
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+/*!
+  \file lib/vector/vedit/break.c
+
+  \brief Vedit library - split, break, connect lines
+  
+  (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/config.h>
@@ -20,17 +18,17 @@
 static int connect_lines(struct Map_info *, int, int, int,
 			 double, struct ilist *);
 
-/**
-   \brief Split selected lines on given position
-   
-   \param Map vector map
-   \param List list of selected lines
-   \param coord points location
-   \param[out] List_updated list of rewritten features (or NULL)
-
-   \return number of modified lines
-   \return -1 on error
- */
+/*!
+  \brief Split selected lines on given position
+  
+  \param Map pointer to Map_info
+  \param List list of selected lines
+  \param coord points location
+  \param[out] List_updated list of rewritten features (or NULL)
+  
+  \return number of modified lines
+  \return -1 on error
+*/
 int Vedit_split_lines(struct Map_info *Map, struct ilist *List,
 		      struct line_pnts *coord, double thresh,
 		      struct ilist *List_updated)
@@ -131,20 +129,20 @@ int Vedit_split_lines(struct Map_info *Map, struct ilist *List,
     return nlines_modified;
 }
 
-/**
-   \brief Connect lines in given threshold
- 
-   <pre>
-        \         	     \
+/*!
+  \brief Connect lines in given threshold
+  
+  \code
+        \	             \
    id1   \           ->	      \
                                \
    id2 ---------           -----+---
-   </pre>
+   \endcode
 
    If two lines are selected and <i>thresh</i> is -1, no limit is
    applied.
 
-   \param Map vector map
+   \param Map pointer to Map_info
    \param List list of selected lines
    \param thresh threshold value
 

lib/vector/vedit/cats.c

@@ -1,35 +1,32 @@
-
-/**
-   \file vector/vedit/cats.c
-
-   \brief Vedit library - category manipulation
-
-   (C) 2006-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
-   \author Martin Landa <landa.martin gmail.com>
-
-   \date 2006-2008
+/*!
+  \file lib/vector/vedit/cats.c
+
+  \brief Vedit library - category manipulation
+  
+  (C) 2006-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
+  \author Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/config.h>
 #include <grass/glocale.h>
 #include <grass/vedit.h>
 
-/**
-   \brief Add / remove categories
-
-   \param Map vector map
-   \param List list of selected primitives
-   \param layer layer number
-   \param del action (non-zero for delete otherwise add)
-   \param cats_list list of category numbers
-
-   \return number of modified primitives
-   \return -1 on error
+/*!
+  \brief Add / remove categories
+  
+  \param Map pointer to Map_info
+  \param List list of selected primitives
+  \param layer layer number
+  \param del action (non-zero for delete otherwise add)
+  \param cats_list list of category numbers
+  
+  \return number of modified primitives
+  \return -1 on error
 */
 int Vedit_modify_cats(struct Map_info *Map, struct ilist *List,
 		      int layer, int del, struct cat_list *Clist)

lib/vector/vedit/chtype.c

@@ -1,33 +1,30 @@
-
-/**
-   \file vector/vedit/chtype.c
-
-   \brief Vedit library - change primitives type
-
-    (C) 2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2008
+/*!
+  \file vector/vedit/chtype.c
+  
+  \brief Vedit library - change primitives type
+  
+  (C) 2008 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 Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Change primitive type
-
-   Supported conversions:
-    - point <-> centroid
-    - line <-> boundary
-
-    \param Map vector map
-    \param List list of selected primitives
-
-    \return number of modified primitives
-    \return -1 on error
+/*!
+  \brief Change primitive type
+  
+  Supported conversions:
+   - point <-> centroid
+   - line <-> boundary
+
+   \param Map pointer to Map_info
+   \param List list of selected primitives
+   
+   \return number of modified primitives
+   \return -1 on error
 */
 int Vedit_chtype_lines(struct Map_info *Map, struct ilist *List)
 {

lib/vector/vedit/copy.c

@@ -1,32 +1,29 @@
-
-/**
-   \file vector/vedit/copy.c
-
-   \brief Vedit library - copy primitives
-
-   (C) 2007-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
-   \author Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+/*!
+  \file lib/vector/vedit/copy.c
+
+  \brief Vedit library - copy primitives
+  
+  (C) 2007-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
+  \author Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Copy selected primitives
-
-   \param Map vector map copy to
-   \param FromMap vector map copy from (if not given use Map)
-   \param List list of selected primitives (to be copied)
-
-   \return number of copied primitives
-   \return -1 on error 
- */
+/*!
+  \brief Copy selected primitives
+  
+  \param Map pointer to Map_info copy to
+  \param FromMap vector map copy from (if not given use Map)
+  \param List list of selected primitives (to be copied)
+  
+  \return number of copied primitives
+  \return -1 on error 
+*/
 int Vedit_copy_lines(struct Map_info *Map, struct Map_info *FromMap,
 		     struct ilist *List)
 {

lib/vector/vedit/delete.c

@@ -1,30 +1,27 @@
+/*!
+  \file lib/vector/vedit/delete.c
 
-/**
-   \file vector/vedit/delete.c
+  \brief Vedit library - delete primitives
 
-   \brief Vedit library - delete primitives
+  (C) 2007-2008 by the GRASS Development Team
 
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+  This program is free software under the GNU General Public License
+  (>=v2).  Read the file COPYING that comes with GRASS for details.
+  
+  \author Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Delete selected primitives
-
-   \param Map vector map
-   \param List list of primitives to be deleted
-
-   \return number of deleted primitives
-   \return -1 on on error
- */
+/*!
+  \brief Delete selected primitives
+  
+  \param Map pointer to Map_info
+  \param List list of primitives to be deleted
+  
+  \return number of deleted primitives
+  \return -1 on on error
+*/
 int Vedit_delete_lines(struct Map_info *Map, struct ilist *List)
 {
     int i, line;

lib/vector/vedit/distance.c

@@ -1,31 +1,28 @@
+/*!
+  \file lib/vector/vedit/distance.c
 
-/**
-   \file vector/vedit/distance.c
+  \brief Vedit library - distance calculation
+  
+  (C) 2007-2008 by the GRASS Development Team
 
-   \brief Vedit library - distance calculation
-
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+  This program is free software under the GNU General Public License
+  (>=v2).  Read the file COPYING that comes with GRASS for details.
+  
+  \author Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Calculate distances between two lines
- 
-   \todo LL projection
-
-   \param Points1 first line geometry
-   \param Points2 second line geometry
-   \param[out] index of minimal distance
-
-   \return minimal distance betwen two lines (their nodes)
+/*!
+  \brief Calculate distances between two lines
+  
+  \todo LL projection
+  
+  \param Points1 first line geometry
+  \param Points2 second line geometry
+  \param[out] index of minimal distance
+  
+  \return minimal distance betwen two lines (their nodes)
 */
 double Vedit_get_min_distance(struct line_pnts *Points1,
 			      struct line_pnts *Points2, int with_z,

lib/vector/vedit/flip.c

@@ -1,30 +1,27 @@
-
-/**
-   \file vector/vedit/flip.c
-
-   \brief Vedit library - flip lines
-
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+/*!
+  \file lib/vector/vedit/flip.c
+   
+  \brief Vedit library - flip lines
+  
+  (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Flip direction of selected lines
-
-   \param Map vector map
-   \param List list of selected lines
-
-   \return number of modified lines
-   \return -1 on error
- */
+/*!
+  \brief Flip direction of selected lines
+  
+  \param Map pointer to Map_info
+  \param List list of selected lines
+  
+  \return number of modified lines
+  \return -1 on error
+*/
 int Vedit_flip_lines(struct Map_info *Map, struct ilist *List)
 {
     struct line_cats *Cats;

lib/vector/vedit/merge.c

@@ -1,49 +1,46 @@
-
-/**
-   \file vector/vedit/merge.c
-
-   \brief Vedit library - merge lines
-
-   (C) 2006-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
-   \author Martin Landa <landa.martin gmail.com>
-
-   \date 2006-2008
+/*!
+  \file lib/vector/vedit/merge.c
+  
+  \brief Vedit library - merge lines
+  
+  (C) 2006-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
+  \author Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Merge two given lines a, b
-   
-   a : Points1/Cats1
-   b : Points2/Cats2
-   merged line : Points/Cats
+/*!
+  \brief Merge two given lines a, b
+  
+  a : Points1/Cats1
+  b : Points2/Cats2
+  merged line : Points/Cats
    
-   \param Points1,Cats1 first line
-   \param Points2,Cats2 second line
-   \param thresh threshold value
-   \param[out] Points result line
-
-   \return 1 on success
-   \return 0 on error
+  \param Points1,Cats1 first line
+  \param Points2,Cats2 second line
+  \param thresh threshold value
+  \param[out] Points result line
+  
+  \return 1 on success
+  \return 0 on error
 */
 static int merge_lines(struct line_pnts *Points1, struct line_cats *Cats1,
 		       struct line_pnts *Points2, struct line_cats *Cats2,
 		       double thresh, struct line_pnts **Points);
 
-/**
-   \brief Merge lines/boundaries
- 
-   At least two lines need to be given.
-
-   \param Map vector map
-   \param List list of selected lines
-
+/*!
+  \brief Merge lines/boundaries
+  
+  At least two lines need to be given.
+  
+  \param Map pointer to Map_info
+  \param List list of selected lines
+  
    \return number of merged lines
    \return -1 on error
 */

lib/vector/vedit/move.c

@@ -1,33 +1,30 @@
-
-/**
-   \file vector/vedit/move.c
-
-   \brief Vedit library - move primitives
-
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-   \author Jachym Cepicky <jachym.cepicky gmail.com>
-
-   \date 2007-2008
+/*!
+  \file lib/vector/vedit/move.c
+  
+  \brief Vedit library - move primitives
+  
+  (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
+  \author Jachym Cepicky <jachym.cepicky gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Move selected primitives
-   
-   \param Map vector map
-   \param BgMap, nbgmaps list of background vector maps used for snapping   
-   \param List list of primitives to be moved
-   \param move_x,move_y,move_z direction (move_z used only if map is 3D)
-   \param snap enable snapping (see globals.h)
-
-   \return number of modified primitives
-   \return -1 on error
+/*!
+  \brief Move selected primitives
+  
+  \param Map pointer to Map_info
+  \param BgMap, nbgmaps list of background vector maps used for snapping   
+  \param List list of primitives to be moved
+  \param move_x,move_y,move_z direction (move_z used only if map is 3D)
+  \param snap enable snapping (see globals.h)
+  
+  \return number of modified primitives
+  \return -1 on error
 */
 int Vedit_move_lines(struct Map_info *Map, struct Map_info **BgMap,
 		     int nbgmaps, struct ilist *List, double move_x,

lib/vector/vedit/render.c

@@ -3,7 +3,7 @@
 
    \brief Vedit library - render vector features (used by wxGUI digitizer)
 
-   (C) 2010 by the GRASS Development Team
+   (C) 2010-2011 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.
@@ -49,15 +49,15 @@ static void draw_arrow(int, int, int, int, double, int, int,
 static void draw_area(struct Map_info *, int, struct robject_list *);
 
 /*!
-   \brief Render vector features into list
-
-   \param Map pointer to Map_info structure
-   \param box bounding box of region to be rendered
-   \param draw_flag types of objects to be rendered (see vedit.h)
-   \param center_easing, center_northing, map_width, map_height, map_res values used for conversion en->xy
-
-   \return pointer to robject_list structure
- */
+  \brief Render vector features into list
+  
+  \param Map pointer to Map_info structure
+  \param box bounding box of region to be rendered
+  \param draw_flag types of objects to be rendered (see vedit.h)
+  \param center_easing, center_northing, map_width, map_height, map_res values used for conversion en->xy
+  
+  \return pointer to robject_list structure
+*/
 struct robject_list *Vedit_render_map(struct Map_info *Map,
 				      struct bound_box *box, int draw_flag,
 				      double center_easting,
@@ -125,7 +125,7 @@ struct robject_list *Vedit_render_map(struct Map_info *Map,
 	    }
 	    /* direction */
 	    if (draw_flag & DRAW_DIRECTION) {
-	      draw_line_dir(list_obj, fid);
+		draw_line_dir(list_obj, fid);
 	    }
 	}
     }

lib/vector/vedit/select.c

@@ -1,17 +1,14 @@
-
-/**
-   \file vector/vedit/select.c
-
-   \brief Vedit library - select primitives by query
-
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+/*!
+  \file lib/vector/vedit/select.c
+
+  \brief Vedit library - select primitives by query
+  
+  (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
 */
 
 #include <math.h>
@@ -23,24 +20,24 @@ static int select_by_query(struct Map_info *, int, int, double,
 
 static int merge_lists(struct ilist *alist, struct ilist *blist);
 
-/**
-   \brief Select primitives by query (based on geometry properties)
-
-   Currently supported:
-    - QUERY_LENGTH, select all lines longer than threshold (or shorter if threshold is < 0)
-    - QUERY_DANGLE, select all dangles longer than threshold (or shorter if threshold is < 0)
-
-   Perform global query if <i>List</i> is empty otherwise query only
-   selected vector objects.
-
-   \param Map vector map
-   \param type feature type
-   \param layer layer number
-   \param thresh threshold value (< 0 for 'shorter', > 0 for 'longer')
-   \param query query (length, dangle, ...)
-   \param[in,out] List list of selected features
- 
-   \return number of selected primitives
+/*!
+  \brief Select primitives by query (based on geometry properties)
+  
+  Currently supported:
+   - QUERY_LENGTH, select all lines longer than threshold (or shorter if threshold is < 0)
+   - QUERY_DANGLE, select all dangles longer than threshold (or shorter if threshold is < 0)
+
+  Perform global query if <i>List</i> is empty otherwise query only
+  selected vector objects.
+
+  \param Map pointer to Map_info
+  \param type feature type
+  \param layer layer number
+  \param thresh threshold value (< 0 for 'shorter', > 0 for 'longer')
+  \param query query (length, dangle, ...)
+  \param[in,out] List list of selected features
+  
+  \return number of selected primitives
 */
 int Vedit_select_by_query(struct Map_info *Map,
 			  int type, int layer, double thresh, int query,
@@ -126,7 +123,7 @@ int Vedit_select_by_query(struct Map_info *Map,
     return List->n_values;
 }
 
-/**
+/*!
    \brief Query selected primitive
 
    \return 1 line test positive 
@@ -237,7 +234,7 @@ int select_by_query(struct Map_info *Map, int line, int type, double thresh,
     return 0;
 }
 
-/**
+/*!
    \brief Merge two lists, i.e. store only duplicate items
 
    \param[in,out] alist list to be merged

lib/vector/vedit/snap.c

@@ -1,32 +1,29 @@
-
-/**
-   \file vector/vedit/snap.c
-
-   \brief Vedit library - snapping
-
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+/*!
+  \file lib/vector/vedit/snap.c
+
+  \brief Vedit library - snapping
+  
+  (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Snap given point to the nearest primitive
-   
-   \param Map vector map
-   \param line line to be excluded (point on line)
-   \param x,y,z point on line to be snapped
-   \param thresh snapping threshold (>0)
-   \param vertex snap also to vertex (non-zero)
-
-   \return 1 snapped
-   \return 0 not snapped
+/*!
+  \brief Snap given point to the nearest primitive
+  
+  \param Map pointer to Map_info
+  \param line line to be excluded (point on line)
+  \param x,y,z point on line to be snapped
+  \param thresh snapping threshold (>0)
+  \param vertex snap also to vertex (non-zero)
+  
+  \return 1 snapped
+  \return 0 not snapped
 */
 int Vedit_snap_point(struct Map_info *Map,
 		     int line, double *x, double *y, double *z, double thresh,
@@ -84,20 +81,20 @@ int Vedit_snap_point(struct Map_info *Map,
     return snapped;
 }
 
-/**
-   \brief Snap selected primitive to its nearest primitive
-   
-   \param Map vector map
-   \param BgMap,nbgmaps list of background maps used for snapping
-   \param line line id to be snapped (if already written, otherwise -1)
-   \param Points line geometry
-   \param layer layer number
-   \param thresh threshold value used for snapping (>0)
-   \param to_vertex allow snapping also to vertex
-
-   \return 1 line snapped
-   \return 0 line not snapped
-   \return -1 line is dead (if 'line' is > 0)
+/*!
+  \brief Snap selected primitive to its nearest primitive
+  
+  \param Map pointer to Map_info
+  \param BgMap,nbgmaps list of background maps used for snapping
+  \param line line id to be snapped (if already written, otherwise -1)
+  \param Points line geometry
+  \param layer layer number
+  \param thresh threshold value used for snapping (>0)
+  \param to_vertex allow snapping also to vertex
+  
+  \return 1 line snapped
+  \return 0 line not snapped
+  \return -1 line is dead (if 'line' is > 0)
 */
 int Vedit_snap_line(struct Map_info *Map, struct Map_info **BgMap,
 		    int nbgmaps, int line, struct line_pnts *Points,
@@ -162,18 +159,18 @@ int Vedit_snap_line(struct Map_info *Map, struct Map_info **BgMap,
     return rewrite;
 }
 
-/**
-   \brief Snap lines/boundaries
-   
-   \param Map vector map
-   \param BgMap,nbgmaps list of background maps used for snapping
-   \param List list of lines to be snapped
-   \param layer layer number
-   \param thresh threshold value used for snapping (>0)
-   \param to_vertex allow snapping also to vertex
-
-   \return number of snapped lines
-   \return -1 on error
+/*!
+  \brief Snap lines/boundaries
+  
+  \param Map pointer to Map_info
+  \param BgMap,nbgmaps list of background maps used for snapping
+  \param List list of lines to be snapped
+  \param layer layer number
+  \param thresh threshold value used for snapping (>0)
+  \param to_vertex allow snapping also to vertex
+  
+  \return number of snapped lines
+  \return -1 on error
 */
 int Vedit_snap_lines(struct Map_info *Map, struct Map_info **BgMap,
 		     int nbgmaps, struct ilist *List, double thresh,

lib/vector/vedit/veditlib.dox

@@ -62,9 +62,7 @@ The library is used by <tt>v.edit</tt> module and wxGUI %vector digitizer.
 
  - Vedit_bulk_labeling()
 
-\section authors Authors
-
- Martin Landa <landa.martin gmail.com>
+ - Vedit_render_map()
 
 \section seealso See Also
 
@@ -72,5 +70,8 @@ The library is used by <tt>v.edit</tt> module and wxGUI %vector digitizer.
   
  - \ref dbmilib
 
-Last change: $Date$
+\section authors Authors
+
+ Martin Landa <landa.martin gmail.com>
+
 */

lib/vector/vedit/vertex.c

@@ -1,38 +1,35 @@
-
-/**
-   \file vector/vedit/vertex.c
-
-   \brief Vedit library - vertex manipulation
-
-   (C) 2006-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
-   \author Martin Landa <landa.martin gmail.com>
-
-   \date 2006-2008
+/*!
+  \file lib/vector/vedit/vertex.c
+  
+  \brief Vedit library - vertex manipulation
+  
+  (C) 2006-2008 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 Jachym Cepicky <jachym.cepicky gmail.com>
+  \author Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/vedit.h>
 
-/**
-   \brief Move all vertices in bounding box(es)
-
-   \param Map vector map
-   \param BgMap, nbgmaps list of background vector maps for snapping
-   \param List list of selected lines
-   \param coord points location
-   \param thresh_coords threshold value for selecting lines
-   \param thresh_snap threshold value used for snapping
-   \param move_x,move_y,move_z direction (move_z is used when map is 3D)
-   \param move_first move only first vertex found in the bounding box
-   \param snap snapping mode (see vedit.h)
-
-   \return number of moved verteces
-   \return -1 on error
- */
+/*!
+  \brief Move all vertices in bounding box(es)
+  
+  \param Map pointer to Map_info
+  \param BgMap, nbgmaps list of background vector maps for snapping
+  \param List list of selected lines
+  \param coord points location
+  \param thresh_coords threshold value for selecting lines
+  \param thresh_snap threshold value used for snapping
+  \param move_x,move_y,move_z direction (move_z is used when map is 3D)
+  \param move_first move only first vertex found in the bounding box
+  \param snap snapping mode (see vedit.h)
+  
+  \return number of moved verteces
+  \return -1 on error
+*/
 int Vedit_move_vertex(struct Map_info *Map, struct Map_info **BgMap,
 		      int nbgmaps, struct ilist *List,
 		      struct line_pnts *coord, double thresh_coords,
@@ -179,20 +176,20 @@ int Vedit_move_vertex(struct Map_info *Map, struct Map_info **BgMap,
     return nvertices_moved;
 }
 
-/**
-   \brief Add new vertex to line
-
-   Shape of line is not changed.
-
-   \todo 3D
-
-   \param Map vector map
-   \param List list of lines
-   \param coord points location
-   \param thresh find line in given threshold
-
-   \return number of add verteces
-   \return -1 on error
+/*!
+  \brief Add new vertex to line
+  
+  Shape of line is not changed.
+  
+  \todo 3D
+  
+  \param Map pointer to Map_info
+  \param List list of lines
+  \param coord points location
+  \param thresh find line in given threshold
+  
+  \return number of add verteces
+  \return -1 on error
 */
 int Vedit_add_vertex(struct Map_info *Map, struct ilist *List,
 		     struct line_pnts *coord, double thresh)
@@ -269,18 +266,18 @@ int Vedit_add_vertex(struct Map_info *Map, struct ilist *List,
     return nvertices_added;
 }
 
-/**
-   \brief Remove vertex from line
-
-   \todo 3D
-
-   \param Map vector map
-   \param List list of selected lines
-   \param coord points location
-   \param thresh threshold value to find a line
-
-   \return number of removed vertices
-   \return -1 on error
+/*!
+  \brief Remove vertex from line
+  
+  \todo 3D
+  
+  \param Map pointer to Map_info
+  \param List list of selected lines
+  \param coord points location
+  \param thresh threshold value to find a line
+  
+  \return number of removed vertices
+  \return -1 on error
 */
 int Vedit_remove_vertex(struct Map_info *Map, struct ilist *List,
 			struct line_pnts *coord, double thresh)

lib/vector/vedit/zbulk.c

@@ -1,37 +1,34 @@
-
-/**
-   \file vector/vedit/zbulk.c
-
-   \brief Vedit library - Bulk labeling (automated labeling of vector
-   features)
-
-   (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
-
-   \date 2007-2008
+/*!
+  \file lib/vector/vedit/zbulk.c
+
+  \brief Vedit library - Bulk labeling (automated labeling of vector
+  features)
+  
+  (C) 2007-2008 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 Martin Landa <landa.martin gmail.com>
 */
 
 #include <grass/config.h>
 #include <grass/dbmi.h>
 #include <grass/vedit.h>
 
-/**
-   \brief Lines z-bulk labeling
-
-   Automated labeling (z coordinate assignment) of vector lines (iso-lines).
-
-   \param Map vector map
-   \param List list of selected lines
-   \param point_start_end staring and ending point
-   \param start starting value
-   \param step step value
-
-   \return number of modified features
-   \return -1 on error
+/*!
+  \brief Lines z-bulk labeling
+  
+  Automated labeling (z coordinate assignment) of vector lines (iso-lines).
+  
+  \param Map pointer to Map_info
+  \param List list of selected lines
+  \param point_start_end staring and ending point
+  \param start starting value
+  \param step step value
+  
+  \return number of modified features
+  \return -1 on error
 */
 int Vedit_bulk_labeling(struct Map_info *Map, struct ilist *List,
 			double x1, double y1, double x2, double y2,