g.rename(1)	       Grass User's Manual	      g.rename(1)



NNAAMMEE
       gg..rreennaammee   -  To  rename  data  base  element files in the
       user's current mapset.
       _(_G_R_A_S_S _F_i_l_e _M_a_n_a_g_e_m_e_n_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       gg..rreennaammee
       gg..rreennaammee hheellpp
       gg..rreennaammee  [rraasstt==_o_l_d_,_n_e_w]   [vveecctt==_o_l_d_,_n_e_w]   [iiccoonn==_o_l_d_,_n_e_w]
       [llaabbeellss==_o_l_d_,_n_e_w]      [ssiitteess==_o_l_d_,_n_e_w]	 [rreeggiioonn==_o_l_d_,_n_e_w]
       [ggrroouupp==_o_l_d_,_n_e_w]

DDEESSCCRRIIPPTTIIOONN
       _g_._r_e_n_a_m_e allows the user to rename data base element files
       in  the	user's	current mapset.  The user can specify all
       necessary information to _g_._r_e_n_a_m_e on the command line,  by
       specifying:   the  type of data base element to be renamed
       (one or more of:  rraasstt, vveecctt, iiccoonn, llaabbeellss, ssiitteess, rreeggiioonn,
       and  ggrroouupp);  the  specific  file  element  in the current
       mapset to be  renamed  (_o_l_d);  and  the	new  name  to  be
       assigned to this file element (_n_e_w) in the current mapset.
       The file element _o_l_d is then renamed to _n_e_w.


       Users can also simply type gg..rreennaammee without  arguments  on
       the  command line, to receive a menu of existing data base
       element types and files from which to choose for  possible
       renaming:



	      raster maps

	      binary vector maps

	      paint icon files

	      paint label files

	      site list files

	      region definition files

	      imagery group files


       RETURN to exit


NNOOTTEE
       If a data base element has support files (e.g., as is com-
       monly the case with raster  files),  these  support  files
       also are renamed.


       If the user attempts to rename a file to itself by setting
       the _n_e_w file name  equal  to  the  _o_l_d  file  name  (e.g.,
       gg..rreennaammee  rraasstt==ssooiillss,,ssooiillss), _g_._r_e_n_a_m_e will not execute the
       rename, but instead state that no rename is needed.   How-
       ever,  _g_._r_e_n_a_m_e	will  allow  the  user to overwrite other
       existing files in the current mapset  by  making  the  _n_e_w
       file name that of an already existing file.

SSEEEE AALLSSOO
       _g_._c_o_p_y

       _g_._l_i_s_t

       _g_._r_e_m_o_v_e

AAUUTTHHOORR
       Michael	 Shapiro,   U.S.Army   Construction   Engineering
       Research Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0					      g.rename(1)
