summaryrefslogtreecommitdiffstats
path: root/gnome-help/C/files-renaming.page
blob: 36b4c272effe941496d1779d192d34dadb9cecae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<page xmlns="http://projectmallard.org/1.0/"
      type="topic" id="files-renaming">

  <info>
    <link type="guide" xref="files"/>
    <desc>Change file or folder name.</desc>
    <revision pkgversion="3.0" version="0.1" date="2011-01-08" status="review"/>
    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list@gnome.org</email>
    </credit>

  </info>

  <title>Rename a file or folder</title>
  <section id="file-manager">
    <title>Using the the <app>File Manager</app></title>
      <steps>
       <item><p>Right-click on the file or folder icon. A menu will pop-up.</p></item>
       <item><p>Left-click on the <gui>Rename</gui> option in the menu.  The name of the file or folder will become highlighted.</p></item>
       <item><p>Type the new name of the file or folder.</p></item>
       <item><p>Press <key>Enter</key>.</p></item>
      </steps>
      <note>
        <p>
          In the case of files, only the name of the file is highlighted, not the file extention.  This is because in general, you will not need to change the extention of a file.
        </p>
        <p>However, in the event that it is necessary to change the extention of a file, you can follow the same steps, and when the name of the file is highlighted, hightlight the file extention with your mouse. Now, type the new file extention and press <key>Enter</key>.
        </p>
      </note>
  </section>

  <section id="shortcuts">
    <title>Shortcuts</title>
      <steps>
        <item><p>Left-click on the file or folder icon. This selects the file.</p></item>
        <item><p>Press the <key>F2</key> key. This selects the file or folder name.</p></item>
        <item><p>Type the new name of the file or folder.</p></item>
        <item><p>Press <key>Enter</key>.</p></item>
      </steps>
  </section>

  <section id="valid-chars">
    <title>Valid characters for file names</title>
    <p>
      On your system, the <key>/</key> (slash character) is invalid for names of files and folders.
      All other characters can be used.
    </p>

    <note style="warning">
    <p>
      If you name a file with a <key> . </key> as the first character, the file will be hidden.  Generally, avoid the  <key> . </key> as the first character in a file name.
    </p>
     <p>
       Some characters in file and folder names may not be valid in Windows and Mac OSX.  Therefore, if you think a file
       may need to be read on these systems (like in the event you e-mail it to someone using Windows or Mac), the following characters may cause problems and should be avoided in naming files and folders:
       <key> | </key>, <key> \ </key>, <key> ? </key>, <key> * </key>, <key> &lt; </key>, <key> " </key>, <key> : </key>, <key> &gt; </key>, <key> / </key>.
     </p>
     </note>

  </section>

  <section id="common-probs">
    <title>Common problems</title>
      <section id="no-rename">
       <title>The item could not be renamed</title>
       <section id="name-in-use"><title>The name is already used</title>
      <p>
        You can't have two files with the same name in the same folder.  Also, you can not have a subfolder with the same name as a file in the same folder. Therefore, if you try to rename a file to a name that already exists in the folder you are working in, the <app>File Manager</app> will not allow it.  Use a different name.
      </p>
        <note>
          <p>
            File and folder names are case sensitive.
          </p>
        <p>
          Example:
          File.txt and file.txt are different names.  This is allowed.
        </p>
       </note>
       </section>
       <section id="too-long">
         <title>File name too long</title>
         <p>
           File names can have no more than 255 characters in their names.  Use a shorter name.
         </p>
       </section>
      </section>


      <section id="grayed">
       <title>The option to rename is grayed out</title>
        <p>
         You do not have permission to rename the file.  Generally, if you do not have
         the correct permissions to rename a file, you should not be renaming the file.
        </p>
      </section>
  </section>

  <section id="command-line">
    <title>Using the command line</title>
     <steps>
       <item>
       <p>
        <cmd>cd</cmd> into the folder where the file or subfolder you wish to rename is located.
       </p>
       </item>
       
       <item>
       <p>
        At the shell prompt type: <cmd>mv -i current_filename new_filename</cmd>
       </p>
         <note style="important">
           <p>
             If you omit the <cmd> -i</cmd>, you may overwrite a file if you try to rename the file to a name that already exists in the folder.  The -i option will ask you if you are sure that you want to overwrite the existing file.  If you overwrite an existing file, there is no way you can get the original back, so be sure to use the<cmd> -i </cmd> option.
          </p>
         </note>
       </item>
     </steps>
  </section>

  <comment>
   <cite date="2010-06-29" href="mailto:gnome-doc-list@gnome.org">GNOME Documentation Project</cite>
   <p>Explain basic procedure of renaming file</p>
   <p>Mention shortcut keys and faster ways of doing it</p>
   <p>New section: Mention valid characters, which is basically everything except /, though there are more restrictions if the file is on e.g. a fat32 filesystem.</p>
   <p>Common problems when renaming files (i.e. error messages, how to solve problems). Probably a new section for each problem.</p>
  </comment>

</page>