diff options
Diffstat (limited to 'help/C')
48 files changed, 2989 insertions, 1471 deletions
diff --git a/help/C/add-account.page b/help/C/add-account.page new file mode 100644 index 000000000..5821a856c --- /dev/null +++ b/help/C/add-account.page @@ -0,0 +1,96 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="add-account"> + + <info> + <link type="guide" xref="index#accounts"/> + <link type="seealso" xref="remove-account"/> + <desc>Add a new account to <app>Empathy</app>.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-24" status="draft"/> + <revision pkgversion="2.28" version="0.1" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Add a new account</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Press <key>F4</key>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq>. + </p> + </item> + </list> + </item> + <item> + <p> + If it is the first time you launch <app>Empathy</app>: + </p> + <list> + <item> + <p> + From the <gui>Type</gui> drop-down list choose + the service you wish to add an account for, then click + on the <gui>Create</gui> button. + </p> + </item> + </list> + <p> + Otherwise: + </p> + <steps> + <item> + <p> + Click on the <gui>Add</gui> button. + </p> + </item> + <item> + <p> + From the <gui>Type</gui> drop-down list choose + the service you wish to add an account for, then click + on the <gui>Create</gui> button. + </p> + </item> + </steps> + </item> + <item> + <p> + Fill the required fields with your <em>user + name</em> and <em>password</em>. + </p> + </item> + <item> + <p> + To enable the new account, select the + <gui>Enabled</gui> check-box next to + the name of the account in the box on the left of the dialog. + </p> + </item> + </steps> + + <note style="tip"> + <p> + If you want to change the name that identifies the account in the <gui>Accounts</gui> + dialog, double-click on the name of the account in the box on the left of the dialog + and type the new name. + </p> + </note> + +</page> diff --git a/help/C/add-contact.page b/help/C/add-contact.page new file mode 100644 index 000000000..14d49a57a --- /dev/null +++ b/help/C/add-contact.page @@ -0,0 +1,63 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="add-contact"> + + <info> + <link type="guide" xref="index#accounts"/> + <link type="seealso" xref="offline-contacts"/> + <desc>Add someone to the contact list.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-15" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Add someone to your list of contacts</title> + + <steps> + <item> + <p> + Choose <guiseq><gui>Chat</gui><gui>Add Contact</gui></guiseq>. + </p> + </item> + <item> + <p> + From the <gui>Account</gui> drop-down list, select the type of + service the person you want to add to your contacts is using. + </p> + </item> + <item> + <p> + In the <gui>Identifier</gui> text box, type the email address + or the username of the person you want to add to your + contacts list. + </p> + </item> + <item> + <p> + In the <gui>Alias</gui> text box, type their name. + </p> + </item> + <item> + <p> + Click <gui>Add</gui> to add the person to your list of + contacts. + </p> + </item> + </steps> + + <note> + <p> + To add a new person to your list of contacts, you need to be + connected to the Internet and to your account. + </p> + </note> + +</page> diff --git a/help/C/audio-call.page b/help/C/audio-call.page new file mode 100644 index 000000000..8c18b9453 --- /dev/null +++ b/help/C/audio-call.page @@ -0,0 +1,67 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="audio-call"> + + <info> + <link type="guide" xref="index#audio-video"/> + <link type="seealso" xref="audio-video"/> + <desc> + Start an audio conversation with one of your contacts. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="stub"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-07" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Start an audio conversation</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Select the contact you want to have a conversation with, and click + on the audio call icon next to their name. + </p> + </item> + <item> + <p> + Right-click on the name of the contact you want to have a conversation with, and + select <gui>Audio Call</gui>. + </p> + </item> + </list> + </item> + <item> + <p> + A new window will open. When the connection is established, you will + see written, at the bottom of the window, <gui>Connected</gui> and the total + conversation time. + </p> + </item> + <item> + <p> + To close the conversation, click on <gui>Hang up</gui>. + </p> + </item> + </steps> + <note style="tip"> + <p> + To turn an audio conversation into a video one, from the call window select + <guiseq><gui>Call</gui><gui>Send video</gui></guiseq>, + or click on the video call icon. + </p> + </note> + +</page> diff --git a/help/C/audio-video.page b/help/C/audio-video.page new file mode 100644 index 000000000..cef06e126 --- /dev/null +++ b/help/C/audio-video.page @@ -0,0 +1,148 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="audio-video"> + + <info> + <link type="guide" xref="index#audio-video"/> + <desc> + When it is possible to have an audio or video conversation. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="draft"/> + <revision pkgversion="2.28" version="0.1" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Audio and video conversations</title> + + <p> + When your contacts support audio or video conversations, you will see, next to + the contacts name in the <gui>Contact List</gui> window, one or two small icons that + represent the different conversations you can have. + </p> + + <table frame="all" rules="cols" shade="rows"> + <thead> + <tr> + <td> + <p> + Icon + </p> + </td> + <td> + <p> + Description + </p> + </td> + </tr> + </thead> + <tbody> + <tr> + <td> + <p> + <media type="image" mime="image/png" src="figures/audio-input-microphone.png"> + Icon for audio conversation + </media> + </p> + </td> + <td> + <p> + This is the icon that represents the possibility to have an audio conversation. + </p> + </td> + </tr> + <tr> + <td> + <p> + <media type="image" mime="image/png" src="figures/camera-web.png"> + Icon for video conversation + </media> + </p> + </td> + <td> + <p> + This is the icon that represents the possibility to have a video conversation. + </p> + </td> + </tr> + </tbody> + </table> + + <note> + <p> + In order to have a video conversation, you need to have a web-cam that is + supported by your operating system, and a working microphone. + </p> + <p> + In order to have an audio conversation, you need to have a sound-card that is + supported by your operating system, and a working microphone. + </p> + </note> + + <section id="supported-services"> + + <title>Supported services</title> + + <table frame="all" rules="cols" shade="rows"> + <thead> + <tr> + <td><p> + Protocol / Service + </p></td> + <td><p> + Video conversations + </p></td> + <td><p> + Audio conversations + </p></td> + </tr> + </thead> + <tbody> + <tr> + <td><p>AIM</p></td> + <td><p>No</p></td> + <td><p>No</p></td> + </tr> + <tr> + <td><p>Google Talk</p></td> + <td><p>Yes</p></td> + <td><p>Yes</p></td> + </tr> + <tr> + <td><p>ICQ</p></td> + <td><p>No</p></td> + <td><p>No</p></td> + </tr> + <tr> + <td><p>Jabber</p></td> + <td><p>Yes</p></td> + <td><p>Yes</p></td> + </tr> + <tr> + <td><p>MSN</p></td> + <td><p>No</p></td> + <td><p>No</p></td> + </tr> + <tr> + <td><p>Salut</p></td> + <td><p>No</p></td> + <td><p>No</p></td> + </tr> + <tr> + <td><p>Yahoo!</p></td> + <td><p>No</p></td> + <td><p>No</p></td> + </tr> + </tbody> + </table> + + </section> + +</page> diff --git a/help/C/change-status.page b/help/C/change-status.page new file mode 100644 index 000000000..a2e687ffc --- /dev/null +++ b/help/C/change-status.page @@ -0,0 +1,51 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="change-status"> + + <info> + <link type="guide" xref="index#accounts"/> + <link type="seealso" xref="status-icons"/> + <desc> + Change your status, if you are going away from your computer for example. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-14" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Change your status</title> + + <steps> + <item> + <p> + Click on the drop-down list at the top of the <gui>Contact List</gui> window. + </p> + </item> + <item> + <p> + Select a status from the list. + </p> + </item> + </steps> + + <p> + For example, if you are busy and do not want to + be disturbed, select <gui>Busy</gui>. + </p> + + <note> + <p> + If you do not use your computer for a while, or if the screen saver is turned on, + the status will be automatically set to <gui>Away</gui>. + </p> + </note> + +</page> diff --git a/help/C/create-account.page b/help/C/create-account.page new file mode 100644 index 000000000..46f58395e --- /dev/null +++ b/help/C/create-account.page @@ -0,0 +1,137 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="create-account"> + + <info> + <link type="guide" xref="index#accounts"/> + <link type="seealso" xref="add-account"/> + <link type="seealso" xref="irc-account"/> + <desc> + Register an account with one of the supported messaging services. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-21" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-07" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Register for a new account</title> + + <p> + You can freely create an account on any of the services listed below. + Follow the instructions reported on each website on + how to register your new account. + </p> + <p> + At the end of the registration process you should have a <em>user + name</em> (or an <em>account ID</em>) and a <em>password</em> + that you will use to add the account to <app>Empathy</app>. + </p> + <p> + Click on the name of the service to visit its website. + </p> + + <section id="im-services"> + <title>Instant Messaging Services</title> + + <list> + <item> + <p> + <link href="http://dashboard.aim.com/aim">AIM</link> + </p> + </item> + <item> + <p> + <link href="http://www.google.com/talk/">Google Talk</link> + </p> + </item> + <item> + <p> + <link href="https://www.icq.com/register/">ICQ</link> + </p> + </item> + <item> + <p> + <link href="http://register.jabber.org/">Jabber</link> + </p> + <note style="tip"> + <p> + It is possible to use the automatic creation of accounts + with this service. Not all the service providers support it. + One service provider known to work is <em>jabber.org</em>, + the default one of the application. + </p> + </note> + </item> + <item> + <p> + <link href="https://accountservices.passport.net">MSN</link> + </p> + </item> + <item> + <p> + <link href="https://login.yahoo.com/config/login">Yahoo!</link> + </p> + </item> + </list> + </section> + + <section id="local-service"> + <title>Local Instant Messaging Services</title> + <p> + This service works when you are connected to a local network, + you do not need an Internet connection in order to use it. + </p> + <list> + <item> + <p> + <em>Salut</em> + </p> + </item> + </list> + + <p> + For more information, see <link xref="salut-protocol" />. + </p> + + </section> + + <section id ="sip-services"> + <title>Telephony Services</title> + + <p> + These services will let you do voice call over the Internet with + other people using the same service or even to normal phones. + </p> + + <list> + <item> + <p> + <link href="https://www.ekiga.net/index.php?page=register">Ekiga</link> + </p> + </item> + <item> + <p> + <link href="https://signup.sipphone.com/new-users/app?class=NewUser;proc=start">Sipphone</link> + </p> + </item> + </list> + + <note> + <p> + In order to call normal phones over the Internet, you may need + to subscribe to a paid service. For more information, please + refer to the instructions provided on the website of the + service you will use. + </p> + </note> + + </section> +</page> diff --git a/help/C/disable-account.page b/help/C/disable-account.page new file mode 100644 index 000000000..2ded8067a --- /dev/null +++ b/help/C/disable-account.page @@ -0,0 +1,66 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="disable-account"> + + <info> + <link type="guide" xref="index#accounts"/> + <link type="seealso" xref="remove-account"/> + <desc> + Prevent an account from logging-in automatically when you start + <app>Empathy</app>. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-14" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Disable an account</title> + + <p> + Disabling an account means to deactivate it, temporarily or + permanently. All the conversations you had will be kept in your computer. + </p> + <p> + After disabling an account, it is possible to enable it again. + </p> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Press <key>F4</key>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq>. + </p> + </item> + </list> + </item> + <item> + <p> + Select the account you wish to disable from the box on the + left of the dialog. + </p> + </item> + <item> + <p> + Deselect the <gui>Enabled</gui> check-box. + </p> + </item> + </steps> + +</page> diff --git a/help/C/empathy.xml b/help/C/empathy.xml deleted file mode 100644 index e6a1a7282..000000000 --- a/help/C/empathy.xml +++ /dev/null @@ -1,1395 +0,0 @@ -<?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> diff --git a/help/C/favorite-rooms.page b/help/C/favorite-rooms.page new file mode 100644 index 000000000..747c09d66 --- /dev/null +++ b/help/C/favorite-rooms.page @@ -0,0 +1,135 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="favorite-rooms"> + + <info> + <link type="guide" xref="index#text-conv"/> + <link type="guide" xref="irc-manage#manage"/> + <link type="seealso" xref="irc-join-room"/> + <link type="seealso" xref="group-conversations"/> + <desc>Set, join and manage favorite rooms.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-21" status="draft"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Favorite rooms</title> + + <section id="set-favorite"> + <title>Set a room as a favorite</title> + <steps> + <item> + <p> + Join a room. + </p> + <list> + <item> + <p> + See <link xref="irc-join-room"/> for more information on how to join + an IRC room. + </p> + </item> + <item> + <p> + See <link xref="group-conversations"/> for more information on how to + start or join a group conversation. + </p> + </item> + </list> + </item> + <item> + <p> + From the conversation window, choose + <guiseq><gui>Conversation</gui><gui>Favorite Chatroom</gui></guiseq>. + </p> + </item> + </steps> + </section> + + <section id="join-favorite"> + <title>Join favorite rooms</title> + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Press <key>F5</key>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Room</gui><gui>Join Favorites</gui></guiseq>, to + join all your favorite rooms. + </p> + </item> + <item> + <p> + Choose <gui>Room</gui>, and select the favorite room you want to join. + </p> + </item> + </list> + </item> + </steps> + <note> + <p> + To join a favorite room, you need to be connected to the Internet and to + your account. + </p> + </note> + </section> + + <section id="manage-favorite"> + <title>Manage favorite rooms</title> + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, choose + <guiseq><gui>Room</gui><gui>Manage Favorites</gui></guiseq>. + </p> + </item> + <item> + <p> + From the <gui>Account</gui> drop-down list, select the account you want to + manage the favorite rooms of. + </p> + <p> + Select <gui>All</gui> to see all you favorite rooms. + </p> + </item> + <item> + <p> + Select the favorite room you want to manage: + </p> + <list> + <item> + <p> + Select the <gui>Auto-Connect</gui> check-box in order to automatically + join that room when you connect to your account. + </p> + </item> + <item> + <p> + Click on <gui>Remove</gui> to remove the room from your favorites. + </p> + </item> + </list> + </item> + <item> + <p> + When done, click <gui>Close</gui>. + </p> + </item> + </steps> + </section> + +</page> diff --git a/help/C/figures/audio-input-microphone.png b/help/C/figures/audio-input-microphone.png Binary files differnew file mode 100644 index 000000000..f45d15d56 --- /dev/null +++ b/help/C/figures/audio-input-microphone.png diff --git a/help/C/figures/available.png b/help/C/figures/available.png Binary files differnew file mode 100644 index 000000000..66b24967a --- /dev/null +++ b/help/C/figures/available.png diff --git a/help/C/figures/away.png b/help/C/figures/away.png Binary files differnew file mode 100644 index 000000000..ff59e309d --- /dev/null +++ b/help/C/figures/away.png diff --git a/help/C/figures/busy.png b/help/C/figures/busy.png Binary files differnew file mode 100644 index 000000000..fec554d89 --- /dev/null +++ b/help/C/figures/busy.png diff --git a/help/C/figures/camera-web.png b/help/C/figures/camera-web.png Binary files differnew file mode 100644 index 000000000..e5406c5b9 --- /dev/null +++ b/help/C/figures/camera-web.png diff --git a/help/C/figures/empathy-main-window.png b/help/C/figures/empathy-main-window.png Binary files differindex 12a6a33fc..bb803442f 100644 --- a/help/C/figures/empathy-main-window.png +++ b/help/C/figures/empathy-main-window.png diff --git a/help/C/geolocation-not-showing.page b/help/C/geolocation-not-showing.page new file mode 100644 index 000000000..845f7e74b --- /dev/null +++ b/help/C/geolocation-not-showing.page @@ -0,0 +1,37 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="geolocation-not-showing"> + + <info> + <link type="guide" xref="geolocation#problems"/> + <desc> + <app>Empathy</app> does not publish my geographical position. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-19" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Geographical position not published</title> + + <p> + If your contacts cannot see your location, <app>Empathy</app> might not be able + to discover with a good margin of precision your geographical position. + </p> + <p> + In this case, your position will not be published, but you are still able to + see the location of your contacts. + </p> + <p> + If you want to publish your geographical position, you can try to use an + external device such as a GPS. + </p> + +</page> diff --git a/help/C/geolocation-privacy.page b/help/C/geolocation-privacy.page new file mode 100644 index 000000000..23694e2b7 --- /dev/null +++ b/help/C/geolocation-privacy.page @@ -0,0 +1,89 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="geolocation-privacy"> + + <info> + <link type="guide" xref="geolocation#geoloc"/> + <desc> + What information are sent and to who. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-19" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Geolocation privacy</title> + + <section id="info-sent"> + <title>What are the information sent</title> + <p> + What is possible to send is: your country, region, locality, area, street, building, + floor, room, and postal code, longitude, latitude and altitude, speed and bearing. + </p> + <p> + The accuracy and the quantity of information about your geographical position are based + on the software or on the infrastructure used to discover your position. + </p> + <p> + Different kind of networks may have different accuracy settings, and may send + different information. The use of external devices such as GPS or mobile phone + will increase the accuracy of the information sent. + </p> + <p> + When the privacy mode is enabled, nothing more precise than your city will be + sent, even if you are using an external device. + </p> + </section> + + <section id="see-info"> + <title>Who can see the information sent</title> + <p> + Only your contacts can see your geographical position. + </p> + </section> + + <section id="privacy-mode"> + <title>What is the privacy mode</title> + <p> + The privacy mode, enabled by default, is a reduced accuracy mode that will + decrease the accuracy of the geographical position sent to your contacts. + </p> + </section> + + <section id="privacy-overview"> + <title>Privacy overview</title> + <p> + Overview of the various geolocation privacy settings in <app>Empathy</app>. + </p> + <list> + <item> + <p> + Geolocation is not enabled by default. + </p> + </item> + <item> + <p> + Privacy mode is enabled by default. + </p> + </item> + <item> + <p> + Privacy mode prevails even when using external and more precise devices. + </p> + </item> + <item> + <p> + Only your contacts can see your position. + </p> + </item> + </list> + </section> + +</page> diff --git a/help/C/geolocation-supported.page b/help/C/geolocation-supported.page new file mode 100644 index 000000000..f67b43755 --- /dev/null +++ b/help/C/geolocation-supported.page @@ -0,0 +1,47 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="geolocation-supported"> + + <info> + <desc> + Services that supports geolocation and compatibility. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-19" status="draft"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Supported services</title> + + <p> + The geolocation feature at the moment is compatible only with the Jabber service. + In order to use it, you and your contacts need to have a Jabber account. + </p> + + <note> + <p> + It is necessary that also the server you are using supports the geolocation + feature. Most of the Jabber servers support it. See your service website + documentation for more information. + </p> + </note> + + <section id="compatibility"> + <title>Compatibility</title> + + <p> + <app>Empathy</app> geolocation feature is not compatible with other geographical + position services such as <em>Google Latitude</em>, <em>Yahoo Fire Eagle</em> + or <em>Brightkite</em>. + </p> + + </section> + +</page> diff --git a/help/C/geolocation-turn.page b/help/C/geolocation-turn.page new file mode 100644 index 000000000..6c01be90b --- /dev/null +++ b/help/C/geolocation-turn.page @@ -0,0 +1,59 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="geolocation-turn"> + + <info> + <link type="guide" xref="geolocation#geoloc"/> + <link type="seealso" xref="geolocation-privacy"/> + <desc> + How to activate and deactivate geolocation in <app>Empathy</app>. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-19" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Activate/Deactivate geolocation</title> + + <steps> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>. + </p> + </item> + <item> + <p> + Select the <gui>Location</gui> tab. + </p> + </item> + <item> + <p> + Select <gui>Publish location to my contacts</gui> to activate geolocation. + </p> + <p> + To deactivate geolocation, deselect it. + </p> + </item> + <item> + <p> + To increase the accuracy of your position, deselect + <gui>Reduce location accuracy</gui>. + </p> + </item> + <item> + <p> + If you have an external device like a GPS or want to send a more accurate + position, select the appropriate option in the <gui>Geoclue Settings</gui> + section. + </p> + </item> + </steps> + +</page> diff --git a/help/C/geolocation-what-is.page b/help/C/geolocation-what-is.page new file mode 100644 index 000000000..77fcff8dd --- /dev/null +++ b/help/C/geolocation-what-is.page @@ -0,0 +1,58 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="geolocation-what-is"> + + <info> + <link type="guide" xref="geolocation#geoloc"/> + <link type="seealso" xref="geolocation-supported"/> + <desc> + Understanding geolocation. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-19" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>What is geolocation</title> + + <p> + With <em>geolocation</em> it is intended the possibility to identify the real + geographical position of a computer or a device connected to the Internet. + </p> + <p> + With geolocation in <app>Empathy</app> you can: + </p> + <list> + <item> + <p> + Publish your geographical position to your contacts. + </p> + </item> + <item> + <p> + See your contacts geographical position and quickly contact them. + </p> + </item> + <item> + <p> + Set the accuracy of your position and the device used to discover your + position. + </p> + </item> + </list> + + <note style="tip"> + <p> + In order to see your contacts geographical position, they need to use a + service and an application that support geolocation. + </p> + </note> + +</page> diff --git a/help/C/geolocation.page b/help/C/geolocation.page new file mode 100644 index 000000000..409d22f49 --- /dev/null +++ b/help/C/geolocation.page @@ -0,0 +1,33 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="geolocation" + style="2colum"> + + <info> + <link type="guide" xref="index#advanced"/> + <desc> + Use and understand geolocation in <app>Empathy</app>. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-19" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Geographical position</title> + + <section id="geoloc" style="2column"> + <title>Geolocation</title> + </section> + + <section id="problems" style="2column"> + <title>Fix common problems</title> + </section> + +</page> diff --git a/help/C/group-conversations.page b/help/C/group-conversations.page new file mode 100644 index 000000000..fcc0b4365 --- /dev/null +++ b/help/C/group-conversations.page @@ -0,0 +1,140 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="group-conversations"> + + <info> + <link type="guide" xref="index#text-conv"/> + <desc> + Start or join a group conversation with your contacts. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="stub"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-17" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-17" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Group conversations</title> + + <p> + Group conversations permits you to have text conversations with more than one + contact at the same time. + </p> + <p> + To have a group conversation you need to have a registered account with either + Jabber or Google Talk, or a Salut account. + </p> + + <note> + <p> + You can have a group conversation only with the contacts that are using the + same service as yours. + </p> + </note> + + <section id="start-group-conv"> + + <title>Start a group conversation</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, choose <guiseq><gui>Room</gui><gui>Join</gui></guiseq>. + </p> + </item> + <item> + <p> + From the <gui>Account</gui> drop-down list, select the account you want to use + for the group conversation. + </p> + </item> + <item> + <p> + In the <gui>Server</gui> text box, type the name of server in which the conversation + will be hosted. + </p> + <p> + Leave it empty if it will be on the current server. + </p> + </item> + <item> + <p> + In the <gui>Room</gui> text box, type the name you want to give to the conversation. + </p> + <note> + <p> + This will be the name of the room you are going to have a conversation. This + name will be publicly available for other people to join. It is not possible + to create a private room. + </p> + </note> + </item> + <item> + <p> + To invite other contacts to join the group conversation, from the + <gui>Contact List</gui> window, select the contact you want to invite, + and perform one of the following: + </p> + <list> + <item> + <p> + Right-click on the contact, and select <gui>Invite to chatroom</gui>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Contact</gui><gui>Invite to chatroom</gui></guiseq>. + </p> + </item> + </list> + <p> + If you have more than one group conversation open, select the one you want to invite + your contacts. + </p> + </item> + </steps> + + </section> + + <section id="join-group-conv"> + + <title>Join a group conversation</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, choose + <guiseq><gui>Room</gui><gui>Join</gui></guiseq>. + </p> + </item> + <item> + <p> + Expand the <gui>Room List</gui> section to see all the existing rooms. + </p> + </item> + <item> + <p> + Double-click on the name of a room to join it. + </p> + </item> + </steps> + + <p> + It is not possible to join all existing rooms. Some of the rooms might require a + password, or might be invitation only. <app>Empathy</app> does not support these + kind of rooms. + </p> + + <!-- TODO: find out where the password protected or invitation only icons are + and create a table. --> + + </section> + +</page> diff --git a/help/C/index.page b/help/C/index.page new file mode 100644 index 000000000..a57596560 --- /dev/null +++ b/help/C/index.page @@ -0,0 +1,42 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + style="2column" + id="index"> + + <info> + <revision pkgversion="2.28" version="0.1" date="2009-06-14" status="incomplete"/> + <revision pkgversion="2.28" version="0.1" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Empathy Instant Messenger</title> + + <section id="audio-video" style="2column"> + <title>Audio and video conversations</title> + </section> + + <section id="text-conv" style="2column"> + <title>Text conversations</title> + </section> + + <section id="accounts" style="2column"> + <title>Manage accounts</title> + </section> + + <section id="advanced" style="2column"> + <title>Advanced actions</title> + </section> + + <section id="problems" style="2column"> + <title>Fix common problems</title> + </section> + +</page> diff --git a/help/C/introduction.page b/help/C/introduction.page new file mode 100644 index 000000000..23255b7b1 --- /dev/null +++ b/help/C/introduction.page @@ -0,0 +1,46 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="introduction"> + + <info> + <link type="guide" xref="index"/> + <revision pkgversion="2.28" version="0.1" date="2009-08-16" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-17" status="review"/> + <desc> + Introduction to the <app>Empathy</app> instant messenger. + </desc> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Introduction</title> + + <p> + <app>Empathy</app> is an instant messaging application for the GNOME Desktop. + It supports text messaging, voice & video call, file transfers and all the + most used messaging systems such as MSN and Google Talk. + </p> + <p> + <app>Empathy</app> includes features that help you better collaborate while at work, + and that let you easily keep in touch with your friends. + </p> + <p> + You can group all the conversations in a single window, or have multiple windows for + different kind of conversations; easily search through your previous conversations, and + share your desktop in just two clicks. + </p> + + <p> + <media type="image" src="figures/empathy-main-window.png" mime="image/png" style="right"> + <app>Empathy</app> main window. + </media> + </p> + +</page> diff --git a/help/C/irc-account.page b/help/C/irc-account.page new file mode 100644 index 000000000..dd43fbb97 --- /dev/null +++ b/help/C/irc-account.page @@ -0,0 +1,128 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="irc-account"> + + <info> + <link type="guide" xref="index#accounts"/> + <link type="seealso" xref="prob-conn-neterror"/> + <link type="seealso" xref="prob-conn-name"/> + <desc>Create an IRC account.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-07-25" status="draft"/> + <revision pkgversion="2.28" version="0.1" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Create an IRC account</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Press <key>F4</key>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq>. + </p> + </item> + </list> + </item> + <item> + <p> + If it is the first time you launch <app>Empathy</app>: + </p> + <list> + <item> + <p> + From the <gui>Type</gui> drop-down list choose + <gui>IRC</gui>, then click on the <gui>Create</gui> button. + </p> + </item> + </list> + <p> + Otherwise: + </p> + <steps> + <item> + <p> + Click on the <gui>Add</gui> button. + </p> + </item> + <item> + <p> + From the <gui>Type</gui> drop-down list choose + <gui>IRC</gui>, then click on the <gui>Create</gui> button. + </p> + </item> + </steps> + </item> + <item> + <p> + From the <gui>Network</gui> drop-down list, select the name of the network + you are creating the account for. + </p> + </item> + <item> + <!-- TODO: rethink the description of the nickname --> + <p> + In the <gui>Nickname</gui> text box, type the name that will identify yourself + in the network you are creating the account. + </p> + </item> + <item> + <p> + In the <gui>Password</gui> text box, type the password you used to register + your nikcname. If you do not have one, leave this field blank. + </p> + </item> + <item> + <p> + In the <gui>Real name</gui> text box, type your real name. + </p> + <note> + <p> + It is not necessary to insert your real name. + </p> + </note> + </item> + <item> + <p> + In the <gui>Quit message</gui> text box, type a text message that will be + sent when you close your session. + </p> + </item> + <item> + <p> + To enable the new account, select the <gui>Enabled</gui> check-box + next to the name of the account in the box on the left of the dialog. + </p> + </item> + </steps> + + <p> + If you want to change the name that identifies the account in the <gui>Accounts</gui> + dialog, double-click on the name of the account in the box on the left of the dialog + and type the new name. + </p> + + <note style="tip"> + <p> + If you want to use different networks at the same time, you need to create an + account with each one of the networks you want to use. + </p> + </note> + +</page> diff --git a/help/C/irc-join-pwd.page b/help/C/irc-join-pwd.page new file mode 100644 index 000000000..67de473bd --- /dev/null +++ b/help/C/irc-join-pwd.page @@ -0,0 +1,27 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="irc-join-pwd"> + + <info> + <link type="guide" xref="irc-manage#manage"/> + <link type="seealso" xref="irc-join-room"/> + <desc>Join a password protected room.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-07" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Join a protected room</title> + + <p> + At the moment it is not possible to join a password protected room. + </p> + +</page> diff --git a/help/C/irc-join-room.page b/help/C/irc-join-room.page new file mode 100644 index 000000000..8461b1de1 --- /dev/null +++ b/help/C/irc-join-room.page @@ -0,0 +1,54 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="irc-join-room"> + + <info> + <link type="guide" xref="irc-manage#manage"/> + <desc>Join an IRC channel.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-07-26" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Join a room</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, choose + <guiseq><gui>Room</gui><gui>Join</gui></guiseq>. + </p> + </item> + <item> + <p> + From the <gui>Account</gui> drop-down list, select the IRC account that + corresponds to the network you want to use. + </p> + </item> + <item> + <p> + In the <gui>Room</gui> text box, type the name of the channel you want to + join. Prefix the name with the hash character (<sys>#</sys>). + </p> + </item> + <item> + <p> + Click on <gui>Join</gui> to enter the room. + </p> + </item> + </steps> + + <note style="tip"> + <p> + To join multiple rooms, you need to repeat the steps above for each room. + </p> + </note> +</page> diff --git a/help/C/irc-manage.page b/help/C/irc-manage.page new file mode 100644 index 000000000..07b6163f0 --- /dev/null +++ b/help/C/irc-manage.page @@ -0,0 +1,33 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="irc-manage"> + + <info> + <link type="guide" xref="index#text-conv"/> + <link type="seealso" xref="irc-account"/> + <desc>How to use IRC with <app>Empathy</app>.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-07-25" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Use IRC</title> + + <section id="manage" style="2column"> + <title>IRC rooms and conversations</title> + </section> + + <section id="problems" style="2column"> + <title>Fix common problems</title> + </section> + + +</page> diff --git a/help/C/irc-nick-password.page b/help/C/irc-nick-password.page new file mode 100644 index 000000000..63cdd0965 --- /dev/null +++ b/help/C/irc-nick-password.page @@ -0,0 +1,96 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="irc-nick-password"> + + <info> + <link type="guide" xref="irc-manage#manage"/> + <link type="seealso" xref="prob-conn-name"/> + <desc>How to set the password of a nickname.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-07-26" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Set the nickname password</title> + + <p> + Registering a nickname is useful to preserve your identity on IRC, and to be able + to use always the same nickname. In some cirtumstances, some IRC channels may be + configured to accept only registered nickname. + </p> + + <p> + If you have registered your nickname with a password on a network that supports nickname + registration, you can use that password with <app>Empathy</app> to identify yourself as + the owner of that nickname. + </p> + + <note> + <p> + Not all the IRC servers support nickname registration. + </p> + </note> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Press <key>F4</key>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq>. + </p> + </item> + </list> + </item> + <item> + <p> + Select the IRC account from the box on the left of the dialog. + </p> + </item> + <item> + <p> + If the account is enabled, disable it by deselecting the <gui>Enable</gui> + check-box next to the name of the account. + </p> + </item> + <item> + <p> + In the <gui>Password</gui> text box, type the password you used to register + your nikcname. + </p> + </item> + <item> + <p> + Enable the account by selecting the <gui>Enabled</gui> check-box + next to the name of the account. + </p> + <p> + Once connected, you will receive a message from the nickname server that will + tell you of the established identification. + </p> + </item> + </steps> + + <note> + <p> + At the moment it is not possible to register an IRC nickname with <app>Empathy</app>, it is + only possible to use the password of an already registered nickname. + </p> + </note> + +</page> diff --git a/help/C/irc-sending-file.page b/help/C/irc-sending-file.page new file mode 100644 index 000000000..804efa9fa --- /dev/null +++ b/help/C/irc-sending-file.page @@ -0,0 +1,27 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="irc-send-file"> + + <info> + <link type="guide" xref="irc-manage#manage"/> + <link type="seealso" xref="send-file"/> + <desc>Send a file from your computer to one of the IRC contacts.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Send files</title> + + <p> + At the moment it is not possible to send files using IRC. + </p> + +</page> diff --git a/help/C/irc-start-conversation.page b/help/C/irc-start-conversation.page new file mode 100644 index 000000000..0f73bdad6 --- /dev/null +++ b/help/C/irc-start-conversation.page @@ -0,0 +1,62 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="irc-start-conversation"> + + <info> + <link type="guide" xref="irc-manage#manage"/> + <desc>Start a conversation witn an IRC contact.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Start a conversation</title> + + <steps> + <item> + <p> + To start a private conversation with one of the IRC contacts that + are in a room, after you joined a room, from the IRC room contact list perform + one of the following: + </p> + <list> + <item> + <p> + Double-click the name of contact you want to have a conversation with. + </p> + </item> + <item> + <p> + Right-click on the name of the contact you want to have a conversation with, + and select <gui>Chat</gui>. + </p> + </item> + </list> + </item> + </steps> + + <list> + <item> + <p> + The IRC room contact list is not the same as <app>Empathy</app> <gui>Contact List</gui>, + and is relative only to the IRC room you joined. Different rooms can have different + contacts listed. + </p> + </item> + <item> + <p> + The IRC room contact list is usually on the right side of the IRC room window. If you + do not see it, choose + <guiseq><gui>Conversation</gui><gui>Show Contact List</gui></guiseq>. + </p> + </item> + </list> + +</page> diff --git a/help/C/legal.xml b/help/C/legal.xml index ac97e1de4..86d6173ad 100644 --- a/help/C/legal.xml +++ b/help/C/legal.xml @@ -1,76 +1,9 @@ - <legalnotice id="legalnotice"> - <para> - Permission is granted to copy, distribute and/or modify this - document under the terms of the GNU Free Documentation - License (GFDL), Version 1.1 or any later version published - by the Free Software Foundation with no Invariant Sections, - no Front-Cover Texts, and no Back-Cover Texts. You can find - a copy of the GFDL at this <ulink type="help" - url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS - distributed with this manual. - </para> - <para> This manual is part of a collection of GNOME manuals - distributed under the GFDL. If you want to distribute this - manual separately from the collection, you can do so by - adding a copy of the license to the manual, as described in - section 6 of the license. - </para> - - <para> - Many of the names used by companies to distinguish their - products and services are claimed as trademarks. Where those - names appear in any GNOME documentation, and the members of - the GNOME Documentation Project are made aware of those - trademarks, then the names are in capital letters or initial - capital letters. - </para> - - <para> - DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED - UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE - WITH THE FURTHER UNDERSTANDING THAT: - - <orderedlist> - <listitem> - <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, - WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR - IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES - THAT THE DOCUMENT OR MODIFIED VERSION OF THE - DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR - A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE - RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE - OF THE DOCUMENT OR MODIFIED VERSION OF THE - DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR - MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, - YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY - CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY - SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER - OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS - LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED - VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER - EXCEPT UNDER THIS DISCLAIMER; AND - </para> - </listitem> - <listitem> - <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL - THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), - CONTRACT, OR OTHERWISE, SHALL THE AUTHOR, - INITIAL WRITER, ANY CONTRIBUTOR, OR ANY - DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION - OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH - PARTIES, BE LIABLE TO ANY PERSON FOR ANY - DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR - CONSEQUENTIAL DAMAGES OF ANY CHARACTER - INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS - OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR - MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR - LOSSES ARISING OUT OF OR RELATING TO USE OF THE - DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, - EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF - THE POSSIBILITY OF SUCH DAMAGES. - </para> - </listitem> - </orderedlist> - </para> - </legalnotice> - +<license xmlns="http://projectmallard.org/1.0/" + href="http://creativecommons.org/licenses/by-sa/3.0/"> +<p>This work is licensed under a +<link href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons +Attribution-Share Alike 3.0 Unported License</link>.</p> +<p>As a special exception, the copyright holders give you permission to copy, +modify, and distribute the example code contained in this document under the +terms of your choosing, without restriction.</p> +</license> diff --git a/help/C/offline-contacts.page b/help/C/offline-contacts.page new file mode 100644 index 000000000..b3f30f6cd --- /dev/null +++ b/help/C/offline-contacts.page @@ -0,0 +1,50 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="offline-contacts"> + + <info> + <link type="guide" xref="index#accounts"/> + <desc> + How to see the contacts that are not online. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-24" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-07-21" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Display offline contacts</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Choose <guiseq><gui>View</gui><gui>Offline Contacts</gui></guiseq>. + </p> + </item> + <item> + <p> + Press <keyseq><key>Ctrl</key><key>H</key></keyseq>. + </p> + </item> + </list> + </item> + <item> + <p> + To hide the offline contacts again, repeat the same procedure above. + </p> + </item> + </steps> + +</page> diff --git a/help/C/prev-conv.page b/help/C/prev-conv.page new file mode 100644 index 000000000..b521ada59 --- /dev/null +++ b/help/C/prev-conv.page @@ -0,0 +1,153 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="prev-conv"> + + <info> + <link type="guide" xref="index#text-conv"/> + <desc> + Search your previous conversations. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-17" status="stub"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-19" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Previous conversations</title> + + <p> + <app>Empathy</app> automatically saves all your text conversations you have + with your contacts, and lets you perform two different kinds of search: a + normal text search, or a per-conversation search. + </p> + <p> + The normal search is a <em>full text</em> search: it will search the exact text in + all your previous conversations. + </p> + <p> + The per-conversation search permits you to limit the text search to a particular + contact and conversation, and permits you to look at all the previous + conversations you had with your contacts. + </p> + + <note> + <p> + You do not need to be connected to the Internet to search your previous + conversations. + </p> + </note> + + <steps> + <item> + <p> + To start searching your previous conversations, from the <gui>Contact List</gui> + window, perform one of the following: + </p> + <list> + <item> + <p> + Press <key>F3</key>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>View</gui><gui>Previous Conversations</gui></guiseq>. + </p> + </item> + </list> + </item> + <item> + <p> + Based on the kind of search you want to perform, see + <link xref="prev-conv#normal-search"/> or <link xref="prev-conv#contact-search"/> + for more information. + </p> + </item> + </steps> + + <section id="normal-search"> + <title>Normal search</title> + <steps> + <item> + <p> + Select the <gui>Search</gui> tab. + </p> + </item> + <item> + <p> + In the <gui>For</gui> text box, type the text you want to search, and click on + <gui>Find</gui>. + </p> + </item> + <item> + <p> + If there are results, they will be shown in the first pane, ordered by date. + </p> + </item> + <item> + <p> + Click on the result to see the exact text you were searching for on the + bottom pane. + </p> + <p> + The search results will be highlighted. + </p> + </item> + </steps> + </section> + + <section id="contact-search"> + <title>Conversation search</title> + <steps> + <item> + <p> + Select the <gui>Conversations</gui> tab. + </p> + </item> + <item> + <p> + From the drop-down list at the top of the window, select your account. + </p> + </item> + <item> + <p> + From the left top pane, select the contact you want to look the previous + conversations of. The previous conversations will be shown on the right pane. + </p> + <p> + By default, the last conversation you had will be shown. + </p> + <note> + <p> + Based on your account selected and the service of that account, it will + be possible to select contacts, IRC rooms or group conversations. + </p> + </note> + </item> + <item> + <p> + From the left bottom pane, you can browse your conversations by date. Based + on the contact selected, the date in which you had a conversation will + be highlighted in bold text. + </p> + </item> + <item> + <p> + To perform a text search, type the text you want to search in the text box + at the top of the window. + </p> + <p> + The search results will be highlighted. + </p> + </item> + </steps> + </section> + +</page> diff --git a/help/C/prob-conn-acctdisabled.page b/help/C/prob-conn-acctdisabled.page new file mode 100644 index 000000000..1daf61406 --- /dev/null +++ b/help/C/prob-conn-acctdisabled.page @@ -0,0 +1,67 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="prob-conn-acctdisabled"> + + <info> + <link type="guide" xref="prob-conn"/> + <desc> + The instant messaging account that you want to use is not enabled in + the list of accounts. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-17" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>My account is not enabled</title> + + <p> + If the instant messaging account that you want to use is not enabled in the + drop-down account list when you try to start a new conversation or join a + room, your account details may not be correct. + </p> + + <steps> + <item> + <p> + Make sure that you are connected to the Internet, or to a local area network. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq> and select the account + that is not working. + </p> + </item> + <item> + <p> + Type your username and password again to make sure that they are correct. + </p> + </item> + <item> + <p> + Check in the <gui>Advanced</gui> section that all the details are correct. + You should be able to find these details from the website of the messaging service. + </p> + </item> + <item> + <p> + Check that the <gui>Enabled</gui> check-box next to the name of your account is selected. + If it is not, select the check-box to enalbe the account. + </p> + </item> + </steps> + +</page> diff --git a/help/C/prob-conn-auth.page b/help/C/prob-conn-auth.page new file mode 100644 index 000000000..a0d5c187d --- /dev/null +++ b/help/C/prob-conn-auth.page @@ -0,0 +1,67 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="prob-conn-auth"> + + <info> + <link type="guide" xref="prob-conn"/> + <link type="seealso" xref="create-account"/> + <desc> + An error message which says "<gui>Authentication failed</gui>" appears + in the main window. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-17" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-07-23" status="draft"/> + <revision pkgversion="2.28" version="0.3" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>I get a message that says "Authentication failed"</title> + + <p> + This kind of error happens when your instant messaging service is not allowing + you to connect because it does not recognize your username or password for some reason. + </p> + + <steps> + <item> + <p> + Make sure that you are connected to the Internet, or to a local area network. + </p> + </item> + <item> + <p> + Make sure that you have registered an account with the service you are trying + to connect to. If you do not have an account, most services will not allow + you to connect. + </p> + </item> + <item> + <p> + Click on the <gui>Edit Account</gui> button in the error message. + </p> + </item> + <item> + <p> + Type your username and password again to make sure that they are correct. + </p> + </item> + <item> + <p> + Deselect the <gui>Enabled</gui> check-box next to the name of your account, + and then select it again to try to reconnect to the service. + </p> + </item> + </steps> +</page> diff --git a/help/C/prob-conn-name.page b/help/C/prob-conn-name.page new file mode 100644 index 000000000..3e4edd40c --- /dev/null +++ b/help/C/prob-conn-name.page @@ -0,0 +1,62 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="prob-conn-name"> + + <info> + <link type="guide" xref="prob-conn"/> + <link type="guide" xref="irc-manage#problems"/> + <desc> + An error message which says "<gui>Name in use</gui>" appears in the main window. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-07-26" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>I get a message that says "Name in use"</title> + + <p> + This kind of error happens when you try to connect to your IRC account and + you are using a nickname that is already being used by someone else on that particular + network. + </p> + + <steps> + <item> + <p> + Click on the <gui>Edit Account</gui> button in the error message. + </p> + </item> + <item> + <list> + <item> + <p> + In the <gui>Nickname</gui> text box, type a new nickname. + </p> + </item> + <item> + <p> + If you have registered that nickname within the network you are using, + set the password for that nickname. For more information, + see <link xref="irc-nick-password"/>. + </p> + </item> + </list> + </item> + <item> + <p> + Deselect the <gui>Enabled</gui> check-box next to the name of your account, + and then select it again to try to reconnect to the service. + </p> + </item> + </steps> + +</page> diff --git a/help/C/prob-conn-neterror.page b/help/C/prob-conn-neterror.page new file mode 100644 index 000000000..8001ed49b --- /dev/null +++ b/help/C/prob-conn-neterror.page @@ -0,0 +1,74 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="prob-conn-neterror"> + + <info> + <link type="guide" xref="prob-conn"/> + <link type="guide" xref="irc-manage#problems" /> + <desc> + An error message which says "<gui>Network error</gui>" appears in the main window. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-17" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>I get a message that says "Network error"</title> + + <p> + This kind of error happens when <app>Empathy</app> cannot communicate + with the instant messaging service for some reason. + </p> + <p> + Also, this kind of error happens when you try to use an IRC account without + setting a nickname. + </p> + + <steps> + <item> + <p> + Make sure that you are connected to the Internet, or to a local area network. + </p> + </item> + <item> + <p> + Click on the <gui>Edit Account</gui> button in the error message. + </p> + </item> + <item> + <list> + <item> + <p> + Check in the <gui>Advanced</gui> section that all the details are correct. + You should be able to find these details from the website of the messaging service. + </p> + </item> + <item> + <p> + In the case of an IRC account, type your nickname in the <gui>Nickname</gui> + text box. + </p> + </item> + </list> + </item> + <item> + <p> + Deselect the <gui>Enabled</gui> check-box next to the name of your account, + and then select it again to try to reconnect to the service. + </p> + </item> + </steps> + +</page> diff --git a/help/C/prob-conn.page b/help/C/prob-conn.page new file mode 100644 index 000000000..400793a7b --- /dev/null +++ b/help/C/prob-conn.page @@ -0,0 +1,26 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="prob-conn"> + + <info> + <link type="guide" xref="index#problems"/> + <desc> + Diagnose common problems connecting to an instant messaging service. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-17" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-07-26" status="draft"/> + <revision pkgversion="2.28" version="0.3" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Problems connecting to an instant messaging service</title> + +</page> diff --git a/help/C/remove-account.page b/help/C/remove-account.page new file mode 100644 index 000000000..5728b40d0 --- /dev/null +++ b/help/C/remove-account.page @@ -0,0 +1,70 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="remove-account"> + + <info> + <link type="guide" xref="index#accounts"/> + <desc>Completely remove an account from <app>Empathy</app>.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-14" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Remove an account</title> + + <p> + Removing an account means to delete it from your computer with all + the conversations you had with other people. + </p> + <p> + After removing an account you will not be able to recover it or to recover + the conversations you had. + </p> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Press <key>F4</key>. + </p> + </item> + <item> + <p> + Choose <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq>. + </p> + </item> + </list> + </item> + <item> + <p> + Select the account you wish to remove from the box on the + left of the dialog. + </p> + </item> + <item> + <p> + Click on the <gui>Remove</gui> button. + </p> + </item> + <item> + <p> + A dialog will be shown asking for confirmation. Click on + the <gui>Remove</gui> button to permanently remove the + account. + </p> + </item> + </steps> + +</page> diff --git a/help/C/salut-protocol.page b/help/C/salut-protocol.page new file mode 100644 index 000000000..176921e4c --- /dev/null +++ b/help/C/salut-protocol.page @@ -0,0 +1,43 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="salut-protocol"> + + <info> + <link type="seealso" xref="create-account"/> + <desc> + Undesrtanding the <em>Salut</em> protocol. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-12" status="draft"/> + <revision pkgversion="2.28" version="0.1" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>What is the <em>Salut</em> service?</title> + + <p> + The <em>Salut</em> service is a serverless communication service: + you do not need to connect and authenticate to a central server in + order to use it. + </p> + <p> + This kind of serverless messaging system is restricted to a local area + network and an active Internet connection is not necessary. + </p> + <p> + The people that use this service inside the same local area network + will be auto-discovered, and it will be possible to send them messages + and files as with other services. + </p> + <p> + All the modern local area networks should be able to support this kind + of service. + </p> +</page> diff --git a/help/C/send-file.page b/help/C/send-file.page new file mode 100644 index 000000000..960d0cc46 --- /dev/null +++ b/help/C/send-file.page @@ -0,0 +1,89 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="send-file"> + + <info> + <link type="guide" xref="index#advanced"/> + <desc>Send a file from your computer to one of your contacts.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-14" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-07-21" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Send files</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Right-click on the contact you want to send a file, and select <gui>Send file</gui>. + </p> + </item> + <item> + <p> + Click on the contact you want to send a file, and choose <guiseq><gui>Edit</gui> + <gui>Contact</gui><gui>Send file</gui></guiseq>. + </p> + </item> + </list> + </item> + <item> + <p> + Select the file to send, and click on <gui>Send</gui>. + </p> + </item> + <item> + <p> + The <gui>File Transfers</gui> window will appear. + </p> + <p> + Wait for your contact to accept the file transfer, or click + <gui>Stop</gui> to halt the transfer. + </p> + </item> + <item> + <p> + Once the transfer is finished, it is possible to close the <gui>File Transfers</gui> + window. + </p> + </item> + </steps> + + <note style="tip"> + <p> + If you have multiple finished transfers listed in the window, click on + <gui>Clear</gui> to empty the list. This will only remove the files from the + list and will not delete them from your computer. + </p> + </note> + <note> + <p> + It is possible to send files only using the following services: <em>Jabber</em>, + <em>Google Talk</em> and <em>Salut</em>. + </p> + </note> + <note> + <p> + In order to send a file to someone, you need to be connected to the Internet, or to + a local area network. + </p> + </note> + +</page> diff --git a/help/C/send-message.page b/help/C/send-message.page new file mode 100644 index 000000000..997236ccb --- /dev/null +++ b/help/C/send-message.page @@ -0,0 +1,51 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="send-message"> + + <info> + <link type="guide" xref="index#text-conv"/> + <desc>Send a message to one of your contacts.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-14" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Phil Bull</name> + <email>philbull@gmail.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Send a message to someone</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Double-click the name of the contact that you want to have a conversation + with. + </p> + </item> + <item> + <p> + Right-click on the name of the contact you want to have a conversation with, and + select <gui>Chat</gui>. + </p> + </item> + </list> + </item> + <item> + <p> + A new window will open. Type a message into the box at the + bottom of the window and press <key>Enter</key> to send it. + </p> + </item> + </steps> + +</page> diff --git a/help/C/set-custom-status.page b/help/C/set-custom-status.page new file mode 100644 index 000000000..6b9dabe50 --- /dev/null +++ b/help/C/set-custom-status.page @@ -0,0 +1,166 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="set-custom-status"> + + <info> + <link type="guide" xref="index#accounts"/> + <link type="seealso" xref="change-status"/> + <link type="seealso" xref="status-icons"/> + <desc> + Add, edit or delete personal messages for your status. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-06-30" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Jim Campbell</name> + <email>jwcampbell@gmail.com</email> + </credit> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Set a custom message</title> + + <p> + Sometimes you may want to set a custom message for your status, for example to let + people know that you will be unavailable for a certain period of time. + </p> + <p> + It is possible to set a custom message based on the different statuses available. + </p> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, click on the drop-down list at + the top. + </p> + </item> + <item> + <p> + Select the status you want to add a custom message to. You have to select the one + identified with the label <gui>Custom Message</gui>. + </p> + </item> + <item> + <p> + Enter your custom message in the text box at the top of the window, and + press <key>Enter</key> to set the message. + </p> + </item> + <item> + <p> + If you want to set the custom message as a favorite, saving it in order to use it + again, click on the little star on the right of the text box where you wrote your + custom message. + </p> + <p> + If you do not do it, the custom message will not be available the next time you + use <app>Empathy</app>. It will be saved only for the current session. + </p> + </item> + </steps> + + <section id="edit-custom"> + + <title>Edit, remove and add a custom message</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, click on the drop-down list at + the top. + </p> + </item> + <item> + <p> + Select <gui>Edit Custom Message</gui>. + </p> + </item> + <item> + <list> + <item> + <p> + To edit a custom message: + </p> + <steps> + <item> + <p> + From the <gui>Saved Presets</gui> box, select the status message + you want to edit and double-click on it. + </p> + </item> + <item> + <p> + Type the new custom message and press <key>Enter</key> to modify it. + </p> + </item> + </steps> + </item> + <item> + <p> + To remove a custom message: + </p> + <steps> + <item> + <p> + From the <gui>Saved Presets</gui> box, select the status message you want + to remove. + </p> + </item> + <item> + <p> + Click on the <gui>Remove</gui> button. + </p> + </item> + </steps> + </item> + <item> + <p> + To add a new custom message, from the <gui>Add New Preset</gui> section: + </p> + <steps> + <item> + <p> + Click on the drop-down list to select the status you want to set a custom + message to. + </p> + </item> + <item> + <p> + Click on the text box, and type the new custom message. + </p> + </item> + <item> + <p> + Click on <gui>Add</gui> to add the new message to the presets ones. + </p> + </item> + </steps> + </item> + </list> + </item> + <item> + <p> + When finished, click on <gui>Close</gui>. + </p> + </item> + </steps> + + <note style="tip"> + <p> + When you edit or add a new custom message, it will not be set as the current + status message. You will need to select it from the <gui>Contact List</gui> window. + </p> + </note> + + </section> + +</page> diff --git a/help/C/share-desktop.page b/help/C/share-desktop.page new file mode 100644 index 000000000..06a3d7c40 --- /dev/null +++ b/help/C/share-desktop.page @@ -0,0 +1,85 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="share-desktop"> + + <info> + <link type="guide" xref="index#advanced"/> + <desc> + Share the desktop with your contacts. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="stub"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-10" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Share your desktop</title> + + <p> + It is possible, with some of your contacts, to share your desktop with them, or to start + using your contacts desktop. You can use + this functionality to show your desktop to your contacts, to ask for help or to + help your contacts resolve a problem. + </p> + + <note style="tip"> + <p> + In order to be able to share your desktop or to remotely use your contacts desktop, + it is necessary to have a remote desktop viewer application installed in your system. + </p> + </note> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Select the contact you want to share your desktop with, and choose + <guiseq><gui>Edit</gui><gui>Contact</gui><gui>Share my desktop</gui></guiseq>. + </p> + </item> + <item> + <p> + Right-click on the name of the contact you want to share your desktop with, + and select <gui>Share my desktop</gui>. + </p> + </item> + </list> + </item> + <item> + <p> + A request will be sent to the contact you want to share your desktop with. + If they accept, the default remote desktop viewer application will be launched in + order to permit you to disconnect the user that is controlling your desktop. + </p> + <p> + For more information about how to use the remote desktop viewer application, + refer to its help. + </p> + </item> + </steps> + + <p> + When you share your desktop with someone else, it is possible to experience + system performance slowdown and low Internet speed. + </p> + + <note> + <p> + Not all your contacts might be able to support this functionality. It is necessary + for them to have at least the 2.28 version of <app>Empathy</app> and a remote desktop + viewer application installed in their system. + </p> + </note> + +</page> diff --git a/help/C/start-conversation.page b/help/C/start-conversation.page new file mode 100644 index 000000000..d7123c4e4 --- /dev/null +++ b/help/C/start-conversation.page @@ -0,0 +1,71 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="start-conversation"> + + <info> + <link type="guide" xref="index#audio-video"/> + <link type="guide" xref="index#text-conv"/> + <link type="seealso" xref="add-contact"/> + <desc>General method to start a conversation.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + + <title>Start a conversation</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Choose <guiseq><gui>Chat</gui><gui>New conversation</gui></guiseq>. + </p> + </item> + <item> + <p> + Press <keyseq><key>Ctrl</key><key>N</key></keyseq>. + </p> + </item> + </list> + </item> + <item> + <p> + From the <gui>Account</gui> drop-down list, select the account you want to + use for the conversation. + </p> + <p> + This one is one of your accounts. + </p> + </item> + <item> + <p> + In the <gui>Contact ID</gui> text box, type the identifier of the contact you want to + have a conversation with. + </p> + <p> + You have to enter the identifier as it has been inserted when adding a new contact to + your contact list. If you are trying to start a conversation using one of your IRC + accounts or a SIP account, you have to enter the exact nickname or the + exact SIP address of the contact. + </p> + </item> + <item> + <p> + To start a text conversation, click on <gui>Chat</gui>; to start + an audio conversation, click on <gui>Call</gui>. + </p> + </item> + </steps> + +</page> diff --git a/help/C/status-icons.page b/help/C/status-icons.page new file mode 100644 index 000000000..35c91e543 --- /dev/null +++ b/help/C/status-icons.page @@ -0,0 +1,97 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="status-icons"> + + <info> + <desc> + Understanding the various status icons. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-07-18" status="stub"/> + <revision pkgversion="2.28" version="0.2" date="2009-07-21" status="draft"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title>Status icons</title> + + <table frame="all" rules="cols" shade="rows"> + <thead> + <tr> + <td> + <p> + Icon + </p> + </td> + <td> + <p> + Description + </p> + </td> + </tr> + </thead> + <tbody> + <tr> + <td> + <p> + <media type="image" mime="image/png" src="figures/available.png"> + Available icon + </media> + </p> + </td> + <td> + <p> + This is the default icon for the <em>Available</em> status. + </p> + <p> + Use this icon when you are availble to have conversations with other + people. + </p> + </td> + </tr> + <tr> + <td> + <p> + <media type="image" mime="image/png" src="figures/busy.png"> + Busy icon + </media> + </p> + </td> + <td> + <p> + This is the default icon for the <em>Busy</em> status. + </p> + <p> + Use this icon when you do not want to be disturbed. + </p> + </td> + </tr> + <tr> + <td> + <p> + <media type="image" mime="image/png" src="figures/away.png"> + Away icon + </media> + </p> + </td> + <td> + <p> + This is the default icon for the <em>Away</em> status. + </p> + <p> + Use this icon when you are going away from the computer. This icon + is used also when you leave the computer and the screensaver turns on. + </p> + </td> + </tr> + </tbody> + </table> + +</page> diff --git a/help/C/video-call.page b/help/C/video-call.page new file mode 100644 index 000000000..6f918ee6e --- /dev/null +++ b/help/C/video-call.page @@ -0,0 +1,68 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" + id="video-call"> + + <info> + <link type="guide" xref="index#audio-video"/> + <link type="seealso" xref="audio-video"/> + <desc> + Start a video conversation with one of your contacts. + </desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-02" status="stub"/> + <revision pkgversion="2.28" version="0.2" date="2009-08-14" status="review"/> + <credit type="author"> + <name>Milo Casagrande</name> + <email>milo@ubuntu.com</email> + </credit> + <copyright> + <year>2009</year> + <name>GNOME Documentation Project</name> + </copyright> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/> + </info> + <title>Start a video conversation</title> + + <steps> + <item> + <p> + From the <gui>Contact List</gui> window, perform one of the following: + </p> + <list> + <item> + <p> + Select the contact you want to have a conversation with, and click + on the video call icon next to their name. + </p> + </item> + <item> + <p> + Right-click on the name of the contact you want to have a conversation with, and + select <gui>Video Call</gui>. + </p> + </item> + </list> + </item> + <item> + <p> + A new window will open. When the connection is established, you will + see written, at the bottom of the window, <gui>Connected</gui> and the total + conversation time. + </p> + </item> + <item> + <p> + To close the conversation, click on <gui>Hang up</gui>. + </p> + </item> + </steps> + <note style="tip"> + <p> + To turn a video conversation into an audio one, from the call window deselect + <guiseq><gui>Call</gui><gui>Send video</gui></guiseq>, + or click on the video call icon. + </p> + </note> + + + +</page> |
