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