## NAME

g.rename - Renames data base element files in the user's current mapset.

## KEYWORDS

general

## 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]

### 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 files), 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.

## EXAMPLE

    g.rename rast=oldrast,newrast vect=oldvect51,newvect51 oldvect=oldvect50,newvect50

## SEE ALSO

g.copy
g.list
g.remove

## AUTHOR

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

Main index - general index - Full index