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

  <info>
    <link type="guide" xref="prefs-language"/>
    <desc>Switch to a different language for user interface and help text.</desc>

    <revision pkgversion="3.8.0" version="0.3" date="2013-03-13" status="candidate"/>

    <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>Andre Klapper</name>
      <email>ak-47@gmx.net</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>Change which language you use</title>

  <comment>
    <cite date="2012-02-19">shaunm</cite>
    <p>Explain how to install support for other languages. Requires us
    to document software installation.</p>
  </comment>

  <p>You can use your desktop and applications in any of dozens of languages, provided
  you have the proper language packs installed on your computer.</p>

  <steps>
    <item><p>Click your name on the top bar and select <gui>Settings</gui>.</p></item>
    <item><p>Open <gui>Region &amp; Language</gui> and select the
    <gui>Language</gui> tab.</p></item>
    <item><p>Select your desired language.
    The initial list only shows a small subset of the supported languages.
    If your language is not listed, click
    <media type="image" mime="image/svg" src="figures/view-more-symbolic.svg"/>.
    Some translations may be incomplete, and certain applications may not
    support your language at all. Any untranslated text will appear in the
    language in which the software was originally developed, usually American
    English.</p></item>
    <item><p>Respond to the prompt, <gui>Your session needs to be restarted for
    these changes to take effect</gui> by clicking
    <gui style="button">Restart Now</gui>, or click <gui style="button">X</gui>
    to restart later.</p></item>
  </steps>

  <p>There are some special folders in your home folder where applications
  can store things like music, pictures, and documents. These folders use
  standard names according to your language. When you log back in, you will
  be asked if you want to rename these folders to the standard names for
  your selected language. If you plan to use the new language all the time,
  you should update the folder names.</p>

  <section id="system">
    <title>Change the system language</title>

    <p>When you change your language, you only change it for your account
    after you log in. You can also change the <em>system language</em>, the
    language used in places like the login screen.</p>

    <steps>
      <item><p>Click your name on the top bar and select <gui>Settings</gui>.</p></item>
      <item><p>Open <gui>Region &amp; Language</gui> and select the
      <gui>Language</gui> tab.</p></item>
      <item><p>Select the <gui style="button">Login Screen</gui> button.</p></item>
      <item><p><link xref="user-admin-explain">Administrative privileges</link> are
      required. Enter your password, or the password for the requested administrator
      account.</p></item>
      <item><p>Select your desired language.
      The initial list only shows a small subset of the supported languages.
      If your language is not listed, click
      <media type="image" mime="image/svg" src="figures/view-more-symbolic.svg"/>.
      Some translations may be incomplete, and certain applications may not
      support your language at all. Any untranslated text will appear in the
      language in which the software was originally developed, usually American
      English.</p></item>
    </steps>
  </section>

</page>
