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    [--oo]    [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


   FFllaaggss::
       --oo     Overwrite  file(s)


NNOOTTEE
       If a data base element has support files (e.g., as is commonly 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.  However, _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_/_1_1_/_1_2 _1_0_:_4_6_:_2_6 _$



GRASS 5.0							   g.rename(1)
