Linux Certif

Toute la documentation sur la certification Linux LPI

g.rename

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.

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

Last changed: $Date: 2007-02-12 16:36:55 +0100 (Mon, 12 Feb 2007) $

Full index

© 2003-2008 GRASS Development Team