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     </sect2>
 513
 514     <sect2 id="empathy-edit-account">
 515       <title>Editing an Account</title>
 516       <para>
 517         To edit one of your accounts, i.e. to change the
 518         <emphasis>password</emphasis> or your <emphasis>user
 519         name</emphasis>, proceed as follows:
 520         <orderedlist>
 521           <listitem>
 522             <para>
 523               From the <link linkend="empathy-FIG-mainwindow">main window
 524               </link> (<guilabel>Contact List</guilabel>)
 525               click on the account button or press <keycap>F4</keycap> to open the
 526               <guilabel>Accounts</guilabel> dialog.
 527             </para>
 528           </listitem>
 529           <listitem>
 530             <para>
 531               Select the account you wish to edit in the box on the
 532               left.
 533             </para>
 534           </listitem>
 535           <listitem>
 536             <para>
 537               Modify the desired data.
 538             </para>
 539           </listitem>
 540         </orderedlist>
 541       </para>
 542       <para>
 543         <note>
 544           <para>
 545             Based on the type of the account, it is possibile to edit
 546             different settings.
 547           </para>
 548         </note>
 549       </para>
 550       <para>
 551         To modify the identifier of an account, how &app; identifies
 552         an account, proceed as follows:
 553         <orderedlist>
 554           <listitem>
 555             <para>
 556               From the <link linkend="empathy-FIG-mainwindow">main window
 557               </link> (<guilabel>Contact List</guilabel>)
 558               click on the account button or press <keycap>F4</keycap> to open the
 559               <guilabel>Accounts</guilabel> dialog.
 560             </para>
 561           </listitem>
 562           <listitem>
 563             <para>
 564               Select the account you wish to edit in the box on the
 565               left and double-click on it's name.
 566             </para>
 567           </listitem>
 568           <listitem>
 569             <para>
 570               Change the name of the account as you desire.
 571             </para>
 572           </listitem>
 573         </orderedlist>
 574       </para>
 575     </sect2>
 576
 577     <sect2 id="empathy-disabling-removing-account">
 578       <title>Disabling and Removing an Account</title>
 579       <para>
 580         To disable an account, proceed as follows:
 581       </para>
 582       <para>
 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>
 589               to open the
 590               <guilabel>Accounts</guilabel> dialog.
 591             </para>
 592           </listitem>
 593           <listitem>
 594             <para>
 595               Select the account you wish to disable in the box on the
 596               left of the dialog and deselect the
 597               <guilabel>Enabled</guilabel> check-box.
 598             </para>
 599           </listitem>
 600         </orderedlist>
 601       </para>
 602       <para>
 603         To remove an account, proceed as follows:
 604       </para>
 605       <para>
 606         <orderedlist>
 607           <listitem>
 608             <para>
 609               From the <link linkend="empathy-FIG-mainwindow">main window
 610               </link> (<guilabel>Contact List</guilabel>)
 611               click on the account button or press <keycap>F4</keycap>
 612               to open the
 613               <guilabel>Accounts</guilabel> dialog.
 614             </para>
 615           </listitem>
 616           <listitem>
 617             <para>
 618               Select the account you wish to disable in the box on the
 619               left of the dialog.
 620             </para>
 621           </listitem>
 622           <listitem>
 623             <para>
 624               Click on the <guibutton>Remove</guibutton> button.
 625             </para>
 626           </listitem>
 627           <listitem>
 628             <para>
 629               A dialog will be shown asking for confirmation. Click on
 630               the <guibutton>Remove</guibutton> button to remove the account.
 631             </para>
 632           </listitem>
 633         </orderedlist>
 634       </para>
 635     </sect2>
 636
 637     <sect2 id="empathy-advanced-options">
 638       <title>Advanced Options</title>
 639       <para>
 640         TODO
 641       </para>
 642     </sect2>
 643
 644   </sect1>
 645
 646   <sect1 id="empathy-contacts-groups">
 647     <title>Contacts and Groups</title>
 648     <para>
 649       All the contacts are handled within &app;'s <link
 650       linkend="empathy-FIG-mainwindow">main window</link>.
 651     </para>
 652     <sect2 id="empathy-add-contact">
 653       <title>Adding and Removing a Contact</title>
 654       <para>
 655         To add a new contact, proceed as follows:
 656       </para>
 657       <para>
 658         <orderedlist>
 659           <listitem>
 660             <para>
 661               From the <link linkend="empathy-FIG-mainwindow">main
 662                 window</link> choose <menuchoice>
 663                 <guimenu>Chat</guimenu>
 664                 <guimenuitem>Add Contact...</guimenuitem>
 665               </menuchoice>. The <guilabel>New Contact</guilabel>
 666                 dialog will be shown.
 667             </para>
 668           </listitem>
 669           <listitem>
 670             <para>
 671               From the <guilabel>Account</guilabel> drop-down list,
 672               choose the service used by the contact you are adding.
 673             </para>
 674           </listitem>
 675           <listitem>
 676             <para>
 677               In the <guilabel>Identifier</guilabel> text box type the
 678               <emphasis>address</emphasis> of the contact in the form
 679               of
 680               <userinput><replaceable>user name</replaceable>@<replaceable>service
 681               domain</replaceable></userinput>.
 682             </para>
 683           </listitem>
 684           <listitem>
 685             <para>
 686               In the <guilabel>Alias</guilabel> text box type the name
 687               you want to give at the the new contact.
 688             </para>
 689           </listitem>
 690           <listitem>
 691             <para>
 692               Click on <guibutton>Add</guibutton> to add the new contact.
 693             </para>
 694           </listitem>
 695         </orderedlist>
 696       </para>
 697       <para>
 698         To remove a contact, proceed as follows:
 699       </para>
 700       <para>
 701         <orderedlist>
 702           <listitem>
 703             <para>
 704               From the <link linkend="empathy-FIG-mainwindow">main
 705               window</link>, select the contact you would like
 706               to remove and right-click on it.
 707             </para>
 708           </listitem>
 709           <listitem>
 710             <para>
 711               From the popup menu, choose <guilabel>Remove</guilabel> to
 712               remove the contact.
 713             </para>
 714           </listitem>
 715         </orderedlist>
 716       </para>
 717       <para>
 718         <note>
 719           <para>
 720             An <emphasis>alias</emphasis> is an alternative way you
 721             can identify that particular contact. You can use the real
 722             name or the nickname of that person.
 723           </para>
 724         </note>
 725       </para>
 726     </sect2>
 727     <sect2 id="empathy-edit-contact">
 728       <title>Editing a Contact</title>
 729       <para>
 730         To edit a contact, proceed as follows:
 731       </para>
 732       <para>
 733         <orderedlist>
 734           <listitem>
 735             <para>
 736               From the <link linkend="empathy-FIG-mainwindow">main
 737               window</link>, select the contact you would like
 738               to modify and right-click on it.
 739             </para>
 740           </listitem>
 741           <listitem>
 742             <para>
 743               From the popup menu, choose <guilabel>Modify</guilabel>
 744               to modify the contact.
 745             </para>
 746           </listitem>
 747         </orderedlist>
 748       </para>
 749       <para>
 750         From the <guilabel>Edit Contact Information</guilabel> dialog,
 751         you can modify the <emphasis>alias</emphasis>
 752         and the <emphasis>group</emphasis> of the contact.
 753       </para>
 754       <para>
 755         <note>
 756           <para>
 757             An <emphasis>alias</emphasis> is an alternative way you
 758             can identify that particular contact. You can use the real
 759             name or the nickname of that person.
 760           </para>
 761         </note>
 762       </para>
 763       <para>
 764         For more information about groups, see <xref
 765           linkend="empathy-add-contact-group"/> and <xref
 766           linkend="empathy-add-group"/>.
 767       </para>
 768     </sect2>
 769
 770     <sect2 id="empathy-add-contact-group">
 771       <title>Adding a Contact to a Group</title>
 772       <para>
 773         To add a contact to one or more groups, proceed as follows:
 774       </para>
 775       <para>
 776         <orderedlist>
 777           <listitem>
 778             <para>
 779               From the <link linkend="empathy-FIG-mainwindow">main
 780                 window</link>, select the contact you would like
 781               to modify and right-click on it.
 782             </para>
 783           </listitem>
 784           <listitem>
 785             <para>
 786               From the popup menu, choose <guilabel>Modify</guilabel>.
 787             </para>
 788           </listitem>
 789           <listitem>
 790             <para>
 791               From the <guilabel>Groups</guilabel> section, select the
 792               group, or groups, you want to add the contact to.
 793             </para>
 794           </listitem>
 795           <listitem>
 796             <para>
 797               When done, click <guibutton>Close</guibutton>.
 798             </para>
 799           </listitem>
 800         </orderedlist>
 801       </para>
 802     </sect2>
 803
 804     <sect2 id="empathy-add-group">
 805       <title>Adding a New Group</title>
 806       <para>
 807         To add a new group, proceed as follows:
 808       </para>
 809       <para>
 810         <orderedlist>
 811           <listitem>
 812             <para>
 813               From the <link linkend="empathy-FIG-mainwindow">main
 814                 window</link>, select one contact and right-click on it.
 815             </para>
 816           </listitem>
 817           <listitem>
 818             <para>
 819               From the popup menu, choose <guilabel>Modify</guilabel>.
 820             </para>
 821           </listitem>
 822           <listitem>
 823             <para>
 824               In the <guilabel>Groups</guilabel> section, write the
 825               name of the group you want to add and then click on
 826               <guibutton>Add Group</guibutton>.
 827             </para>
 828           </listitem>
 829           <listitem>
 830             <para>
 831               When done, click <guibutton>Close</guibutton>.
 832             </para>
 833           </listitem>
 834         </orderedlist>
 835       </para>
 836     </sect2>
 837   </sect1>
 838
 839   <sect1 id="empathy-edit-personal-information">
 840     <title>Editing Personal Information</title>
 841     <para>
 842       To change your personal information, your alias and your
 843       icon (the image that other contacts will see of you), for each
 844       of your accounts, proceed as follows:
 845     </para>
 846     <para>
 847       <orderedlist>
 848         <listitem>
 849           <para>
 850             From the <link linkend="empathy-FIG-mainwindow">main
 851               window</link>, select <menuchoice>
 852               <guimenu>Edit</guimenu>
 853               <guimenuitem>Personal Information</guimenuitem>
 854             </menuchoice>.
 855           </para>
 856         </listitem>
 857         <listitem>
 858           <para>
 859             From the <guilabel>Account</guilabel> drop-down list, choose
 860             the account you want to edit.
 861           </para>
 862         </listitem>
 863         <listitem>
 864           <para>
 865             In the <guilabel>Alias</guilabel> text box, write your new
 866             alias.
 867           </para>
 868         </listitem>
 869         <listitem>
 870           <para>
 871             To change your icon, click on the person-looking button and
 872             choose an image file.
 873           </para>
 874         </listitem>
 875         <listitem>
 876           <para>
 877             When done, click <guibutton>Close</guibutton>.
 878           </para>
 879         </listitem>
 880       </orderedlist>
 881     </para>
 882       <para>
 883         <note>
 884           <para>
 885             An <emphasis>alias</emphasis> is an alternative way you
 886             can identify yourself. You can use your real
 887             name or your nickname.
 888           </para>
 889         </note>
 890       </para>
 891   </sect1>
 892
 893 <!--
 894   <sect1 id="empathy-send-receive-message">
 895     <title>Sending and Receiving Messages</title>
 896     <para>
 897     </para>
 898   </sect1>
 899
 900   <sect1 id="empathy-preferences">
 901     <title>Preferences</title>
 902     <para>
 903     </para>
 904   </sect1>
 905 -->
 906
 907 </article>