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