Debian Codegraph @

general/g.rename/g.rename.html

raw
1 <h2>DESCRIPTION</h2>
2
3 <em>g.rename</em> allows the user to rename data base
4 element files in the user's current mapset. The user can
5 specify all necessary information to <em>g.rename</em> on
6 the command line, by specifying: the type of data base
7 element to be renamed (one or more of: <b>raster</b>,
8 <b>raster_3d</b>, <b>vector</b>, <b>icon</b>, <b>labels</b>,
9 <b>region</b>, and <b>group</b>); the specific file element
10 in the current mapset to be renamed (<em>old</em>); and the
11 new name to be assigned to this file element (<em>new</em>)
12 in the current mapset. The file element <em>old</em> is
13 then renamed to <em>new</em>.
14
15 <p>
16 Users can also simply type <em>g.rename --help</em> without
17 arguments on the command line, to receive a menu of
18 existing data base element types and files from which to
19 choose for possible renaming:
20
21 <div class="code"><pre>
22 raster raster map(s) to be renamed
23 raster_3d 3D raster map(s) to be renamed
24 vector vector map(s) to be renamed
25 labels paint label file(s) to be renamed
26 region region definition(s) to be renamed
27 group imagery group(s) to be renamed
28 </pre></div>
29
30 <h2>NOTES</h2>
31
32 If a data base element has support files (e.g., as is
33 commonly the case with raster maps), these support files
34 also are renamed.
35
36 <p>
37 If the user attempts to rename a file to itself by setting
38 the <em>new</em> file name equal to the <em>old</em> file
39 name (e.g., <b>g.rename raster=soils,soils</b>),
40 <em>g.rename</em> will not execute the rename, but instead
41 state that no rename is needed. However, <em>g.rename</em>
42
43 will allow the user to overwrite other existing files in
44 the current mapset by making the <em>new</em> file name
45 that of an already existing file.
46 <p>For portability reasons, <em>g.rename</em> is ignoring case of
47 names. To change the case of a map name, first rename the map
48 to a name which differs by more than case, then rename it to
49 the intended name.
50
51 <h2>EXAMPLE</h2>
52
53 <div class="code"><pre>
54 # rename raster map
55 g.rename raster=oldrast,newrast
56
57 # rename vector map
58 g.rename vector=oldvect,newvect
59
60 # combined renaming
61 g.rename raster=oldrast,newrast vector=oldvect,newvect
62 </pre></div>
63
64 <h2>SEE ALSO</h2>
65
66 <em>
67 <a href="g.copy.html">g.copy</a>,
68 <a href="g.list.html">g.list</a>,
69 <a href="g.remove.html">g.remove</a>
70 </em>
71
72 <h2>AUTHOR</h2>
73
74 Michael Shapiro,
75 U.S.Army Construction Engineering
76 Research Laboratory