]> git.0d.be Git - empathy.git/blob - help/C/empathy.xml
More work on the help, thanks to Milo Casagrande.
[empathy.git] / 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 it's 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 your nickname.
750           </para>
751         </note>
752       </para>
753     </sect2>
754     
755     <sect2 id="empathy-advanced-options">
756       <title>Advanced Options</title> 
757       <para>
758         TODO
759       </para>
760     </sect2>
761     
762   </sect1>
763
764   <sect1 id="empathy-contacts-groups">
765     <title>Contacts and Groups</title>
766     <para>
767       All the contacts are handled within &app;'s <link
768       linkend="empathy-FIG-mainwindow">main window</link>.
769     </para>
770     <para>
771       You can add or remove a contact or you can edit the information
772       of a particular contact. It is also possibile to arrange
773       contacts in groups. You can have a group for your work contacts,
774       one for you family contacts, and so on.
775     </para>
776      <sect2 id="empathy-add-contact">
777       <title>Adding and Removing a Contact</title>
778       <para>
779         To add a new contact, proceed as follows:
780       </para>
781       <para>
782         <orderedlist>
783           <listitem>
784             <para>
785               From the <link linkend="empathy-FIG-mainwindow">main
786                 window</link> choose <menuchoice>
787                 <guimenu>Chat</guimenu>
788                 <guimenuitem>Add Contact...</guimenuitem>
789               </menuchoice>. The <guilabel>New Contact</guilabel>
790                 dialog will be shown.
791             </para>
792           </listitem>
793           <listitem>
794             <para>
795               From the <guilabel>Account</guilabel> drop-down list,
796               choose the service used by the contact you are adding.
797             </para>
798           </listitem>
799           <listitem>
800             <para>
801               In the <guilabel>Identifier</guilabel> text box type the
802               <emphasis>address</emphasis> of the contact in the form
803               of
804               <userinput><replaceable>user name</replaceable>@<replaceable>service
805               domain</replaceable></userinput>.
806             </para>
807           </listitem>
808           <listitem>
809             <para>
810               In the <guilabel>Alias</guilabel> text box type the name
811               you want to give at the the new contact.
812             </para>
813           </listitem>
814           <listitem>
815             <para>
816               Click on <guibutton>Add</guibutton> to add the new contact.
817             </para>
818           </listitem>
819         </orderedlist>
820       </para>
821       <para>
822         To remove a contact, proceed as follows:
823       </para>
824       <para>
825         <orderedlist>
826           <listitem>
827             <para>
828               From the <link linkend="empathy-FIG-mainwindow">main
829               window</link>, select the contact you would like
830               to remove and right-click on it.
831             </para>
832           </listitem>
833           <listitem>
834             <para>
835               From the popup menu, choose <guilabel>Remove</guilabel> to
836               remove the contact.
837             </para>
838           </listitem>
839         </orderedlist>
840       </para>
841       <para>
842         <note>
843           <para>
844             An <emphasis>alias</emphasis> is an alternative way you
845             can identify that particular contact. You can use the real
846             name or the nickname of that person.
847           </para>
848         </note>
849       </para>
850     </sect2>
851     <sect2 id="empathy-edit-contact">
852       <title>Editing a Contact</title>
853       <para>
854         To edit a contact, proceed as follows:
855       </para>
856       <para>
857         <orderedlist>
858           <listitem>
859             <para>
860               From the <link linkend="empathy-FIG-mainwindow">main
861                 window</link>, select the contact you would like
862               to modify and choose <menuchoice>
863                 <guimenu>Edit</guimenu>
864                 <guisubmenu>Account</guisubmenu>
865                 <guimenuitem>Modify</guimenuitem>
866               </menuchoice>, or right-click on it
867               and choose <guilabel>Modify</guilabel>.
868             </para>
869           </listitem>
870         </orderedlist>
871       </para>
872       <para>
873         From the <guilabel>Edit Contact Information</guilabel> dialog,
874         you can modify the <emphasis>alias</emphasis>
875         and the <emphasis>group</emphasis> of the contact.
876       </para>
877       <para>
878         <note>
879           <para>
880             An <emphasis>alias</emphasis> is an alternative way you
881             can identify that particular contact. You can use the real
882             name or the nickname of that person.
883           </para>
884         </note>
885       </para>
886       <para>
887         For more information about groups, see <xref
888           linkend="empathy-add-contact-group"/> and <xref
889           linkend="empathy-add-group"/>.
890       </para>
891     </sect2>
892     
893     <sect2 id="empathy-add-contact-group">
894       <title>Adding a Contact to a Group</title>
895       <para>
896         To add a contact to one or more groups, proceed as follows:
897       </para>
898       <para>
899         <orderedlist>
900           <listitem>
901             <para>
902               From the <link linkend="empathy-FIG-mainwindow">main
903                 window</link>, select the contact you would like
904               to modify and choose <menuchoice>
905                 <guimenu>Edit</guimenu>
906                 <guisubmenu>Account</guisubmenu>
907                 <guimenuitem>Modify</guimenuitem>
908               </menuchoice>, or right-click on it
909               and choose <guilabel>Modify</guilabel>.
910             </para>
911           </listitem>
912           <listitem>
913             <para>
914               From the <guilabel>Groups</guilabel> section, select the
915               group, or groups, you want to add the contact to.
916             </para>
917           </listitem>
918           <listitem>
919             <para>
920               When done, click <guibutton>Close</guibutton>.
921             </para>
922           </listitem>
923         </orderedlist>
924       </para>
925     </sect2>
926
927     <sect2 id="empathy-add-group">
928       <title>Adding a New Group</title>
929       <para>
930         To add a new group, proceed as follows:
931       </para>
932       <para>
933         <orderedlist>
934           <listitem>
935             <para>
936               From the <link linkend="empathy-FIG-mainwindow">main
937                 window</link>, select one contact and choose <menuchoice>
938                 <guimenu>Edit</guimenu>
939                 <guisubmenu>Account</guisubmenu>
940                 <guimenuitem>Modify</guimenuitem>
941               </menuchoice>, or right-click on it
942               and choose <guilabel>Modify</guilabel>.
943             </para>
944           </listitem>
945           <listitem>
946             <para>
947               In the <guilabel>Groups</guilabel> section, write the
948               name of the group you want to add and then click on
949               <guibutton>Add Group</guibutton>.
950             </para>
951           </listitem>
952           <listitem>
953             <para>
954               When done, click <guibutton>Close</guibutton>.
955             </para>
956           </listitem>
957         </orderedlist>
958       </para>   
959     </sect2>
960   </sect1>
961
962
963
964 <!--
965   <sect1 id="empathy-send-receive-message">
966     <title>Sending and Receiving Messages</title>
967     <para>
968     </para>
969   </sect1>
970
971   <sect1 id="empathy-preferences">
972     <title>Preferences</title>
973     <para>
974     </para>
975   </sect1>
976 -->
977   
978 </article>