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