</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
+ 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>
<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"/>
<comment>
<cite date="2009-06-15">Phil Bull</cite>
- <p>Instructions need review, didn't test with other IM services to confirm
+ <p>Instructions need review, didn't test with other IM services to confirm
the names of the textboxes. Also, check the name of the Add button.</p>
</comment>
<revision pkgversion="2.28" version="0.2" date="2009-08-07" status="review"/>
</info>
-
+
<title>Start an audio conversation</title>
<steps>
<list>
<item>
<p>
- Select the contact you want to have a conversation with, and click
+ 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
+ Right-click on the name of the contact you want to have a conversation with, and
select <gui>Audio Call</gui>.
</p>
</item>
</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
+ 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>
</steps>
<note>
<p>
- To turn an audio conversation into a video one, from the call window select
- <guiseq><gui>Call</gui><gui>Send video</gui></guiseq>,
+ 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>
<revision pkgversion="2.28" version="0.1" date="2009-08-02" status="draft"/>
</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
+ the contacts name in the <gui>Contact List</gui> window, one or two small icons that
represent the different conversations you can have.
</p>
<title>Register for a new account</title>
<p>
- You can freely create an account on any of the services listed below.
+ 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>
These services will let you do voice call over the Internet with
- other people using the same service or even to normal phones.
+ other people using the same service or even to normal phones.
</p>
<list>
<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
+ 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"/>
</copyright>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
-
+
<title>Disable an account</title>
<p>
<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>
</copyright>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
-
+
<title>Create an IRC account</title>
<steps>
</item>
<item>
<p>
- From the <gui>Network</gui> drop-down list, select the name of the network
+ 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 <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
+ 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.
+ In the <gui>Real name</gui> text box, type your real name.
</p>
<note>
<p>
</item>
<item>
<p>
- In the <gui>Quit message</gui> text box, type a text message that will be
+ 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
+ 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
+ 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>
<p>
- If you want to use different networks at the same time, you need to create an
+ 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>
<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>
<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
+ 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
+ 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
+ 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>
</p>
</item>
</steps>
-
+
<note>
<p>
To join multiple rooms, you need to repeat the steps above for each room.
<comment>
<cite date="2009-07-25">Milo Casagrande</cite>
<p>
- Guide page for all the IRC related actions. Need to work on this page
- if the content starts to grow. In case we don't have a lot of contets for
+ Guide page for all the IRC related actions. Need to work on this page
+ if the content starts to grow. In case we don't have a lot of contets for
this page, rework the other.
</p>
</comment>
<title>Fix common problems</title>
</section>
-
+
</page>
<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 you will be able
- to use always the same nickname. In some cirtumstances, some IRC channels may be
+ Registering a nickname is useful to preserve your identity on IRC and you will 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
+ 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 the nickname.
</p>
</item>
<item>
<p>
- If the account is enabled, disable it by deselecting the <gui>Enable</gui>
+ 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
+ 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.
+ Enable the account by selecting the <gui>Enabled</gui> check-box
+ next to the name of the account.
</p>
</item>
</steps>
<p>
- Once you are connected, you will receive a message from the nickname server that will
+ Once you are connected, you will receive a message from the nickname server that will
tell you of the established identification.
</p>
<note>
<p>
- At the moment it is not possible to register an IRC nickname with <app>Empathy</app>, it is
+ 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>
<info>
<link type="guide" xref="prob-conn"/>
<desc>
- The instant messaging account that you want to use is not enabled in
+ The instant messaging account that you want to use is not enabled in
the list of accounts.
</desc>
<revision version="3.0" date="2009-06-17" status="draft"/>
<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
+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
chat, your account details may not be correct.
</p>
<list>
<item>
<p>
- Click <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq> and make sure
+ Click <guiseq><gui>Edit</gui><gui>Accounts</gui></guiseq> and make sure
that the <gui>Enabled</gui> checkbox is checked.
</p>
</item>
</item>
<item>
<p>
- Expand the <gui>Advanced</gui> section of the <app>Accounts</app>
+ Expand the <gui>Advanced</gui> section of the <app>Accounts</app>
window and make sure that all of the server settings are correct.
</p>
</item>
<link type="guide" xref="prob-conn"/>
<link type="seealso" xref="create-account"/>
<desc>
- An error message appears in the main window saying that
+ An error message appears in the main window saying that
"<gui>Authentication failed</gui>".
</desc>
<comment>
<cite date="2009-07-23">Milo Casagrande</cite>
<p>
- Could be useful to link here how to change your password or how to
+ Could be useful to link here how to change your password or how to
recover it. Need to write that section.
</p>
</comment>
<p>
- If you try to connect and you get a message saying <gui>Authentication failed</gui>,
- your instant messaging service is not allowing you to connect because it does not
+ If you try to connect and you get a message saying <gui>Authentication failed</gui>,
+ your instant messaging service is not allowing you to connect because it does not
recognize your username or password for some reason.
</p>
<list>
<item>
<p>
- Make sure that you have registered for an account with the service you
- are trying to connect to. If you do not have an account, most services
+ Make sure that you have registered for 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 the <gui>Edit Account</gui> button in the error message. Type
- your username and password again to make sure that they are correct.
- Deselect the <gui>Enabled</gui> box next to the name of your account and
+ Click the <gui>Edit Account</gui> button in the error message. Type
+ your username and password again to make sure that they are correct.
+ Deselect the <gui>Enabled</gui> box next to the name of your account and
then select it to try to connect to the service again.
</p>
</item>
<link type="guide" xref="prob-conn"/>
<link type="guide" xref="irc-manage#problems"/>
<desc>
- An error message appears in the main <app>Empathy</app> window which says
+ An error message appears in the main <app>Empathy</app> window which says
"Name in use".
</desc>
<revision pkgversion="2.28" version="0.1" date="2009-07-26" status="draft"/>
<!--
TODO: work on this page. This error appears with the IRC account
- when you set a nickname that is already in use on that network. We need
+ when you set a nickname that is already in use on that network. We need
to write topics for changing your nickname and to set the password of your
nickname.
-->
<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 being used by someone else on that particular
+ This kind of error happens when you try to connect to your IRC account and
+ you are using a nickname that is being used by someone else on that particular
network.
</p>
<p>
- To resolve this problem, click on the <gui>Edit Account</gui> button and
+ To resolve this problem, click on the <gui>Edit Account</gui> button and
perform one of the following:
</p>
-
+
<list>
<item>
<p>
</item>
<item>
<p>
- Set the password for that nickname, if you have registered that nickname
- within the network you are using. For more information,
+ Set the password for that nickname, if you have registered that nickname
+ within the network you are using. For more information,
see <link xref="irc-nick-password"/>.
</p>
</item>
- </list>
+ </list>
</page>
<link type="guide" xref="prob-conn"/>
<link type="guide" xref="irc-manage#problems" />
<desc>
- An error message appears in the main <app>Empathy</app> window which says
+ An error message appears in the main <app>Empathy</app> window which says
"Network error".
</desc>
<revision pkgversion="2.28" version="0.1" date="2009-06-17" status="draft"/>
<title>I get a message that says "Network error"</title>
<p>
-If you try to connect and an error message appears in the main Empathy
-window which says "Network error", Empathy cannot communicate with
+If you try to connect and an error message appears in the main Empathy
+window which says "Network error", Empathy cannot communicate with
the instant messaging service for some reason.
</p>
</item>
<item>
<p>
- Expand the <gui>Advanced</gui> section and make sure that the details
- such as server address and port are correct. You should be able to find
+ Expand the <gui>Advanced</gui> section and make sure that the details
+ such as server address and port are correct. You should be able to find
these details from the website of the messaging service.
</p>
</item>
<item>
<p>
- Uncheck the <gui>Enabled</gui> box next to the name of your account and
+ Uncheck the <gui>Enabled</gui> box next to the name of your account and
then check it again to try to connect to the service again.
</p>
</item>
<comment>
<cite date="2009-06-14">Phil Bull</cite>
- <p>This is a stub. We should identify the most common causes for a user not
+ <p>This is a stub. We should identify the most common causes for a user not
being able to connect and document those.</p>
</comment>
<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 version="0.1" date="2009-08-12" status="draft"/>
-
+
<credit type="author">
<name>Milo Casagrande</name>
<email>milo@ubuntu.com</email>
<year>2009</year>
<name>GNOME Documentation Project</name>
</copyright>
-
+
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
<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.
+ order to use it.
</p>
<p>
This kind of serverless messaging system is restricted to a local area
</item>
<item>
<p>
- The <gui>File Transfers</gui> window will appear. Wait for your contact to accept the
+ The <gui>File Transfers</gui> window will appear. Wait for your contact to accept the
file transfer, or click <gui>Stop</gui> to halt the transfer.
</p>
</item>
</steps>
-
+
<note>
<p>
It is possible to send files only using the following services: <em>Jabber</em>,
</note>
<p>
- If your contact accepts the file transfer, you can watch the progress of the
+ If your contact accepts the file transfer, you can watch the progress of the
transfer and see the estimated amount of time remaining before it is complete.
</p>
<p>
- If they do not accept it, the status of the transfer will change to <gui>File
+ If they do not accept it, the status of the transfer will change to <gui>File
transfer cancelled</gui>, and the file will not be sent.
</p>
<p>
- Once a transfer is finished, you can close the <gui>File Transfers</gui>
- window. 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
+ Once a transfer is finished, you can close the <gui>File Transfers</gui>
+ window. 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>
<p>
- In order to send a file to someone, you need to be connected to the Internet, or to
+ In order to send a file to someone, you need to be connected to the Internet, or to
a local area network.
</p>
</note>
<link type="guide" xref="index#text-conv"/>
<desc>Send a message to one of your contacts.</desc>
<revision version="3.0" date="2009-06-14" status="draft"/>
-
+
<credit type="author">
<name>Phil Bull</name>
<email>philbull@gmail.com</email>
<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>
<list>
<item>
<p>
- Double-click the name of the contact that you want to have a conversation
+ 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
+ Right-click on the name of the contact you want to have a conversation with, and
select <gui>Chat</gui>.
</p>
</item>
</p>
</item>
</steps>
-
+
</page>
<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"/>
<year>2009</year>
<name>GNOME Documentation Project</name>
</copyright>
-
+
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" />
</info>
</item>
<item>
<p>
- Type the new custom message and press <key>Enter</key> to modify it.
+ Type the new custom message and press <key>Enter</key> to modify it.
</p>
</item>
</steps>
this functionality to show your desktop to your contacts, to ask for help or to
help your contacts resolve a problem.
</p>
-
+
<note>
<p>
In order to be able to share your desktop or to remotely use your contacts desktop,
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
+ Use this icon when you are availble to have conversations with other
people.
</p>
</td>
</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.
+ is used also when you leave the computer and the screensaver turns on.
</p>
</td>
</tr>
<list>
<item>
<p>
- Select the contact you want to have a conversation with, and click
+ 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
+ Right-click on the name of the contact you want to have a conversation with, and
select <gui>Video Call</gui>.
</p>
</item>
</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
+ 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>
</steps>
<note>
<p>
- To turn a video conversation into an audio one, from the call window deselect
- <guiseq><gui>Call</gui><gui>Send video</gui></guiseq>,
+ 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>