<page xmlns="http://projectmallard.org/1.0/"
      xmlns:e="http://projectmallard.org/experimental/"
      type="topic" style="task"
      id="add-account">

  <info>
    <link type="guide" xref="index#accounts"/>
    <link type="seealso" xref="remove-account"/>
    <desc>Add a new account to <app>Empathy</app>.</desc>
    <revision pkgversion="2.28" version="0.1" date="2009-06-24" status="draft"/>
    <revision pkgversion="2.28" version="0.1" date="2009-08-10" status="review"/>
    <revision pkgversion="2.28" version="0.2" date="2009-08-27" status="review">
      <!--
      <e:review by="shaunm@gnome.org" date="2009-08-31" status="done"/>
      -->
    </revision>
    <credit type="author">
      <name>Milo Casagrande</name>
      <email>milo@ubuntu.com</email>
    </credit>
    <credit type="author">
      <name>Shaun McCance</name>
      <email>shaunm@gnome.org</email>
    </credit>
<!--
    <copyright>
      <year>2009</year>
      <name>GNOME Documentation Project</name>
    </copyright>
-->
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

  <title>Add a new account</title>

  <p>You can add instant messaging accounts from any supported service to communicate
  with all of your contacts in <app>Empathy</app>.  For some account providers,
  these steps will also allow you to register for a new account.  For more details,
  see <link xref="create-account"/>.</p>

  <steps>
    <item>
      <p>From the <gui>Contact List</gui> window, choose <guiseq><gui>Edit</gui>
      <gui>Accounts</gui></guiseq>, or press <key>F4</key>.</p>
    </item>
    <item>
      <p>Click the <gui style="button">Add</gui> button.</p>
    </item>
    <item>
      <p>From the <gui>Add new</gui> drop-down list, select the type of account you wish
      to add.</p>
    </item>
    <item>
      <p>If you do not already have a registered account, select <gui>Create a new account</gui>.
      This feature is not available for all account types, and may not work with some account
      providers.  See <link xref="create-account"/> for more information.</p>
    </item>
    <item>
      <p>Click <gui>Create</gui>.</p>
    </item>
    <item>
      <p>Enter the required information.  For most accounts, you will only need
      a login ID and a password.  Some accounts may require additional information.
      See <link xref="accounts-window#details"/> for more information.</p>
    </item>
    <item>
      <p>Click <gui style="button">Connect</gui> to enable the new account.</p>

      <!-- TODO: check if it's a bug or what. In case, this part needs to
      be removed or we must signal it as a bug! -->

      <note style="warning">
        <p>If you close the <gui>Accounts</gui> window without clicking
        <gui>Connect</gui>, the entire account will be lost, and you will
        need to create it again.</p>
        <p>If you select another account without clicking <gui>Connect</gui>,
        any information you have entered will be lost.</p>
      </note>
    </item>
  </steps>

  <note style="tip">
    <p>To change the name the identifies the account in the <gui>Accounts</gui>
    window, select the account from the list on the left and either click on the
    name or press the space bar.  Edit the account name and press <key>Enter</key>
    when you’re finished.</p>
  </note>

</page>
