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