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



NNAAMMEE
       gg..ccooppyy	-  Copies  available  data  files in the user's current mapset
       search path and location to the appropriate element  directories  under
       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..ccooppyy
       gg..ccooppyy hheellpp
       gg..ccooppyy  [rraasstt==_f_r_o_m_,_t_o]  [vveecctt==_f_r_o_m_,_t_o]  [iiccoonn==_f_r_o_m_,_t_o] [llaabbeellss==_f_r_o_m_,_t_o]
       [ssiitteess==_f_r_o_m_,_t_o] [rreeggiioonn==_f_r_o_m_,_t_o] [ggrroouupp==_f_r_o_m_,_t_o]

DDEESSCCRRIIPPTTIIOONN
       A user may access data stored under the other  mapsets  listed  in  his
       mapset  search  path.   However,  the  user may only modify data stored
       under his own current mapset.  _g_._c_o_p_y allows the user to copy  existing
       data  files  _f_r_o_m other mapsets _t_o the user's current mapset ($MAPSET).
       The files to be copied must exist in the user's current	mapset	search
       path  and  location; output is sent to the relevant data element direc-
       tory(ies) under the user's current mapset.

OOPPTTIIOONNSS
       The user specifies the type(s) of data files he wishes to copy (raster,
       vector,	etc.),	the  name of the existing file to be copied (i.e., the
       _f_r_o_m file name), and the name of the new file copy to be placed in  the
       user's  current	mapset	(the  _t_o  file name).  This information can be
       given either (non-interactively) on the command	line,  or  entered  in
       response to program prompts given via the standard _p_a_r_s_e_r interface.


       Information can be entered on the command line in the following format:
       gg..ccooppyy [rraasstt==_f_r_o_m_,_t_o]  [vveecctt==_f_r_o_m_,_t_o]  [iiccoonn==_f_r_o_m_,_t_o]  [llaabbeellss==_f_r_o_m_,_t_o]
       [ssiitteess==_f_r_o_m_,_t_o] [rreeggiioonn==_f_r_o_m_,_t_o] [ggrroouupp==_f_r_o_m_,_t_o]



       For  example, if the user wished to copy the existing raster file _s_o_i_l_s
       to a file called _s_o_i_l_s_._p_h and to copy an existing vector file _r_o_a_d_s  to
       a  file called _r_d_s_._o_l_d, the user could type: gg..ccooppyy rraasstt==_s_o_i_l_s_,_s_o_i_l_s_._p_h
       vveecctt==_r_o_a_d_s_,_r_d_s_._o_l_d

       Data files can also be specified by their mapsets.   For  example,  the
       below command copies the raster file named _s_o_i_l_s from the mapset _w_i_l_s_o_n
       to a new file called _s_o_i_l_s  to  be  placed  under  the  user's  current
       mapset: gg..ccooppyy rraasstt==_'_s_o_i_l_s_@_w_i_l_s_o_n_'_,_s_o_i_l_s

       If  no mapset name is specified, _g_._c_o_p_y searches for the named _f_r_o_m map
       in each of the mapset directories listed in the user's  current	mapset
       search  path  in  the  order  in  which	mapsets  are listed there (see
       _g_._m_a_p_s_e_t_s).


       If the user does not enter parameter  values  but  instead  types  only
       gg..ccooppyy  on the command line the program will prompt the user for a data
       type, the name of a file of this data type to copy, and the name  of  a
       new  file  to  hold the copy.  After both file names have been entered,
       the copy is created and the user is again prompted for a  data  element
       to  be  copied,	until  the  user  hits RETURN.	When prompted for file
       names, the user may enter 'list' to see a list of  existing  files,  or
       hit RETURN to end the file listing.

   PPaarraammeetteerrss::
       33ddvviieeww==_f_r_o_m_,_t_o
	      where  _f_r_o_m  is  an existing 3d options file, and _t_o is the name
	      given to the copy.

       rraasstt==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing raster map layer to be copied, and  _t_o
	      is the name given to the copy.

       vveecctt==_f_r_o_m_,_t_o
	      where  _f_r_o_m is an existing binary vector map layer to be copied,
	      and _t_o is the name given to the copy.

       iiccoonn==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing paint icon file to be copied,  and  _t_o
	      is the name given to the copy.

       llaabbeellss==_f_r_o_m_,_t_o
	      where  _f_r_o_m  is an existing /paint/labels file to be copied, and
	      _t_o is the name given to the copy.

       ssiitteess==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing site_lists file to be copied,  and  _t_o
	      is the name given to the copy.

       rreeggiioonn==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing region definition (_w_i_n_d_o_w_s) file to be
	      copied, and _t_o is the name given to the copy.

       ggrroouupp==_f_r_o_m_,_t_o
	      where _f_r_o_m is an existing imagery group file to be  copied,  and
	      _t_o is the name given to the copy.


NNOOTTEE
       If a file has support files (e.g., as do raster data files), these sup-
       port files will also be copied.

SSEEEE AALLSSOO
       _g_._a_c_c_e_s_s

       _g_._l_i_s_t

       _g_._m_a_p_s_e_t_s

       _g_._r_e_m_o_v_e

       _g_._r_e_n_a_m_e

       _p_a_r_s_e_r

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.copy(1)
