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>