+++ /dev/null
-<?xml version="1.0"?>
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
-<!ENTITY legal SYSTEM "legal.xml">
-<!ENTITY appversion "2.28">
-<!ENTITY manrevision "2.2">
-<!ENTITY date "May 2009">
-<!ENTITY app "<application>Empathy</application>">
-<!ENTITY appname "Empathy">
-<!ENTITY gtalk "http://www.google.com/talk/">
-<!ENTITY icq "https://www.icq.com/register/">
-<!ENTITY aim "http://dashboard.aim.com/aim">
-<!ENTITY msn "https://accountservices.passport.net">
-<!ENTITY yahoo "https://login.yahoo.com/config/login">
-<!ENTITY fwd
-"http://account2.freeworlddialup.com/index.php?section_id=94">
-<!ENTITY ekiga "https://www.ekiga.net/index.php?page=register">
-<!ENTITY sipphone
-"https://signup.sipphone.com/new-users/app?class=NewUser;proc=start">
-<!ENTITY jabber "http://www.jabber.org/web/Jabber.org">
-]>
-<?db.chunk.max_depth 2?>
-<article id="index" lang="en">
- <!-- please do not change the id; for translations, change lang to -->
- <!-- appropriate code -->
- <articleinfo>
- <title>&app; Manual V&manrevision;</title>
-
- <copyright>
- <year>2008, 2009</year>
- <holder>Ubuntu Documentation Project</holder>
- </copyright>
- <copyright>
- <year>2009</year>
- <holder>GNOME Documentation Project</holder>
- </copyright>
-
- <!-- An address can be added to the publisher information. If a role is
- not specified, the publisher/author is the same for all versions of the
- document. -->
- <publisher>
- <publishername>GNOME Documentation Project</publishername>
- </publisher>
-
- <!-- licence stuff -->
- &legal;
-
- <authorgroup>
- <author role="maintainer">
- <firstname>Milo</firstname>
- <surname>Casagrande</surname>
- <affiliation>
- <orgname>GNOME Documentation Project</orgname>
- <address><email>milo@ubuntu.com</email></address>
- </affiliation>
- <affiliation>
- <orgname>Ubuntu Documentation Project</orgname>
- <address><email>milo@ubuntu.com</email></address>
- </affiliation>
- </author>
- <author>
- <firstname>Seth</firstname>
- <surname>Dudenhofer</surname>
- <affiliation>
- <orgname>Ubuntu Documentation Project</orgname>
- <address><email>sdudenhofer@gmail.com</email></address>
- </affiliation>
- </author>
- </authorgroup>
-
- <releaseinfo revision="2.28" role="incomplete">
- <ulink type="bug" url="http://bugzilla.gnome.org/show_bug.cgi?id=561033" />
- <ulink type="planning" url="http://live.gnome.org/Empathy/Documentation" />
- </releaseinfo>
-
-<!-- According to GNU FDL, revision history is mandatory if you are -->
-<!-- modifying/reusing someone else's document. If not, you can omit it. -->
-<!-- Remember to remove the &manrevision; entity from the revision -->
-<!-- entries other than the current revision. -->
-<!-- The revision numbering system for GNOME manuals is as follows: -->
-<!-- * the revision number consists of two components -->
-<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
-<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
-<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
-<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
-<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
-<!-- to V3.0, and so on. -->
- <revhistory>
- <revision>
- <revnumber>Empathy Manual V&manrevision;</revnumber>
- <date>&date;</date>
- <revdescription>
- <para role="author">Milo Casagrande
- <email>milo@ubuntu.com</email>
- </para>
- <para role="publisher">GNOME Documentation Project</para>
- </revdescription>
- </revision>
-
- <revision>
- <revnumber>Empathy Manual V2.1</revnumber>
- <date>January 2009</date>
- <revdescription>
- <para role="author">Milo Casagrande
- <email>milo@ubuntu.com</email>
- </para>
- <para role="publisher">Ubuntu Documentation Project</para>
- </revdescription>
- </revision>
-
- <revision>
- <revnumber>Empathy Manual V2.0</revnumber>
- <date>April 2008</date>
- <revdescription>
- <para role="author">Milo Casagrande
- <email>milo@ubuntu.com</email>
- </para>
- <para role="author">Seth Dudenhofer
- <email>sdudenhofer@gmail.com</email>
- </para>
- <para role="publisher">Ubuntu Documentation Project</para>
- </revdescription>
- </revision>
- </revhistory>
-
- <releaseinfo>
- This manual describes version &appversion; of &appname;.
- </releaseinfo>
- <legalnotice>
- <title>Feedback</title>
- <para>
- To report a bug or make a suggestion regarding the &app; application or
- this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback" type="help">GNOME Feedback Page</ulink>.
- </para>
- </legalnotice>
-
- <abstract role="description">
- <para>
- &appname; is an application for instant messaging.
- </para>
- </abstract>
-
- </articleinfo>
-
- <indexterm zone="index">
- <primary>Empathy</primary>
- </indexterm>
- <indexterm zone="index">
- <primary>empathy</primary>
- <secondary>istant messaging</secondary>
- </indexterm>
-
- <sect1 id="empathy-intro">
- <title>Introduction</title>
- <para>
- &app; is a multi-protocol instant messaging program for the
- GNOME Desktop. With &app; you can keep in touch with all of your
- friends through lots of supported instant messaging services.
- </para>
- <para>
- &app; supports the following services:
- <itemizedlist>
- <listitem>
- <para>
- <acronym>AIM</acronym>
- </para>
- </listitem>
- <listitem>
- <para>
- Google Talk
- </para>
- </listitem>
- <listitem>
- <para>
- ICQ
- </para>
- </listitem>
- <listitem>
- <para>
- <acronym>IRC</acronym>
- </para>
- </listitem>
- <listitem>
- <para>
- Jabber (or <acronym>XMPP</acronym>)
- </para>
- </listitem>
- <listitem>
- <para>
- <acronym>MSN</acronym>
- </para>
- </listitem>
- <listitem>
- <para>
- Salut
- </para>
- </listitem>
- <listitem>
- <para>
- <acronym>SIP</acronym>
- </para>
- </listitem>
- <listitem>
- <para>
- Yahoo
- </para>
- </listitem>
- <listitem>
- <para>
- And many others...
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </sect1>
-
- <sect1 id="empathy-getting-started">
- <title>Getting Started</title>
-
- <sect2 id="empathy-starting">
- <title>Starting &appname;</title>
- <para>You can start &app; in the following ways:
- </para>
- <variablelist>
- <varlistentry>
- <term><guimenu>Applications</guimenu> menu</term>
- <listitem>
- <para>Choose
- <menuchoice>
- <guisubmenu>Internet</guisubmenu>
- <guimenuitem>Empathy IM Client</guimenuitem>
- </menuchoice>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Command line</term>
- <listitem>
- <para>Type <command>empathy</command> and then press
- <keycap>Enter</keycap>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
-
- <sect2 id="emphaty-when-start">
- <title>When You Start &appname;</title>
- <para>
- When you start &app; the following window is shown.
- <!-- Figure 1 -->
- <figure id="empathy-FIG-mainwindow">
- <title>&app; Main Window</title>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/empathy-main-window.png" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>
- Shows &app; main window. Contains the titlebar, the
- menubar, contact list, status icon and status arrow
- button list.
- </phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
- <!-- End of Figure -->
- </para>
- <para>
- <xref linkend="empathy-TBL-1"/> describes the components of
- &app;'s main window.
- <table frame="topbot" id="empathy-TBL-1">
- <title>&app; Main Components</title>
- <tgroup cols="2" colsep="0" rowsep="0">
- <colspec colname="colspec0" colwidth="29.39*"/>
- <colspec colname="colspec1" colwidth="70.61*"/>
- <thead>
- <row rowsep="1">
- <entry valign="top">
- <para>Component</para>
- </entry>
- <entry valign="top">
- <para>Description</para>
- </entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry valign="top">
- <para>Menubar</para>
- </entry>
- <entry valign="top">
- <para>
- Contains menus used to perform actions in &app;.
- </para>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>Status Drop-Down List</para>
- </entry>
- <entry valign="top">
- <para>
- Allows to update the status.
- </para>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>Account Button</para>
- </entry>
- <entry valign="top">
- <para>
- Opens the <guilabel>Accounts</guilabel> dialog.
- </para>
- </entry>
- </row>
- <row>
- <entry valign="top">
- <para>Contact List</para>
- </entry>
- <entry valign="top">
- <para>
- Shows all the available contacts and their
- associated status.
- </para>
- </entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- </para>
- </sect2>
- </sect1>
-
- <sect1 id="empathy-accounts">
- <title>Accounts</title>
- <para>
- To use &app; you need at least one account of the supported services.
- </para>
- <para>
- If you don't already have an account and you don't have your <emphasis>user
- name</emphasis> and <emphasis>password</emphasis>, you need to
- register a new account (see <xref linkend="empathy-register-account" />).
- </para>
- <para>
- In order to talk with other users, also called
- <emphasis>contacts</emphasis>, you need to use the same service
- they are using. If, for example, one contact is using the <emphasis
- role="strong">Jabber</emphasis> service, you need to have an
- account registered with that service.
- </para>
- <para>
- &app; can handle as many accounts on any supported services as you want and
- you can have them all open at the same time.
- </para>
-
- <sect2 id="empathy-register-account">
- <title>Registering an Account</title>
- <para>
- You can freely register an account on any of the following
- services. Follow the instructions reported on each website on
- how to register your new account. At the end of the
- registration process you should have a <emphasis>user
- name</emphasis> (or an <emphasis>account ID</emphasis>) and
- a <emphasis>password</emphasis> that you will use to
- create the account in &app;.
- </para>
- <para>
- Click on the name of the service to visit its website:
- <!-- Need to do like that, if using only
- <ulink>SERVICE</ulink> it wouldn't be possibile to
- localize the links -->
- <itemizedlist>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url="&aim;">AIM</ulink> service.
- </para>
- </listitem>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url=">alk;">Google
- Talk</ulink> service.
- </para>
- </listitem>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url="&icq;">ICQ</ulink> service.
- </para>
- </listitem>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url="&msn;">MSN</ulink> service.
- </para>
- </listitem>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url="&yahoo;">Yahoo</ulink> service.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- For registering a <acronym>SIP</acronym> account, you can use one of the
- following service:
- </para>
- <para>
- <itemizedlist>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url="&ekiga;">Ekiga</ulink> service.
- </para>
- </listitem>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url="&fwd;"><acronym>FWD</acronym></ulink> (Free
- World Dialup) service.
- </para>
- </listitem>
- <listitem>
- <!-- Translators: try to find a localized version of the
- registration service website -->
- <para>
- The <ulink type="http" url="&sipphone;">Sipphone</ulink> service.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- For registering a <emphasis role="strong">Jabber</emphasis>
- account, you can use the automatic
- account creation of &app;. Not all Jabber service
- providers support the automatic creation of accounts, one
- service provider known to work with &app; is <ulink
- type="http" url="&jabber;">jabber.org</ulink>.
- </para>
- <para>
- If you already have a <emphasis
- role="strong">Jabber</emphasis> account, you can use one of
- the following services:
- </para>
- <para>
- <itemizedlist>
- <listitem>
- <para>
- Salut
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </sect2>
-
- <sect2 id="empathy-create-account">
- <title>Adding your Account to &app;</title>
- <para>
- To add your account to &app;, proceed as follows:
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main window
- </link> (<guilabel>Contact List</guilabel>)
- click on the account button or press <keycap>F4</keycap> to open the
- <guilabel>Accounts</guilabel> dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- If it is the first time you launch &app;:
- <orderedlist>
- <listitem>
- <para>
- From the <guilabel>Type</guilabel> drop-down list choose
- the service you wish to add an account for, then click
- on the <guibutton>Create</guibutton> button.
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- Otherwise:
- <orderedlist>
- <listitem>
- <para>
- Click on the <guilabel>Add</guilabel> button.
- </para>
- </listitem>
- <listitem>
- <para>
- From the <guilabel>Type</guilabel> drop-down list choose
- the service you wish to add an account for, then click
- on the <guibutton>Create</guibutton> button.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </listitem>
- <listitem>
- <para>
- Fill the required fields with your <emphasis>user
- name</emphasis> and
- <emphasis>password</emphasis>. Optionally, you can
- modify some advanced options. For more information,
- see <xref linkend="empathy-advanced-options"/>.
- </para>
- </listitem>
- <listitem>
- <para>
- To enable the new account, select the
- <guilabel>Enabled</guilabel> check-box next to
- the name of the account in the box on the left.
- </para>
- </listitem>
- </orderedlist>
- </para>
-
- <sect3 id="empathy-importing-accounts">
- <title>Importing Accounts</title>
- <para>
- If you use another instant messaging program, you can import
- the accounts from that program into &app;
- </para>
- <para>
- <note>
- <para>
- At the moment &app; can import the accounts only from
- the instant messaging program
- <application>Pidgin</application>. For more information
- about <application>Pidgin</application>, see the <ulink
- type="http" url="http://www.pidgin.im/">Pidgin website</ulink>.
- </para>
- </note>
- </para>
- <para>
- To import the accounts into &app;, proceed as follows:
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main window
- </link> (<guilabel>Contact List</guilabel>)
- click on the account button or press <keycap>F4</keycap> to open the
- <guilabel>Accounts</guilabel> dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- Click on the <guibutton>Import Accounts...</guibutton>
- button to open the <guilabel>Import
- Accounts</guilabel> dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- Select the accounts you would like to import by
- clicking on the <guilabel>Import</guilabel> check-box.
- </para>
- </listitem>
- <listitem>
- <para>
- When you have selected all the desired accounts, click
- <guibutton>OK</guibutton> to import them. If you don't
- want to import the accounts, click
- <guibutton>Cancel</guibutton>.
- </para>
- </listitem>
- <listitem>
- <para>
- When you import a new account into &app;, it will not be
- enabled by default.
- </para>
- <para>
- To enable the new account, select the
- <guilabel>Enabled</guilabel> check-box next to
- the name of the account in the box on the left.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </sect3>
- </sect2>
-
- <sect2 id="empathy-edit-account">
- <title>Editing an Account</title>
- <para>
- To edit one of your accounts, i.e. to change the
- <emphasis>password</emphasis> or your <emphasis>user
- name</emphasis>, proceed as follows:
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main window
- </link> (<guilabel>Contact List</guilabel>)
- click on the account button or press <keycap>F4</keycap> to open the
- <guilabel>Accounts</guilabel> dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- Select the account you wish to edit in the box on the
- left.
- </para>
- </listitem>
- <listitem>
- <para>
- Modify the desired data.
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- <note>
- <para>
- Based on the type of the account, it is possibile to edit
- different settings.
- </para>
- </note>
- </para>
- <para>
- To modify the identifier of an account, how &app; identifies
- an account, proceed as follows:
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main window
- </link> (<guilabel>Contact List</guilabel>)
- click on the account button or press <keycap>F4</keycap> to open the
- <guilabel>Accounts</guilabel> dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- Select the account you wish to edit in the box on the
- left and double-click on its name.
- </para>
- </listitem>
- <listitem>
- <para>
- Change the name of the account as you desire.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </sect2>
-
- <sect2 id="empathy-disabling-removing-account">
- <title>Disabling and Removing an Account</title>
- <para>
- To disable an account, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main window
- </link> (<guilabel>Contact List</guilabel>)
- click on the account button or press <keycap>F4</keycap>
- to open the
- <guilabel>Accounts</guilabel> dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- Select the account you wish to disable in the box on the
- left of the dialog and deselect the
- <guilabel>Enabled</guilabel> check-box.
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- To remove an account, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main window
- </link> (<guilabel>Contact List</guilabel>)
- click on the account button or press <keycap>F4</keycap>
- to open the
- <guilabel>Accounts</guilabel> dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- Select the account you wish to disable in the box on the
- left of the dialog.
- </para>
- </listitem>
- <listitem>
- <para>
- Click on the <guibutton>Remove</guibutton> button.
- </para>
- </listitem>
- <listitem>
- <para>
- A dialog will be shown asking for confirmation. Click on
- the <guibutton>Remove</guibutton> button to remove the account.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </sect2>
-
- <sect2 id="empathy-edit-personal-information">
- <title>Editing Personal Information</title>
- <para>
- To change your personal information, your alias and your
- icon (the image that other contacts will see of you), for each
- of your accounts, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main
- window</link>, select <menuchoice>
- <guimenu>Edit</guimenu>
- <guimenuitem>Personal Information</guimenuitem>
- </menuchoice>.
- </para>
- </listitem>
- <listitem>
- <para>
- From the <guilabel>Account</guilabel> drop-down list, choose
- the account you want to edit.
- </para>
- </listitem>
- <listitem>
- <para>
- In the <guilabel>Alias</guilabel> text box, write your new
- alias.
- </para>
- </listitem>
- <listitem>
- <para>
- To change your icon, click on the person-looking button and
- choose an image file.
- </para>
- </listitem>
- <listitem>
- <para>
- When done, click <guibutton>Close</guibutton>.
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- <note>
- <para>
- An <emphasis>alias</emphasis> is an alternative way you
- can identify yourself. You can use your real
- name or a nickname.
- </para>
- </note>
- </para>
- </sect2>
-
- <sect2 id="empathy-advanced-options">
- <title>Advanced Options</title>
- <para>
- Based on the service you are using, it is possible to
- configure more advanced options to modify the normal behavior of
- &app;.
- </para>
- <para>
- To configure these options, when you are <link
- linkend="empathy-create-account">adding a new
- account</link>, click on the drop-down section
- <guilabel>Advanced</guilabel>.
- </para>
-
- <sect3 id="empathy-xmpp-advanced">
- <title>
- Jabber (or <acronym>XMPP</acronym>) and Google Talk
- </title>
- <para>
- <variablelist>
- <varlistentry>
- <term>
- <guilabel>Encryption required (TLS/SSL)</guilabel>
- </term>
- <listitem>
- <para>
- Select this option in order to use some sort of
- encryption during your conversations.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Ignore SSL certificate errors</guilabel>
- </term>
- <listitem>
- <para>
- Select this option in order to ignore the errors
- that can be generated by some types of security
- certificates. Usually these certificates are called
- auto-signed.
- </para>
- <para>
- <note>
- <para>
- Select this option only if you are sure the
- certificate is secure and you can trust it.
- </para>
- </note>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Resource</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to set a name with which you can
- identify the running program based on where you are
- running it. With this option, and the
- <guilabel>Priority</guilabel> one, you can
- use your account simultaneously in two different
- devices. For example, if you set one device to
- <replaceable>desktop</replaceable> and the other
- one to <replaceable>mobile</replaceable>, you can
- connect with both of them and based on the
- <guilabel>Priority</guilabel> value you will receive
- messages on one of the two devices or both.
- </para>
- <para>
- This can be useful if you have two devices, a main
- one and a portable one, and you move away from the
- main one bringing with you the other: you can still
- receive messages from your account with the portable
- device even if you do not disconnet from the main one.
- </para>
- <para>
- <note>
- <para>
- If you set the same value for this text box on
- both the devices, when you connect with one of
- them, the other one will be disconnected, even
- if you set a different value with the
- <guilabel>Priority</guilabel> spin box.
- </para>
- </note>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Priority</guilabel>
- </term>
- <listitem>
- <para>
- Use this spin box to indicate wich device, set in
- the <guilabel>Resource</guilabel> text box, will
- receive the new messages. The higher the number, the
- higher the priority: you will receive the new
- messages on the device with the highest number.
- </para>
- <para>
- You can set values in the range from
- <literal>-128</literal> to <literal>127</literal>.
- </para>
- <para>
- <note>
- <para>
- If you set the same value of this spin box in
- both the devices, you will receive messages on
- both of them.
- </para>
- </note>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <para>
- In the <guilabel>Override server settings</guilabel> section
- you can set options that take precedence over the default settings.
- <variablelist>
- <varlistentry>
- <term>
- <guilabel>Server</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to write the name of the
- server you want to use for this service.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Port</guilabel>
- </term>
- <listitem>
- <para>
- Use this spin box to set the number of the port of
- the server to use.
- </para>
- <para>
- You can set values in the range from
- <literal>0</literal> to <literal>65,555</literal>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Use old SSL</guilabel>
- </term>
- <listitem>
- <para>
- Select this option to use the old version of the
- secure protocol for encrypting your connection.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </sect3>
-
- <sect3 id="empathy-yahoo-advanced">
- <title>Yahoo</title>
- <para>
- <variablelist>
- <varlistentry>
- <term>
- <guilabel>Ignore conference and chatrooms
- invitations</guilabel>
- </term>
- <listitem>
- <para>
- Select this option to ignore the invitations that
- other people may send you.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Room List locale</guilabel>
- </term>
- <listitem>
- <para>
- The value of this text box identifies the language
- used to retrieve the room list when connecting to
- the Yahoo service.
- </para>
- <para>
- If you need to change this value, use the two letter
- code of your language.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Charset</guilabel>
- </term>
- <listitem>
- <para>
- The value of this text box identifies the set of the
- characters used by &app;.
- </para>
- <para>
- <note>
- <para>
- It is advise to leave this value to
- <literal>UTF-8</literal>. Change it only
- if that charset does not cover your language.
- </para>
- </note>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Server</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to write the name of the
- server you want to use for this service.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Port</guilabel>
- </term>
- <listitem>
- <para>
- Use this spin box to set the number of the port of
- the server to use.
- </para>
- <para>
- You can set values in the range from
- <literal>0</literal> to <literal>65,555</literal>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Use Yahoo Japan</guilabel>
- </term>
- <listitem>
- <para>
- Select this option only if you have a Yahoo! Japan
- account. With the Yahoo! Japan service you can only
- use a Yahoo! Japan account: if you have registered
- an account with the English version of the service,
- that account will not work.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </sect3>
-
- <sect3 id="empathy-msn-advanced">
- <title><acronym>AIM</acronym>, GroupWise and <acronym>MSN</acronym></title>
- <para>
- <variablelist>
- <varlistentry>
- <term>
- <guilabel>Server</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to write the name of the
- server you want to use for this service.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Port</guilabel>
- </term>
- <listitem>
- <para>
- Use this spin box to set the number of the port of
- the server to use.
- </para>
- <para>
- You can set values in the range from
- <literal>0</literal> to <literal>65,555</literal>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </sect3>
-
- <sect3 id="empathy-salut-advanced">
- <title>Salut</title>
- <para>
- <variablelist>
- <varlistentry>
- <term>
- <guilabel>Published Name</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to write the name that will be
- visible to the other users of the network.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Email</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to write your email.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Jabber ID</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to write your Jabber ID, if you
- have one.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </sect3>
-
- <sect3 id="empathy-icq-advanced">
- <title>ICQ</title>
- <para>
- <variablelist>
- <varlistentry>
- <term>
- <guilabel>Charset</guilabel>
- </term>
- <listitem>
- <para>
- The value of this text box identifies the set of the
- characters used by &app;.
- </para>
- <para>
- <note>
- <para>
- It is advise to leave this value to
- <literal>UTF-8</literal>. Change it only
- if that charset does not cover your language.
- </para>
- </note>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Server</guilabel>
- </term>
- <listitem>
- <para>
- Use this text box to write the name of the
- server you want to use for this service.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <guilabel>Port</guilabel>
- </term>
- <listitem>
- <para>
- Use this spin box to set the number of the port of
- the server to use.
- </para>
- <para>
- You can set values in the range from
- <literal>0</literal> to <literal>65,555</literal>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </sect3>
-
- <sect3 id="empathy-gadugadu-advanced">
- <title>Gadu Gadu</title>
- <para>
- <variablelist>
- <varlistentry>
- <term><guilabel>Nick</guilabel></term>
- <listitem>
- <para>
- Use this text box to write an alternative name to
- use with this service.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </sect3>
-
- </sect2>
-
- </sect1>
-
- <sect1 id="empathy-contacts-groups">
- <title>Contacts and Groups</title>
- <para>
- All the contacts are handled within &app;'s <link
- linkend="empathy-FIG-mainwindow">main window</link>.
- </para>
- <para>
- You can add or remove a contact or you can edit the information
- of a particular contact. It is also possibile to arrange
- contacts in groups. You can have a group for your work contacts,
- one for you family contacts, and so on.
- </para>
- <sect2 id="empathy-add-contact">
- <title>Adding and Removing a Contact</title>
- <para>
- To add a new contact, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main
- window</link> choose <menuchoice>
- <guimenu>Chat</guimenu>
- <guimenuitem>Add Contact...</guimenuitem>
- </menuchoice>. The <guilabel>New Contact</guilabel>
- dialog will be shown.
- </para>
- </listitem>
- <listitem>
- <para>
- From the <guilabel>Account</guilabel> drop-down list,
- choose the service used by the contact you are adding.
- </para>
- </listitem>
- <listitem>
- <para>
- In the <guilabel>Identifier</guilabel> text box type the
- <emphasis>address</emphasis> of the contact in the form
- of
- <userinput><replaceable>user name</replaceable>@<replaceable>service
- domain</replaceable></userinput>.
- </para>
- </listitem>
- <listitem>
- <para>
- In the <guilabel>Alias</guilabel> text box type the name
- you want to give at the the new contact.
- </para>
- </listitem>
- <listitem>
- <para>
- Click on <guibutton>Add</guibutton> to add the new contact.
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- To remove a contact, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main
- window</link>, select the contact you would like
- to remove and right-click on it.
- </para>
- </listitem>
- <listitem>
- <para>
- From the popup menu, choose <guilabel>Remove</guilabel> to
- remove the contact.
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- <note>
- <para>
- An <emphasis>alias</emphasis> is an alternative way you
- can identify that particular contact. You can use the real
- name or the nickname of that person.
- </para>
- </note>
- </para>
- </sect2>
- <sect2 id="empathy-edit-contact">
- <title>Editing a Contact</title>
- <para>
- To edit a contact, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main
- window</link>, select the contact you would like
- to modify and choose <menuchoice>
- <guimenu>Edit</guimenu>
- <guisubmenu>Contact</guisubmenu>
- <guimenuitem>Edit</guimenuitem>
- </menuchoice>, or right-click on it
- and choose <guilabel>Edit</guilabel>.
- </para>
- </listitem>
- </orderedlist>
- </para>
- <para>
- From the <guilabel>Edit Contact Information</guilabel> dialog,
- you can modify the <emphasis>alias</emphasis>
- and the <emphasis>group</emphasis> of the contact.
- </para>
- <para>
- <note>
- <para>
- An <emphasis>alias</emphasis> is an alternative way you
- can identify that particular contact. You can use the real
- name or the nickname of that person.
- </para>
- </note>
- </para>
- <para>
- For more information about groups, see <xref
- linkend="empathy-add-contact-group"/> and <xref
- linkend="empathy-add-group"/>.
- </para>
- </sect2>
-
- <sect2 id="empathy-add-contact-group">
- <title>Adding a Contact to a Group</title>
- <para>
- To add a contact to one or more groups, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main
- window</link>, select the contact you would like
- to modify and choose <menuchoice>
- <guimenu>Edit</guimenu>
- <guisubmenu>Contact</guisubmenu>
- <guimenuitem>Edit</guimenuitem>
- </menuchoice>, or right-click on it
- and choose <guilabel>Edit</guilabel>.
- </para>
- </listitem>
- <listitem>
- <para>
- From the <guilabel>Groups</guilabel> section, select the
- group, or groups, you want to add the contact to.
- </para>
- </listitem>
- <listitem>
- <para>
- When done, click <guibutton>Close</guibutton>.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </sect2>
-
- <sect2 id="empathy-add-group">
- <title>Adding a New Group</title>
- <para>
- To add a new group, proceed as follows:
- </para>
- <para>
- <orderedlist>
- <listitem>
- <para>
- From the <link linkend="empathy-FIG-mainwindow">main
- window</link>, select one contact and choose <menuchoice>
- <guimenu>Edit</guimenu>
- <guisubmenu>Contact</guisubmenu>
- <guimenuitem>Edit</guimenuitem>
- </menuchoice>, or right-click on it
- and choose <guilabel>Edit</guilabel>.
- </para>
- </listitem>
- <listitem>
- <para>
- In the <guilabel>Groups</guilabel> section, write the
- name of the group you want to add and then click on
- <guibutton>Add Group</guibutton>.
- </para>
- </listitem>
- <listitem>
- <para>
- When done, click <guibutton>Close</guibutton>.
- </para>
- </listitem>
- </orderedlist>
- </para>
- </sect2>
- </sect1>
-
-<!--
- <sect1 id="empathy-send-receive-message">
- <title>Sending and Receiving Messages</title>
- <para>
- </para>
- </sect1>
-
- <sect1 id="empathy-preferences">
- <title>Preferences</title>
- <para>
- </para>
- </sect1>
--->
-
-</article>
projects / empathy.git / commitdiff