<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="files-rename">

  <info>
    <link type="guide" xref="files"/>
    <desc>Change file or folder name.</desc>

    <revision pkgversion="3.5.92" version="0.2" date="2012-09-19" status="review"/>
    <revision version="13.10" date="2013-09-07" status="review"/>

    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list@gnome.org</email>
    </credit>
    <credit type="author">
      <name>Shaun McCance</name>
      <email>shaunm@gnome.org</email>
    </credit>
    <credit type="author">
      <name>Jim Campbell</name>
      <email>jwcampbell@gmail.com</email>
    </credit>
    <credit type="editor">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
    </credit>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

  <title>Rename a file or folder</title>

  <p>You can use the file manager to change 
  the name of a file or folder.</p>
  <steps>
    <title>To rename a file or folder:</title>
    <item><p>Right-click on the item and select <gui>Rename</gui>, or select
    the file and press <key>F2</key>.</p></item>
    <item><p>Type the new name and press <key>Enter</key>.</p></item>
  </steps>

  <p>You can also rename a file from the
  <link xref="nautilus-file-properties-basic">properties</link> window.</p>

  <p>When you rename a file, only the first part of the name of the file is
  selected, not the file extension (the part after the "."). The extension
  normally denotes what type of file it is (e.g. <file>file.pdf</file> is a PDF
  document), and you usually do not want to change that. If you need to change
  the extension as well, select the entire file name and change it.</p>

  <note style="tip">
    <p>If you renamed the wrong file, or named your file improperly, you can
    undo the rename. To revert the action, immediately click the gear button in
    the toolbar and select <gui>Undo</gui> to restore the former name.</p>
  </note>

  <section id="valid-chars">
    <title>Valid characters for file names</title>
    <p>You can use any character except the <key>/</key> (slash) character in
    file names. Some devices, however, use a <em>file system</em> that has more
    restrictions on file names. Therefore, it is a best practice to avoid the
    following characters in your file names: <key>|</key>, <key>\</key>,
    <key>?</key>, <key>*</key>, <key>&lt;</key>, <key>"</key>, <key>:</key>,
    <key>&gt;</key>, <key>/</key>.</p>

    <note style="warning">
    <p> If you name a file with a <key>.</key> as the first character, the file
    will be <link xref="files-hidden">hidden</link> when you attempt to view
    it in the file manager.</p>
    </note>
  </section>

  <section id="common-probs">
    <title>Common problems</title>
    <terms>
      <item>
        <title>The file name is already in use</title>
        <p>You can't have two files or folders with the same name in the same
        folder. If you try to rename a file to a name that already exists in
        the folder you are working in, the file manager will not allow it.</p>
        <p>File and folder names are case sensitive, so the file name
        <file>File.txt</file> is not the same as <file>FILE.txt</file>.
        Using different file names like this is allowed, though it is not
        recommended.</p>
      </item>
      <item>
        <title>The file name is too long</title>
        <p>On some file systems, file names can have no more than 255
        characters in their names.  This 255 character limit includes both the
        file name and the path to the file (e.g., <file>/home/wanda/Documents/work/business-proposals/…
        </file>), so you should avoid long file and folder names where
        possible.</p>
      </item>
      <item>
        <title>The option to rename is grayed out</title>
        <p>If <gui>Rename</gui> is grayed out, you do not have permission to
        rename the file. You should use caution with renaming such files, as
        renaming some protected files may cause your system to become unstable.
        See <link xref="nautilus-file-properties-permissions"/> for more
        information.</p>
      </item>
    </terms>
  </section>
</page>
