Provided by: grass-doc_6.4.3-3_all 
NAME
g.rename - Renames data base element files in the user's current mapset.
KEYWORDS
general, map management
SYNOPSIS
g.rename
g.rename help
g.rename [rast=old,new] [rast3d=old,new] [vect=old,new] [oldvect=old,new] [asciivect=old,new]
[icon=old,new] [labels=old,new] [sites=old,new] [region=old,new] [region3d=old,new]
[group=old,new] [3dview=old,new] [--verbose] [--quiet]
Parameters:
rast=old,new
rast file(s) to be renamed
rast3d=old,new
rast3d file(s) to be renamed
vect=old,new
vect file(s) to be renamed
oldvect=old,new
oldvect file(s) to be renamed
asciivect=old,new
asciivect file(s) to be renamed
icon=old,new
icon file(s) to be renamed
labels=old,new
labels file(s) to be renamed
sites=old,new
sites file(s) to be renamed
region=old,new
region file(s) to be renamed
region3d=old,new
region3d file(s) to be renamed
group=old,new
group file(s) to be renamed
3dview=old,new
3dview file(s) to be renamed
DESCRIPTION
g.rename allows the user to rename data base element files in the user's current mapset. The user can
specify all necessary information to g.rename on the command line, by specifying: the type of data base
element to be renamed (one or more of: rast, vect, icon, labels, sites, region, and group); the specific
file element in the current mapset to be renamed (old); and the new name to be assigned to this file
element (new) in the current mapset. The file element old is then renamed to new.
Users can also simply type g.rename -help 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:
rast rast file(s) to be renamed
oldvect oldvect file(s) to be renamed (GRASS 5.0)
vect vect file(s) to be renamed (GRASS >5.1)
icon icon file(s) to be renamed
labels labels file(s) to be renamed
sites sites file(s) to be renamed
region region file(s) to be renamed
group group file(s) to be renamed
3dview 3dview file(s) to be renamed
NOTES
If a data base element has support files (e.g., as is commonly the case with raster maps), these support
files also are renamed.
If the user attempts to rename a file to itself by setting the new file name equal to the old file name
(e.g., g.rename rast=soils,soils), g.rename will not execute the rename, but instead state that no rename
is needed. However, g.rename will allow the user to overwrite other existing files in the current mapset
by making the new file name that of an already existing file.
For portability reasons, g.rename is ignoring case of names. To change the case of a map name, first
rename the map to a name which differs by more than case, then rename it to the intended name.
EXAMPLE
# rename raster map
g.rename rast=oldrast,newrast
# rename vector map
g.rename vect=oldvect,newvect
# combined renaming
g.rename rast=oldrast,newrast vect=oldvect,newvect
SEE ALSO
g.copy
g.list
g.remove
AUTHOR
Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
Last changed: $Date: 2008-10-11 23:55:55 -0700 (Sat, 11 Oct 2008) $
Full index
© 2003-2013 GRASS Development Team