116d7d1bdf9739080de89bd4b4f252b5d50cd193
[empathy.git] / help / C / account-jabber.page
1 <page xmlns="http://projectmallard.org/1.0/"
2       xmlns:e="http://projectmallard.org/experimental/"
3       type="topic" style="screen"
4       id="account-jabber">
5
6   <info>
7     <desc>Advanced options for Jabber and Google Talk accounts.</desc>
8     <revision pkgversion="2.28" version="0.1" date="2009-08-27" status="review">
9       <!--
10       <e:review by="shaunm@gnome.org" date="2009-08-31" status="done"/>
11       -->
12     </revision>
13     <credit type="author">
14       <name>Shaun McCance</name>
15       <email>shaunm@gnome.org</email>
16     </credit>
17     <license>
18       <p>Creative Commons Share Alike 3.0</p>
19     </license>
20 <!--
21     <copyright>
22       <year>2009</year>
23       <name>GNOME Documentation Project</name>
24     </copyright>
25     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
26 -->
27   </info>
28
29   <title>Jabber account details</title>
30
31   <p>Most Jabber accounts will require only a login ID and a password
32   to connect.  For some accounts or on certain types of networks, you
33   may need to enter additional information in the <gui>Advanced</gui>
34   section.  Normally, you will not need to use the advanced options
35   below.  For general instructions on adding an account, see
36   <link xref="add-account"/>.</p>
37
38   <note>
39     <p>Google Talk is a type of Jabber account.  These instructions
40     hold for Google Talk accounts as well.</p>
41   </note>
42
43   <terms>
44     <item>
45       <title><gui>Encryption required (TLS/SSL)</gui></title>
46       <title><gui>Ignore SSL certificate errors</gui></title>
47       <p>Whenever possible, communication between <app>Empathy</app> and
48       the Jabber server is encrypted.  If encrypted communication is not
49       possible, messages may be sent unencrypted.  Select <gui>Encryption
50       required</gui> to prevent <app>Empathy</app> from communicating with
51       the Jabber server when encryption is not possible.</p>
52       <p>Some Jabber servers may encrypt data using invalid certificates,
53       or using certificates from unknown authorities.  If you trust the
54       server you are connecting to, you can select <gui>Ignore SSL
55       certificate errors</gui> to allow encrypted communication with
56       invalid certificates.</p>
57     </item>
58     <item>
59       <title><gui>Resource</gui></title>
60       <title><gui>Priority</gui></title>
61       <p>If you have multiple applications (for instance, on separate computers)
62       connected to your account at the same time, you can set a resource to
63       uniquely identify each one.  By default, <app>Empathy</app> will use
64       <input>Telepathy</input> as the resource.</p>
65       <p>You can set the priority to specify which application should receive
66       incoming messages from your contacts.  New messages will be sent to the
67       application with the highest priority.</p>
68     </item>
69     <item>
70       <title><gui>Override server settings</gui></title>
71       <p><app>Empathy</app> will use default settings to connect to the
72       Jabber server based on your login ID.  For some Jabber servers, you
73       will need to enter custom server settings manually.  These settings
74       should be provided for you by your Jabber provider.</p>
75     </item>
76   </terms>
77
78 </page>