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

  <info>
    <desc>Advanced options for Jabber and Google Talk accounts.</desc>
    <revision pkgversion="2.28" version="0.1" date="2009-08-27" status="review">
      <!--
      <e:review by="shaunm@gnome.org" date="2009-08-31" status="done"/>
      -->
    </revision>
    <credit type="author">
      <name>Shaun McCance</name>
      <email>shaunm@gnome.org</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
<!--
    <copyright>
      <year>2009</year>
      <name>GNOME Documentation Project</name>
    </copyright>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
-->
  </info>

  <title>Jabber account details</title>

  <p>Most Jabber accounts will require only a login ID and a password
  to connect.  For some accounts or on certain types of networks, you
  may need to enter additional information in the <gui>Advanced</gui>
  section.  Normally, you will not need to use the advanced options
  below.  For general instructions on adding an account, see
  <link xref="add-account"/>.</p>

  <note>
    <p>Google Talk is a type of Jabber account.  These instructions
    hold for Google Talk accounts as well.</p>
  </note>

  <terms>
    <item>
      <title><gui>Encryption required (TLS/SSL)</gui></title>
      <title><gui>Ignore SSL certificate errors</gui></title>
      <p>Whenever possible, communication between <app>Empathy</app> and
      the Jabber server is encrypted.  If encrypted communication is not
      possible, messages may be sent unencrypted.  Select <gui>Encryption
      required</gui> to prevent <app>Empathy</app> from communicating with
      the Jabber server when encryption is not possible.</p>
      <p>Some Jabber servers may encrypt data using invalid certificates,
      or using certificates from unknown authorities.  If you trust the
      server you are connecting to, you can select <gui>Ignore SSL
      certificate errors</gui> to allow encrypted communication with
      invalid certificates.</p>
    </item>
    <item>
      <title><gui>Resource</gui></title>
      <title><gui>Priority</gui></title>
      <p>If you have multiple applications (for instance, on separate computers)
      connected to your account at the same time, you can set a resource to
      uniquely identify each one.  By default, <app>Empathy</app> will use
      <input>Telepathy</input> as the resource.</p>
      <p>You can set the priority to specify which application should receive
      incoming messages from your contacts.  New messages will be sent to the
      application with the highest priority.</p>
    </item>
    <item>
      <title><gui>Override server settings</gui></title>
      <p><app>Empathy</app> will use default settings to connect to the
      Jabber server based on your login ID.  For some Jabber servers, you
      will need to enter custom server settings manually.  These settings
      should be provided for you by your Jabber provider.</p>
    </item>
  </terms>

</page>