1g.rename(1)                   Grass User's Manual                  g.rename(1)
2
3
4

NAME

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

KEYWORDS

10       general
11

SYNOPSIS

13       g.rename
14       g.rename help
15       g.rename  [rast=old,new]    [rast3d=old,new]    [vect=old,new]    [old‐
16       vect=old,new]   [asciivect=old,new]   [icon=old,new]   [labels=old,new]
17       [sites=old,new]           [region=old,new]           [region3d=old,new]
18       [group=old,new]   [3dview=old,new]
19
20   Parameters:
21       rast=old,new
22           rast file(s) to be renamed
23
24       rast3d=old,new
25           rast3d file(s) to be renamed
26
27       vect=old,new
28           vect file(s) to be renamed
29
30       oldvect=old,new
31           oldvect file(s) to be renamed
32
33       asciivect=old,new
34           asciivect file(s) to be renamed
35
36       icon=old,new
37           icon file(s) to be renamed
38
39       labels=old,new
40           labels file(s) to be renamed
41
42       sites=old,new
43           sites file(s) to be renamed
44
45       region=old,new
46           region file(s) to be renamed
47
48       region3d=old,new
49           region3d file(s) to be renamed
50
51       group=old,new
52           group file(s) to be renamed
53
54       3dview=old,new
55           3dview file(s) to be renamed
56

DESCRIPTION

58       g.rename  allows  the  user  to  rename  data base element files in the
59       user's current mapset.  The user can specify all necessary  information
60       to  g.rename on the command line, by specifying:  the type of data base
61       element to be renamed (one or  more  of:   rast,  vect,  icon,  labels,
62       sites,  region,  and  group);  the specific file element in the current
63       mapset to be renamed (old); and the new name to  be  assigned  to  this
64       file element (new) in the current mapset.  The file element old is then
65       renamed to new.
66
67       Users can also simply type g.rename -help without arguments on the com‐
68       mand  line,  to  receive a menu of existing data base element types and
69       files from which to choose for possible renaming:
70            rast   rast file(s) to be renamed
71         oldvect   oldvect file(s) to be renamed (GRASS 5.0)
72            vect   vect file(s) to be renamed    (GRASS >5.1)
73            icon   icon file(s) to be renamed
74          labels   labels file(s) to be renamed
75           sites   sites file(s) to be renamed
76          region   region file(s) to be renamed
77           group   group file(s) to be renamed
78          3dview   3dview file(s) to be renamed
79
80

NOTES

82       If a data base element has support files (e.g., as is commonly the case
83       with raster files), these support files also are renamed.
84
85       If the user attempts to rename a file to itself by setting the new file
86       name equal to the old  file  name  (e.g.,  g.rename  rast=soils,soils),
87       g.rename  will not execute the rename, but instead state that no rename
88       is needed.  However, g.rename will allow the user  to  overwrite  other
89       existing  files  in the current mapset by making the new file name that
90       of an already existing file.
91

EXAMPLE

93
94       g.rename  rast=oldrast,newrast  vect=oldvect51,newvect51   oldvect=old‐
95       vect50,newvect50
96
97

SEE ALSO

99       g.copy
100       g.list
101       g.remove
102

AUTHOR

104       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
105
106       Full index
107
108
109
110GRASS 6.2.2                                                        g.rename(1)