Added stub topic for password protected IRC channels Wrote the audio call topic Some...
[empathy.git] / help / C / empathy.xml
1 <?xml version="1.0"?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY legal SYSTEM "legal.xml">
5 <!ENTITY appversion "2.28">
6 <!ENTITY manrevision "2.2">
7 <!ENTITY date "May 2009">
8 <!ENTITY app "<application>Empathy</application>">
9 <!ENTITY appname "Empathy">
10 <!ENTITY gtalk "http://www.google.com/talk/">
11 <!ENTITY icq "https://www.icq.com/register/">
12 <!ENTITY aim "http://dashboard.aim.com/aim">
13 <!ENTITY msn "https://accountservices.passport.net">
14 <!ENTITY yahoo "https://login.yahoo.com/config/login">
15 <!ENTITY fwd
16 "http://account2.freeworlddialup.com/index.php?section_id=94">
17 <!ENTITY ekiga "https://www.ekiga.net/index.php?page=register">
18 <!ENTITY sipphone
19 "https://signup.sipphone.com/new-users/app?class=NewUser;proc=start">
20 <!ENTITY jabber "http://www.jabber.org/web/Jabber.org">
21 ]>
22 <?db.chunk.max_depth 2?>
23 <article id="index" lang="en">
24   <!-- please do not change the id; for translations, change lang to -->
25   <!-- appropriate code -->
26   <articleinfo>
27     <title>&app; Manual V&manrevision;</title>
28
29     <copyright>
30       <year>2008, 2009</year>
31       <holder>Ubuntu Documentation Project</holder>
32     </copyright>
33     <copyright>
34       <year>2009</year>
35       <holder>GNOME Documentation Project</holder>
36     </copyright>
37
38     <!-- An address can be added to the publisher information.  If a role is 
39     not specified, the publisher/author is the same for all versions of the 
40     document.  -->
41     <publisher>
42       <publishername>GNOME Documentation Project</publishername>
43     </publisher>
44
45     <!-- licence stuff -->
46     &legal;
47     
48     <authorgroup>
49       <author role="maintainer">
50         <firstname>Milo</firstname>
51         <surname>Casagrande</surname>
52         <affiliation>
53           <orgname>GNOME Documentation Project</orgname>
54           <address><email>milo@ubuntu.com</email></address>
55         </affiliation>
56         <affiliation>
57           <orgname>Ubuntu Documentation Project</orgname>
58           <address><email>milo@ubuntu.com</email></address>
59         </affiliation>
60       </author>
61       <author>
62         <firstname>Seth</firstname>
63         <surname>Dudenhofer</surname>
64         <affiliation>
65           <orgname>Ubuntu Documentation Project</orgname>
66           <address><email>sdudenhofer@gmail.com</email></address>
67         </affiliation>
68       </author>
69     </authorgroup>
70
71     <releaseinfo revision="2.28" role="incomplete">
72       <ulink type="bug" url="http://bugzilla.gnome.org/show_bug.cgi?id=561033" />
73       <ulink type="planning" url="http://live.gnome.org/Empathy/Documentation" />
74     </releaseinfo>
75
76 <!-- According to GNU FDL, revision history is mandatory if you are -->
77 <!-- modifying/reusing someone else's document.  If not, you can omit it. -->
78 <!-- Remember to remove the &manrevision; entity from the revision -->
79 <!-- entries other than the current revision. -->
80 <!-- The revision numbering system for GNOME manuals is as follows: -->
81 <!-- * the revision number consists of two components -->
82 <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
83 <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
84 <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
85 <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
86 <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
87 <!-- to V3.0, and so on. -->
88     <revhistory>
89       <revision>
90         <revnumber>Empathy Manual V&manrevision;</revnumber>
91         <date>&date;</date>
92         <revdescription>
93           <para role="author">Milo Casagrande
94             <email>milo@ubuntu.com</email>
95           </para>
96           <para role="publisher">GNOME Documentation Project</para>
97         </revdescription>
98       </revision>
99
100       <revision>
101         <revnumber>Empathy Manual V2.1</revnumber>
102         <date>January 2009</date>
103         <revdescription>
104           <para role="author">Milo Casagrande
105             <email>milo@ubuntu.com</email>
106           </para>
107           <para role="publisher">Ubuntu Documentation Project</para>
108         </revdescription>
109       </revision>
110
111       <revision> 
112         <revnumber>Empathy Manual V2.0</revnumber>
113         <date>April 2008</date>
114         <revdescription>
115           <para role="author">Milo Casagrande
116             <email>milo@ubuntu.com</email>
117           </para>
118           <para role="author">Seth Dudenhofer
119             <email>sdudenhofer@gmail.com</email>
120           </para>
121           <para role="publisher">Ubuntu Documentation Project</para>
122         </revdescription>
123       </revision>
124     </revhistory> 
125     
126     <releaseinfo>
127       This manual describes version &appversion; of &appname;.
128     </releaseinfo> 
129     <legalnotice> 
130       <title>Feedback</title> 
131       <para>
132         To report a bug or make a suggestion regarding the &app; application or
133         this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback" type="help">GNOME Feedback Page</ulink>. 
134       </para>
135     </legalnotice>
136
137     <abstract role="description">
138       <para>
139         &appname; is an application for instant messaging.
140       </para>
141     </abstract>
142
143   </articleinfo>
144
145   <indexterm zone="index"> 
146     <primary>Empathy</primary>
147   </indexterm>
148   <indexterm zone="index">
149     <primary>empathy</primary>
150     <secondary>istant messaging</secondary>
151   </indexterm>
152
153   <sect1 id="empathy-intro">
154     <title>Introduction</title>
155     <para>
156       &app; is a multi-protocol instant messaging program for the
157       GNOME Desktop. With &app; you can keep in touch with all of your
158       friends through lots of supported instant messaging services.
159     </para>
160     <para>
161       &app; supports the following services:
162       <itemizedlist>
163         <listitem>
164           <para>
165             <acronym>AIM</acronym>
166           </para>
167         </listitem>
168         <listitem>
169           <para>
170             Google Talk
171           </para>
172         </listitem>
173         <listitem>
174           <para>
175             ICQ
176           </para>
177         </listitem>
178         <listitem>
179           <para>
180             <acronym>IRC</acronym>
181           </para>
182         </listitem>
183         <listitem>
184           <para>
185             Jabber (or <acronym>XMPP</acronym>)
186           </para>
187         </listitem>
188         <listitem>
189           <para>
190             <acronym>MSN</acronym>
191           </para>
192         </listitem>
193         <listitem>
194           <para>
195             Salut
196           </para>
197         </listitem>
198         <listitem>
199           <para>
200             <acronym>SIP</acronym>
201           </para>
202         </listitem>
203         <listitem>
204           <para>
205             Yahoo
206           </para>
207         </listitem>
208         <listitem>
209           <para>
210             And many others...
211           </para>
212         </listitem>
213       </itemizedlist>
214     </para>
215   </sect1>
216
217   <sect1 id="empathy-getting-started">
218     <title>Getting Started</title>
219
220     <sect2 id="empathy-starting">
221       <title>Starting &appname;</title>
222       <para>You can start &app; in the following ways:
223       </para> 
224       <variablelist>
225         <varlistentry>
226           <term><guimenu>Applications</guimenu> menu</term>
227           <listitem>
228             <para>Choose 
229               <menuchoice>
230                 <guisubmenu>Internet</guisubmenu>
231                 <guimenuitem>Empathy IM Client</guimenuitem>
232               </menuchoice>.
233             </para>
234           </listitem>
235         </varlistentry>
236         <varlistentry>
237           <term>Command line</term>
238           <listitem>
239             <para>Type <command>empathy</command> and then press
240               <keycap>Enter</keycap>.
241             </para>
242           </listitem>
243         </varlistentry>
244       </variablelist>
245     </sect2>
246
247     <sect2 id="emphaty-when-start">
248       <title>When You Start &appname;</title>
249       <para>
250         When you start &app; the following window is shown.
251         <!-- Figure 1 -->
252         <figure id="empathy-FIG-mainwindow"> 
253           <title>&app; Main Window</title> 
254           <screenshot> 
255             <mediaobject> 
256               <imageobject>
257                 <imagedata fileref="figures/empathy-main-window.png" format="PNG"/> 
258               </imageobject>
259               <textobject> 
260                 <phrase>
261                   Shows &app; main window. Contains the titlebar, the
262                   menubar, contact list, status icon and status arrow
263                   button list.
264                 </phrase> 
265               </textobject> 
266             </mediaobject> 
267           </screenshot> 
268         </figure>
269         <!-- End of Figure -->
270       </para>
271       <para>
272         <xref linkend="empathy-TBL-1"/> describes the components of
273         &app;'s main window.
274         <table frame="topbot" id="empathy-TBL-1">
275           <title>&app; Main Components</title>
276           <tgroup cols="2" colsep="0" rowsep="0">
277             <colspec colname="colspec0" colwidth="29.39*"/>
278             <colspec colname="colspec1" colwidth="70.61*"/>
279             <thead>
280               <row rowsep="1">
281                 <entry valign="top">
282                   <para>Component</para>
283                 </entry>
284                 <entry valign="top">
285                   <para>Description</para>
286                 </entry>
287               </row>
288             </thead>
289             <tbody>
290               <row>
291                 <entry valign="top">
292                   <para>Menubar</para>
293                 </entry>
294                 <entry valign="top">
295                   <para>
296                     Contains menus used to perform actions in &app;.
297                   </para>
298                 </entry>
299               </row>
300               <row>
301                 <entry valign="top">
302                   <para>Status Drop-Down List</para>
303                 </entry>
304                 <entry valign="top">
305                   <para>
306                     Allows to update the status.
307                   </para>
308                 </entry>
309               </row>
310               <row>
311                 <entry valign="top">
312                   <para>Account Button</para>
313                 </entry>
314                 <entry valign="top">
315                   <para>
316                     Opens the <guilabel>Accounts</guilabel> dialog.
317                   </para>
318                 </entry>
319               </row>
320               <row>
321                 <entry valign="top">
322                   <para>Contact List</para>
323                 </entry>
324                 <entry valign="top">
325                   <para>
326                     Shows all the available contacts and their
327                     associated status.
328                   </para>
329                 </entry>
330               </row>
331             </tbody>
332           </tgroup>
333         </table>
334       </para>
335     </sect2>
336   </sect1>
337
338   <sect1 id="empathy-accounts">
339     <title>Accounts</title>
340     <para>
341       To use &app; you need at least one account of the supported services.
342     </para>
343     <para>
344       If you don't already have an account and you don't have your <emphasis>user
345         name</emphasis> and <emphasis>password</emphasis>, you need to
346         register a new account (see <xref linkend="empathy-register-account" />).
347     </para>
348     <para>
349       In order to talk with other users, also called
350       <emphasis>contacts</emphasis>, you need to use the same service
351       they are using. If, for example, one contact is using the <emphasis
352       role="strong">Jabber</emphasis> service, you need to have an
353       account registered with that service.
354     </para>
355     <para>
356       &app; can handle as many accounts on any supported services as you want and
357       you can have them all open at the same time.
358     </para>
359
360     <sect2 id="empathy-register-account">
361       <title>Registering an Account</title>
362       <para>
363         You can freely register an account on any of the following
364         services. Follow the instructions reported on each website on
365         how to register your new account. At the end of the
366         registration process you should have a <emphasis>user
367           name</emphasis> (or an <emphasis>account ID</emphasis>) and
368         a <emphasis>password</emphasis> that you will use to
369         create the account in &app;.
370       </para>
371       <para>
372         Click on the name of the service to visit its website:
373         <!-- Need to do like that, if using only
374         <ulink>SERVICE</ulink> it wouldn't be possibile to
375         localize the links -->
376         <itemizedlist>
377           <listitem>
378             <!-- Translators: try to find a localized version of the
379             registration service website -->
380             <para>
381               The <ulink type="http" url="&aim;">AIM</ulink> service.
382             </para>
383           </listitem>
384           <listitem>
385             <!-- Translators: try to find a localized version of the
386             registration service website -->
387             <para>
388               The <ulink type="http" url="&gtalk;">Google
389               Talk</ulink> service.
390             </para>
391           </listitem>
392           <listitem>
393             <!-- Translators: try to find a localized version of the
394             registration service website -->
395            <para>
396               The <ulink type="http" url="&icq;">ICQ</ulink> service.
397             </para>
398           </listitem>
399           <listitem>
400             <!-- Translators: try to find a localized version of the
401             registration service website -->
402             <para>
403               The <ulink type="http" url="&msn;">MSN</ulink> service.
404             </para>
405           </listitem>
406           <listitem>
407             <!-- Translators: try to find a localized version of the
408             registration service website -->
409             <para>
410               The <ulink type="http" url="&yahoo;">Yahoo</ulink> service.
411             </para>
412           </listitem>
413         </itemizedlist>
414       </para>
415       <para>
416         For registering a <acronym>SIP</acronym> account, you can use one of the
417         following service:
418       </para>
419       <para>
420         <itemizedlist>
421           <listitem>
422             <!-- Translators: try to find a localized version of the
423             registration service website -->
424             <para>
425               The <ulink type="http" url="&ekiga;">Ekiga</ulink> service.
426             </para>
427           </listitem>
428           <listitem>
429             <!-- Translators: try to find a localized version of the
430             registration service website -->
431             <para>
432               The <ulink type="http" url="&fwd;"><acronym>FWD</acronym></ulink> (Free
433               World Dialup) service.
434             </para>
435           </listitem>
436           <listitem>
437             <!-- Translators: try to find a localized version of the
438             registration service website -->
439             <para>
440               The <ulink type="http" url="&sipphone;">Sipphone</ulink> service.
441             </para>
442           </listitem>
443         </itemizedlist>
444       </para>
445       <para>
446         For registering a <emphasis role="strong">Jabber</emphasis>
447         account, you can use the automatic
448         account creation of &app;. Not all Jabber service
449         providers support the automatic creation of accounts, one
450         service provider known to work with &app; is <ulink
451         type="http" url="&jabber;">jabber.org</ulink>.
452       </para>
453       <para>
454         If you already have a <emphasis
455         role="strong">Jabber</emphasis> account, you can use one of
456         the following services:
457       </para>
458       <para>
459         <itemizedlist>
460           <listitem>
461             <para>
462               Salut
463             </para>
464           </listitem>
465         </itemizedlist>
466       </para>
467     </sect2>
468
469     <sect2 id="empathy-create-account">
470       <title>Adding your Account to &app;</title>
471       <para>
472         To add your account to &app;, proceed as follows:
473         <orderedlist>
474           <listitem>
475             <para>
476               From the <link linkend="empathy-FIG-mainwindow">main window
477               </link> (<guilabel>Contact List</guilabel>)
478               click on the account button or press <keycap>F4</keycap> to open the
479               <guilabel>Accounts</guilabel> dialog.
480             </para>
481           </listitem>
482           <listitem>
483             <para>
484               If it is the first time you launch &app;:
485               <orderedlist>
486                 <listitem>
487                   <para>
488                     From the <guilabel>Type</guilabel> drop-down list choose
489                     the service you wish to add an account for, then click
490                     on the <guibutton>Create</guibutton> button.
491                   </para>
492                 </listitem>
493               </orderedlist>
494             </para>
495             <para>
496               Otherwise:
497               <orderedlist>
498                 <listitem>
499                   <para>
500                     Click on the <guilabel>Add</guilabel> button.
501                   </para>
502                 </listitem>
503                 <listitem>
504                   <para>
505                     From the <guilabel>Type</guilabel> drop-down list choose
506                     the service you wish to add an account for, then click
507                     on the <guibutton>Create</guibutton> button.
508                   </para>
509                 </listitem>
510               </orderedlist>
511             </para>
512           </listitem>
513           <listitem>
514             <para>
515               Fill the required fields with your <emphasis>user
516                 name</emphasis> and
517                 <emphasis>password</emphasis>. Optionally, you can
518                 modify some advanced options. For more information,
519               see <xref linkend="empathy-advanced-options"/>.
520             </para>
521           </listitem>
522           <listitem>
523             <para>
524               To enable the new account, select the
525               <guilabel>Enabled</guilabel> check-box next to
526               the name of the account in the box on the left.
527             </para>
528           </listitem>
529         </orderedlist>
530       </para>
531       
532       <sect3 id="empathy-importing-accounts">
533         <title>Importing Accounts</title>
534         <para>
535           If you use another instant messaging program, you can import
536           the accounts from that program into &app;
537         </para>
538         <para>
539           <note>
540             <para>
541               At the moment &app; can import the accounts only from
542               the instant messaging program
543               <application>Pidgin</application>. For more information
544               about <application>Pidgin</application>, see the <ulink
545               type="http" url="http://www.pidgin.im/">Pidgin website</ulink>.
546             </para>
547           </note>
548         </para>
549         <para>
550           To import the accounts into &app;, proceed as follows:
551           <orderedlist>
552             <listitem>
553               <para>
554                 From the <link linkend="empathy-FIG-mainwindow">main window
555                 </link> (<guilabel>Contact List</guilabel>)
556                 click on the account button or press <keycap>F4</keycap> to open the
557                 <guilabel>Accounts</guilabel> dialog.
558               </para>
559             </listitem>
560             <listitem>
561               <para>
562                 Click on the <guibutton>Import Accounts...</guibutton>
563                 button to open the <guilabel>Import
564                 Accounts</guilabel> dialog.
565               </para>
566             </listitem>
567             <listitem>
568               <para>
569                 Select the accounts you would like to import by
570                 clicking on the <guilabel>Import</guilabel> check-box.
571               </para>
572             </listitem>
573             <listitem>
574               <para>
575                 When you have selected all the desired accounts, click
576                 <guibutton>OK</guibutton> to import them. If you don't
577                 want to import the accounts, click
578                 <guibutton>Cancel</guibutton>.
579               </para>
580             </listitem>
581             <listitem>
582               <para>
583                 When you import a new account into &app;, it will not be
584                 enabled by default.
585               </para>
586               <para>
587                 To enable the new account, select the
588                 <guilabel>Enabled</guilabel> check-box next to
589                 the name of the account in the box on the left.
590               </para>
591             </listitem>
592           </orderedlist>
593         </para>
594       </sect3>
595     </sect2>
596
597     <sect2 id="empathy-edit-account">
598       <title>Editing an Account</title>
599       <para>
600         To edit one of your accounts, i.e. to change the
601         <emphasis>password</emphasis> or your <emphasis>user
602         name</emphasis>, proceed as follows:
603         <orderedlist>
604           <listitem>
605             <para>
606               From the <link linkend="empathy-FIG-mainwindow">main window
607               </link> (<guilabel>Contact List</guilabel>)
608               click on the account button or press <keycap>F4</keycap> to open the
609               <guilabel>Accounts</guilabel> dialog.
610             </para>
611           </listitem>
612           <listitem>
613             <para>
614               Select the account you wish to edit in the box on the
615               left.
616             </para>
617           </listitem>
618           <listitem>
619             <para>
620               Modify the desired data.
621             </para>
622           </listitem>
623         </orderedlist>
624       </para>
625       <para>
626         <note>
627           <para>
628             Based on the type of the account, it is possibile to edit
629             different settings.
630           </para>
631         </note>
632       </para>
633       <para>
634         To modify the identifier of an account, how &app; identifies
635         an account, proceed as follows:
636         <orderedlist>
637           <listitem>
638             <para>
639               From the <link linkend="empathy-FIG-mainwindow">main window
640               </link> (<guilabel>Contact List</guilabel>)
641               click on the account button or press <keycap>F4</keycap> to open the
642               <guilabel>Accounts</guilabel> dialog.
643             </para>
644           </listitem>
645           <listitem>
646             <para>
647               Select the account you wish to edit in the box on the
648               left and double-click on its name.
649             </para>
650           </listitem>
651           <listitem>
652             <para>
653               Change the name of the account as you desire.
654             </para>
655           </listitem>
656         </orderedlist>
657       </para>
658     </sect2>
659
660     <sect2 id="empathy-disabling-removing-account">
661       <title>Disabling and Removing an Account</title>
662       <para>
663         To disable an account, proceed as follows:
664       </para>
665       <para>
666         <orderedlist>
667           <listitem>
668             <para>
669               From the <link linkend="empathy-FIG-mainwindow">main window
670               </link> (<guilabel>Contact List</guilabel>)
671               click on the account button or press <keycap>F4</keycap>
672               to open the
673               <guilabel>Accounts</guilabel> dialog.
674             </para>
675           </listitem>
676           <listitem>
677             <para>
678               Select the account you wish to disable in the box on the
679               left of the dialog and deselect the
680               <guilabel>Enabled</guilabel> check-box.
681             </para>
682           </listitem>
683         </orderedlist>
684       </para>
685       <para>
686         To remove an account, proceed as follows:
687       </para>
688       <para>
689         <orderedlist>
690           <listitem>
691             <para>
692               From the <link linkend="empathy-FIG-mainwindow">main window
693               </link> (<guilabel>Contact List</guilabel>)
694               click on the account button or press <keycap>F4</keycap>
695               to open the
696               <guilabel>Accounts</guilabel> dialog.
697             </para>
698           </listitem>
699           <listitem>
700             <para>
701               Select the account you wish to disable in the box on the
702               left of the dialog.
703             </para>
704           </listitem>
705           <listitem>
706             <para>
707               Click on the <guibutton>Remove</guibutton> button.
708             </para>
709           </listitem>
710           <listitem>
711             <para>
712               A dialog will be shown asking for confirmation. Click on
713               the <guibutton>Remove</guibutton> button to remove the account.
714             </para>
715           </listitem>
716         </orderedlist>
717       </para>
718     </sect2>
719     
720     <sect2 id="empathy-edit-personal-information">
721       <title>Editing Personal Information</title>
722       <para>
723         To change your personal information, your alias and your
724         icon (the image that other contacts will see of you), for each
725         of your accounts, proceed as follows:
726       </para>
727       <para>
728         <orderedlist>
729           <listitem>
730             <para>
731               From the <link linkend="empathy-FIG-mainwindow">main
732                 window</link>, select <menuchoice>
733                 <guimenu>Edit</guimenu>
734                 <guimenuitem>Personal Information</guimenuitem>
735               </menuchoice>.
736             </para>
737           </listitem>
738           <listitem>
739             <para>
740               From the <guilabel>Account</guilabel> drop-down list, choose
741               the account you want to edit.
742             </para>
743           </listitem>
744           <listitem>
745             <para>
746               In the <guilabel>Alias</guilabel> text box, write your new
747               alias.
748             </para>
749           </listitem>
750           <listitem>
751             <para>
752               To change your icon, click on the person-looking button and
753               choose an image file.
754             </para>
755           </listitem>
756           <listitem>
757             <para>
758               When done, click <guibutton>Close</guibutton>.
759             </para>
760           </listitem>
761         </orderedlist>
762       </para>
763       <para>
764         <note>
765           <para>
766             An <emphasis>alias</emphasis> is an alternative way you
767             can identify yourself. You can use your real
768             name or a nickname.
769           </para>
770         </note>
771       </para>
772     </sect2>
773     
774     <sect2 id="empathy-advanced-options">
775       <title>Advanced Options</title> 
776       <para>
777         Based on the service you are using, it is possible to
778         configure more advanced options to modify the normal behavior of
779         &app;.
780       </para>
781       <para>
782         To configure these options, when you are <link
783         linkend="empathy-create-account">adding a new
784         account</link>, click on the drop-down section
785         <guilabel>Advanced</guilabel>.
786       </para>
787
788       <sect3 id="empathy-xmpp-advanced">
789         <title>
790           Jabber (or <acronym>XMPP</acronym>) and Google Talk
791         </title>
792         <para>
793           <variablelist>
794             <varlistentry>
795               <term>
796                 <guilabel>Encryption required (TLS/SSL)</guilabel>
797               </term>
798               <listitem>
799                 <para>
800                   Select this option in order to use some sort of
801                   encryption during your conversations.
802                 </para>
803               </listitem>
804             </varlistentry>
805             <varlistentry>
806               <term>
807                 <guilabel>Ignore SSL certificate errors</guilabel>
808               </term>
809               <listitem>
810                 <para>
811                   Select this option in order to ignore the errors
812                   that can be generated by some types of security
813                   certificates. Usually these certificates are called
814                   auto-signed.
815                 </para>
816                 <para>
817                   <note>
818                     <para>
819                       Select this option only if you are sure the
820                       certificate is secure and you can trust it.
821                     </para>
822                   </note>
823                 </para>
824               </listitem>
825             </varlistentry>
826             <varlistentry>
827               <term>
828                 <guilabel>Resource</guilabel>
829               </term>
830               <listitem>
831                 <para>
832                   Use this text box to set a name with which you can
833                   identify the running program based on where you are
834                   running it. With this option, and the
835                   <guilabel>Priority</guilabel> one, you can
836                   use your account simultaneously in two different
837                   devices. For example, if you set one device to
838                   <replaceable>desktop</replaceable> and the other
839                   one to <replaceable>mobile</replaceable>, you can
840                   connect with both of them and based on the
841                   <guilabel>Priority</guilabel> value you will receive
842                   messages on one of the two devices or both.
843                 </para>
844                 <para>
845                   This can be useful if you have two devices, a main
846                   one and a portable one, and you move away from the
847                   main one bringing with you the other: you can still
848                   receive messages from your account with the portable
849                   device even if you do not disconnet from the main one.
850                 </para>
851                 <para>
852                   <note>
853                     <para>
854                       If you set the same value for this text box on
855                       both the devices, when you connect with one of
856                       them, the other one will be disconnected, even
857                       if you set a different value with the
858                       <guilabel>Priority</guilabel> spin box.
859                     </para>
860                   </note>
861                 </para>
862               </listitem>
863             </varlistentry>
864             <varlistentry>
865               <term>
866                 <guilabel>Priority</guilabel>
867               </term>
868               <listitem>
869                 <para>
870                   Use this spin box to indicate wich device, set in
871                   the <guilabel>Resource</guilabel> text box, will
872                   receive the new messages. The higher the number, the
873                   higher the priority: you will receive the new
874                   messages on the device with the highest number.
875                 </para>
876                 <para>
877                   You can set values in the range from
878                   <literal>-128</literal> to <literal>127</literal>.
879                 </para>
880                 <para>
881                   <note>
882                     <para>
883                       If you set the same value of this spin box in
884                       both the devices, you will receive messages on
885                       both of them.
886                     </para>
887                   </note>
888                 </para>
889               </listitem>
890             </varlistentry>
891           </variablelist>
892         </para>
893         <para>
894           In the <guilabel>Override server settings</guilabel> section
895           you can set options that take precedence over the default settings.
896           <variablelist>
897             <varlistentry>
898               <term>
899                 <guilabel>Server</guilabel>
900               </term>
901               <listitem>
902                 <para>
903                   Use this text box to write the name of the
904                   server you want to use for this service.
905                 </para>
906               </listitem>
907             </varlistentry>
908             <varlistentry>
909               <term>
910                 <guilabel>Port</guilabel>
911               </term>
912               <listitem>
913                 <para>
914                   Use this spin box to set the number of the port of
915                   the server to use.
916                 </para>
917                 <para>
918                   You can set values in the range from
919                   <literal>0</literal> to <literal>65,555</literal>.
920                 </para>
921               </listitem>
922             </varlistentry>
923             <varlistentry>
924               <term>
925                 <guilabel>Use old SSL</guilabel>
926               </term>
927               <listitem>
928                 <para>
929                   Select this option to use the old version of the
930                   secure protocol for encrypting your connection.
931                 </para>
932               </listitem>
933             </varlistentry>
934           </variablelist>
935         </para>
936       </sect3>
937
938       <sect3 id="empathy-yahoo-advanced">
939         <title>Yahoo</title>
940         <para>
941           <variablelist>
942             <varlistentry>
943               <term>
944                 <guilabel>Ignore conference and chatrooms
945                 invitations</guilabel>
946               </term>
947               <listitem>
948                 <para>
949                   Select this option to ignore the invitations that
950                   other people may send you.
951                 </para>
952               </listitem>
953             </varlistentry>
954             <varlistentry>
955               <term>
956                 <guilabel>Room List locale</guilabel>
957               </term>
958               <listitem>
959                 <para>
960                   The value of this text box identifies the language
961                   used to retrieve the room list when connecting to
962                   the Yahoo service.
963                 </para>
964                 <para>
965                   If you need to change this value, use the two letter
966                   code of your language.
967                 </para>
968               </listitem>
969             </varlistentry>
970             <varlistentry>
971               <term>
972                 <guilabel>Charset</guilabel>
973               </term>
974               <listitem>
975                 <para>
976                   The value of this text box identifies the set of the
977                   characters used by &app;.
978                 </para>
979                 <para>
980                   <note>
981                     <para>
982                       It is advise to leave this value to
983                       <literal>UTF-8</literal>. Change it only
984                       if that charset does not cover your language.
985                     </para>
986                   </note>
987                 </para>
988               </listitem>
989             </varlistentry>               
990             <varlistentry>
991               <term>
992                 <guilabel>Server</guilabel>
993               </term>
994               <listitem>
995                 <para>
996                   Use this text box to write the name of the
997                   server you want to use for this service.
998                 </para>
999               </listitem>
1000             </varlistentry>
1001             <varlistentry>
1002               <term>
1003                 <guilabel>Port</guilabel>
1004               </term>
1005               <listitem>
1006                 <para>
1007                   Use this spin box to set the number of the port of
1008                   the server to use.
1009                 </para>
1010                 <para>
1011                   You can set values in the range from
1012                   <literal>0</literal> to <literal>65,555</literal>.
1013                 </para>
1014               </listitem>
1015             </varlistentry>
1016             <varlistentry>
1017               <term>
1018                 <guilabel>Use Yahoo Japan</guilabel>
1019               </term>
1020               <listitem>
1021                 <para>
1022                   Select this option only if you have a Yahoo! Japan
1023                   account. With the Yahoo! Japan service you can only
1024                   use a Yahoo! Japan account: if you have registered
1025                   an account with the English version of the service,
1026                   that account will not work. 
1027                 </para>
1028               </listitem>
1029             </varlistentry>
1030           </variablelist>
1031         </para>
1032       </sect3>
1033
1034       <sect3 id="empathy-msn-advanced">
1035         <title><acronym>AIM</acronym>, GroupWise and <acronym>MSN</acronym></title>
1036         <para>
1037           <variablelist>
1038             <varlistentry>
1039               <term>
1040                 <guilabel>Server</guilabel>
1041               </term>
1042               <listitem>
1043                 <para>
1044                   Use this text box to write the name of the
1045                   server you want to use for this service.
1046                 </para>
1047               </listitem>
1048             </varlistentry>
1049             <varlistentry>
1050               <term>
1051                 <guilabel>Port</guilabel>
1052               </term>
1053               <listitem>
1054                 <para>
1055                   Use this spin box to set the number of the port of
1056                   the server to use.
1057                 </para>
1058                 <para>
1059                   You can set values in the range from
1060                   <literal>0</literal> to <literal>65,555</literal>.
1061                 </para>
1062               </listitem>
1063             </varlistentry>
1064           </variablelist>           
1065         </para>
1066       </sect3>
1067
1068       <sect3 id="empathy-salut-advanced">
1069         <title>Salut</title>
1070         <para>
1071           <variablelist>
1072             <varlistentry>
1073               <term>
1074                 <guilabel>Published Name</guilabel>
1075               </term>
1076               <listitem>
1077                 <para>
1078                   Use this text box to write the name that will be
1079                   visible to the other users of the network. 
1080                 </para>
1081               </listitem>
1082             </varlistentry>
1083             <varlistentry>
1084               <term>
1085                 <guilabel>Email</guilabel>
1086               </term>
1087               <listitem>
1088                 <para>
1089                   Use this text box to write your email.
1090                 </para>
1091               </listitem>
1092             </varlistentry>
1093             <varlistentry>
1094               <term>
1095                 <guilabel>Jabber ID</guilabel>
1096               </term>
1097               <listitem>
1098                 <para>
1099                   Use this text box to write your Jabber ID, if you
1100                   have one.
1101                 </para>
1102               </listitem>
1103             </varlistentry>
1104           </variablelist>
1105         </para>
1106       </sect3>
1107
1108       <sect3 id="empathy-icq-advanced">
1109         <title>ICQ</title>
1110         <para>
1111           <variablelist>
1112             <varlistentry>
1113               <term>
1114                 <guilabel>Charset</guilabel>
1115               </term>
1116               <listitem>
1117                 <para>
1118                   The value of this text box identifies the set of the
1119                   characters used by &app;.
1120                 </para>
1121                 <para>
1122                   <note>
1123                     <para>
1124                       It is advise to leave this value to
1125                       <literal>UTF-8</literal>. Change it only
1126                       if that charset does not cover your language.
1127                     </para>
1128                   </note>
1129                 </para>
1130               </listitem>
1131             </varlistentry>               
1132             <varlistentry>
1133               <term>
1134                 <guilabel>Server</guilabel>
1135               </term>
1136               <listitem>
1137                 <para>
1138                   Use this text box to write the name of the
1139                   server you want to use for this service.
1140                 </para>
1141               </listitem>
1142             </varlistentry>
1143             <varlistentry>
1144               <term>
1145                 <guilabel>Port</guilabel>
1146               </term>
1147               <listitem>
1148                 <para>
1149                   Use this spin box to set the number of the port of
1150                   the server to use.
1151                 </para>
1152                 <para>
1153                   You can set values in the range from
1154                   <literal>0</literal> to <literal>65,555</literal>.
1155                 </para>
1156               </listitem>
1157             </varlistentry>
1158           </variablelist>
1159         </para>
1160       </sect3>
1161
1162       <sect3 id="empathy-gadugadu-advanced">
1163         <title>Gadu Gadu</title>
1164         <para>
1165           <variablelist>
1166             <varlistentry>
1167               <term><guilabel>Nick</guilabel></term>
1168               <listitem>
1169                 <para>
1170                   Use this text box to write an alternative name to
1171                   use with this service.
1172                 </para>
1173               </listitem>
1174             </varlistentry>
1175           </variablelist>
1176         </para>
1177       </sect3>
1178
1179     </sect2>
1180     
1181   </sect1>
1182
1183   <sect1 id="empathy-contacts-groups">
1184     <title>Contacts and Groups</title>
1185     <para>
1186       All the contacts are handled within &app;'s <link
1187       linkend="empathy-FIG-mainwindow">main window</link>.
1188     </para>
1189     <para>
1190       You can add or remove a contact or you can edit the information
1191       of a particular contact. It is also possibile to arrange
1192       contacts in groups. You can have a group for your work contacts,
1193       one for you family contacts, and so on.
1194     </para>
1195      <sect2 id="empathy-add-contact">
1196       <title>Adding and Removing a Contact</title>
1197       <para>
1198         To add a new contact, proceed as follows:
1199       </para>
1200       <para>
1201         <orderedlist>
1202           <listitem>
1203             <para>
1204               From the <link linkend="empathy-FIG-mainwindow">main
1205                 window</link> choose <menuchoice>
1206                 <guimenu>Chat</guimenu>
1207                 <guimenuitem>Add Contact...</guimenuitem>
1208               </menuchoice>. The <guilabel>New Contact</guilabel>
1209                 dialog will be shown.
1210             </para>
1211           </listitem>
1212           <listitem>
1213             <para>
1214               From the <guilabel>Account</guilabel> drop-down list,
1215               choose the service used by the contact you are adding.
1216             </para>
1217           </listitem>
1218           <listitem>
1219             <para>
1220               In the <guilabel>Identifier</guilabel> text box type the
1221               <emphasis>address</emphasis> of the contact in the form
1222               of
1223               <userinput><replaceable>user name</replaceable>@<replaceable>service
1224               domain</replaceable></userinput>.
1225             </para>
1226           </listitem>
1227           <listitem>
1228             <para>
1229               In the <guilabel>Alias</guilabel> text box type the name
1230               you want to give at the the new contact.
1231             </para>
1232           </listitem>
1233           <listitem>
1234             <para>
1235               Click on <guibutton>Add</guibutton> to add the new contact.
1236             </para>
1237           </listitem>
1238         </orderedlist>
1239       </para>
1240       <para>
1241         To remove a contact, proceed as follows:
1242       </para>
1243       <para>
1244         <orderedlist>
1245           <listitem>
1246             <para>
1247               From the <link linkend="empathy-FIG-mainwindow">main
1248               window</link>, select the contact you would like
1249               to remove and right-click on it.
1250             </para>
1251           </listitem>
1252           <listitem>
1253             <para>
1254               From the popup menu, choose <guilabel>Remove</guilabel> to
1255               remove the contact.
1256             </para>
1257           </listitem>
1258         </orderedlist>
1259       </para>
1260       <para>
1261         <note>
1262           <para>
1263             An <emphasis>alias</emphasis> is an alternative way you
1264             can identify that particular contact. You can use the real
1265             name or the nickname of that person.
1266           </para>
1267         </note>
1268       </para>
1269     </sect2>
1270     <sect2 id="empathy-edit-contact">
1271       <title>Editing a Contact</title>
1272       <para>
1273         To edit a contact, proceed as follows:
1274       </para>
1275       <para>
1276         <orderedlist>
1277           <listitem>
1278             <para>
1279               From the <link linkend="empathy-FIG-mainwindow">main
1280                 window</link>, select the contact you would like
1281               to modify and choose <menuchoice>
1282                 <guimenu>Edit</guimenu>
1283                 <guisubmenu>Contact</guisubmenu>
1284                 <guimenuitem>Edit</guimenuitem>
1285               </menuchoice>, or right-click on it
1286               and choose <guilabel>Edit</guilabel>.
1287             </para>
1288           </listitem>
1289         </orderedlist>
1290       </para>
1291       <para>
1292         From the <guilabel>Edit Contact Information</guilabel> dialog,
1293         you can modify the <emphasis>alias</emphasis>
1294         and the <emphasis>group</emphasis> of the contact.
1295       </para>
1296       <para>
1297         <note>
1298           <para>
1299             An <emphasis>alias</emphasis> is an alternative way you
1300             can identify that particular contact. You can use the real
1301             name or the nickname of that person.
1302           </para>
1303         </note>
1304       </para>
1305       <para>
1306         For more information about groups, see <xref
1307           linkend="empathy-add-contact-group"/> and <xref
1308           linkend="empathy-add-group"/>.
1309       </para>
1310     </sect2>
1311     
1312     <sect2 id="empathy-add-contact-group">
1313       <title>Adding a Contact to a Group</title>
1314       <para>
1315         To add a contact to one or more groups, proceed as follows:
1316       </para>
1317       <para>
1318         <orderedlist>
1319           <listitem>
1320             <para>
1321               From the <link linkend="empathy-FIG-mainwindow">main
1322                 window</link>, select the contact you would like
1323               to modify and choose <menuchoice>
1324                 <guimenu>Edit</guimenu>
1325                 <guisubmenu>Contact</guisubmenu>
1326                 <guimenuitem>Edit</guimenuitem>
1327               </menuchoice>, or right-click on it
1328               and choose <guilabel>Edit</guilabel>.
1329             </para>
1330           </listitem>
1331           <listitem>
1332             <para>
1333               From the <guilabel>Groups</guilabel> section, select the
1334               group, or groups, you want to add the contact to.
1335             </para>
1336           </listitem>
1337           <listitem>
1338             <para>
1339               When done, click <guibutton>Close</guibutton>.
1340             </para>
1341           </listitem>
1342         </orderedlist>
1343       </para>
1344     </sect2>
1345
1346     <sect2 id="empathy-add-group">
1347       <title>Adding a New Group</title>
1348       <para>
1349         To add a new group, proceed as follows:
1350       </para>
1351       <para>
1352         <orderedlist>
1353           <listitem>
1354             <para>
1355               From the <link linkend="empathy-FIG-mainwindow">main
1356                 window</link>, select one contact and choose <menuchoice>
1357                 <guimenu>Edit</guimenu>
1358                 <guisubmenu>Contact</guisubmenu>
1359                 <guimenuitem>Edit</guimenuitem>
1360               </menuchoice>, or right-click on it
1361               and choose <guilabel>Edit</guilabel>.
1362             </para>
1363           </listitem>
1364           <listitem>
1365             <para>
1366               In the <guilabel>Groups</guilabel> section, write the
1367               name of the group you want to add and then click on
1368               <guibutton>Add Group</guibutton>.
1369             </para>
1370           </listitem>
1371           <listitem>
1372             <para>
1373               When done, click <guibutton>Close</guibutton>.
1374             </para>
1375           </listitem>
1376         </orderedlist>
1377       </para>   
1378     </sect2>
1379   </sect1>
1380
1381 <!--
1382   <sect1 id="empathy-send-receive-message">
1383     <title>Sending and Receiving Messages</title>
1384     <para>
1385     </para>
1386   </sect1>
1387
1388   <sect1 id="empathy-preferences">
1389     <title>Preferences</title>
1390     <para>
1391     </para>
1392   </sect1>
1393 -->
1394   
1395 </article>