<!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.26">
-<!ENTITY manrevision "2.1">
-<!ENTITY date "January 2009">
+<!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/">
<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>
+ <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>
- <copyright>
- <year>2008, 2009</year>
- <holder>Ubuntu 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>Ubuntu Documentation Project</publishername>
- </publisher>
+ <publisher>
+ <publishername>GNOME Documentation Project</publishername>
+ </publisher>
<!-- licence stuff -->
&legal;
- <authorgroup>
- <author role="maintainer">
- <firstname>Milo</firstname>
- <surname>Casagrande</surname>
- <affiliation>
- <orgname>Ubuntu Documentation Project</orgname>
- <address><email>milo@ubuntu.com</email></address>
- </affiliation>
+ <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>
- <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.26" role="incomplete">
+ <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>
<!-- 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>
+ <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>
+ </revdescription>
+ </revision>
<revision>
- <revnumber>Empathy Manual V2.0</revnumber>
- <date>April 2008</date>
- <revdescription>
+ <revnumber>Empathy Manual V2.0</revnumber>
+ <date>April 2008</date>
+ <revdescription>
<para role="author">Milo Casagrande
<email>milo@ubuntu.com</email>
</para>
<email>sdudenhofer@gmail.com</email>
</para>
<para role="publisher">Ubuntu Documentation Project</para>
- </revdescription>
- </revision>
+ </revdescription>
+ </revision>
</revhistory>
<releaseinfo>
<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:gnome-feedback"
- type="help">GNOME Feedback Page</ulink>.
+ this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback" type="help">GNOME Feedback Page</ulink>.
</para>
</legalnotice>
</articleinfo>
<indexterm zone="index">
- <primary>Empathy</primary>
- </indexterm>
- <indexterm zone="index">
- <primary>empathy</primary>
+ <primary>Empathy</primary>
+ </indexterm>
+ <indexterm zone="index">
+ <primary>empathy</primary>
<secondary>istant messaging</secondary>
</indexterm>
<para>Choose
<menuchoice>
<guisubmenu>Internet</guisubmenu>
- <guimenuitem>Empathy Instant Messenger</guimenuitem>
+ <guimenuitem>Empathy IM Client</guimenuitem>
</menuchoice>.
</para>
</listitem>
<listitem>
<para>
Select the account you wish to edit in the box on the
- left and double-click on it's name.
+ left and double-click on its name.
</para>
</listitem>
<listitem>
<para>
An <emphasis>alias</emphasis> is an alternative way you
can identify yourself. You can use your real
- name or your nickname.
+ name or a nickname.
</para>
</note>
</para>
<sect2 id="empathy-advanced-options">
<title>Advanced Options</title>
<para>
- TODO
+ 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>
window</link>, select the contact you would like
to modify and choose <menuchoice>
<guimenu>Edit</guimenu>
- <guisubmenu>Account</guisubmenu>
- <guimenuitem>Modify</guimenuitem>
+ <guisubmenu>Contact</guisubmenu>
+ <guimenuitem>Edit</guimenuitem>
</menuchoice>, or right-click on it
- and choose <guilabel>Modify</guilabel>.
+ and choose <guilabel>Edit</guilabel>.
</para>
</listitem>
</orderedlist>
window</link>, select the contact you would like
to modify and choose <menuchoice>
<guimenu>Edit</guimenu>
- <guisubmenu>Account</guisubmenu>
- <guimenuitem>Modify</guimenuitem>
+ <guisubmenu>Contact</guisubmenu>
+ <guimenuitem>Edit</guimenuitem>
</menuchoice>, or right-click on it
- and choose <guilabel>Modify</guilabel>.
+ and choose <guilabel>Edit</guilabel>.
</para>
</listitem>
<listitem>
From the <link linkend="empathy-FIG-mainwindow">main
window</link>, select one contact and choose <menuchoice>
<guimenu>Edit</guimenu>
- <guisubmenu>Account</guisubmenu>
- <guimenuitem>Modify</guimenuitem>
+ <guisubmenu>Contact</guisubmenu>
+ <guimenuitem>Edit</guimenuitem>
</menuchoice>, or right-click on it
- and choose <guilabel>Modify</guilabel>.
+ and choose <guilabel>Edit</guilabel>.
</para>
</listitem>
<listitem>
</sect2>
</sect1>
-
-
<!--
<sect1 id="empathy-send-receive-message">
<title>Sending and Receiving Messages</title>
projects / empathy.git / blobdiff