From: Frédéric Péters Date: Wed, 12 Aug 2009 16:40:34 +0000 (+0200) Subject: Merge branch 'mallard-to-merge' X-Git-Url: https://git.0d.be/?p=empathy.git;a=commitdiff_plain;h=1a4735d843a9d2757d73cdce9b0c2a0a2fb9d1b1;hp=03480a1e9b3e6886bef8346c4b73d8dd93b8e238 Merge branch 'mallard-to-merge' --- diff --git a/help/.gitignore b/help/.gitignore index 2f8d8eb5..597bd8fc 100644 --- a/help/.gitignore +++ b/help/.gitignore @@ -13,3 +13,14 @@ it/*.xml ru/*.xml sv/*.xml +ca/*.page +cs/*.page +de/*.page +el/*.page +en_GB/*.page +es/*.page +fi/*.page +fr/*.page +it/*.page +ru/*.page +sv/*.page diff --git a/help/C/add-account.page b/help/C/add-account.page new file mode 100644 index 00000000..2fa344cf --- /dev/null +++ b/help/C/add-account.page @@ -0,0 +1,94 @@ + + + + + + Add a new account to Empathy. + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + Add a new account + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Press F4. +

+ + +

+ Choose EditAccounts. +

+ + + + +

+ If it is the first time you launch Empathy: +

+ + +

+ From the Type drop-down list choose + the service you wish to add an account for, then click + on the Create button. +

+ + +

+ Otherwise: +

+ + +

+ Click on the Add button. +

+ + +

+ From the Type drop-down list choose + the service you wish to add an account for, then click + on the Create button. +

+ + + + +

+ Fill the required fields with your user + name and password. +

+ + +

+ To enable the new account, select the + Enabled check-box next to + 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 Accounts + dialog, double-click on the name of the account in the box on the left of the dialog + and type the new name. +

+ + diff --git a/help/C/add-contact.page b/help/C/add-contact.page new file mode 100644 index 00000000..fbde2877 --- /dev/null +++ b/help/C/add-contact.page @@ -0,0 +1,69 @@ + + + + + + Add someone to the contact list. + + + + Phil Bull + philbull@gmail.com + + + 2009 + GNOME Documentation Project + + + + + Add someone to your list of contacts + + + Phil Bull +

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.

+ + + + +

+ Choose ChatAdd Contact. +

+ + +

+ From the Account drop-down list, select the type of + service the person you want to add to your contacts is using. +

+ + +

+ In the Identifier text box, type the email address + or the username of the person you want to add to your + contacts list. +

+ + +

+ In the Alias text box, type their name. +

+ + +

+ Click Add to add the person to your list of + contacts. +

+ + + + +

+ To add a new person to your list of contacts, you need to be + connected to the Internet and to your account. +

+ + + diff --git a/help/C/audio-call.page b/help/C/audio-call.page new file mode 100644 index 00000000..116f4a8f --- /dev/null +++ b/help/C/audio-call.page @@ -0,0 +1,59 @@ + + + + + + + Start an audio conversation with one of your contacts. + + + + + + + Start an audio conversation + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Select the contact you want to have a conversation with, and click + on the audio call icon next to their name. +

+ + +

+ Right-click on the name of the contact you want to have a conversation with, and + select Audio Call. +

+ + + + +

+ A new window will open. When the connection is established, you will + see written, at the bottom of the window, Connected and the total + conversation time. +

+ + +

+ To close the conversation, click on Hang up. +

+ + + +

+ To turn an audio conversation into a video one, from the call window select + CallSend video, + or click on the video call icon. +

+ + + diff --git a/help/C/audio-video.page b/help/C/audio-video.page new file mode 100644 index 00000000..cc118dd5 --- /dev/null +++ b/help/C/audio-video.page @@ -0,0 +1,69 @@ + + + + + + When it is possible to have an audio or video conversation. + + + + + + Audio and video conversations + +

+ When your contacts support audio or video conversations, you will see, next to + the contacts name in the Contact List window, one or two small icons that + represent the different conversations you can have. +

+ + + + + + + + + + + + + + + + + + +
+

+ Icon +

+ 		+

+ Description +

+
+

+ + Icon for audio conversation + +

+ 		+

+ This is the icon that represents the possibility to have an audio conversation. +

+
+

+ + Icon for video conversation + +

+ 		+

+ This is the icon that represents the possibility to have a video conversation. +

+
+ + diff --git a/help/C/change-status.page b/help/C/change-status.page new file mode 100644 index 00000000..a2e687ff --- /dev/null +++ b/help/C/change-status.page @@ -0,0 +1,51 @@ + + + + + + + Change your status, if you are going away from your computer for example. + + + + + Phil Bull + philbull@gmail.com + + + 2009 + GNOME Documentation Project + + + + + Change your status + + + +

+ Click on the drop-down list at the top of the Contact List window. +

+ + +

+ Select a status from the list. +

+ + + +

+ For example, if you are busy and do not want to + be disturbed, select Busy. +

+ + +

+ 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 Away. +

+ + + diff --git a/help/C/create-account.page b/help/C/create-account.page new file mode 100644 index 00000000..203818c7 --- /dev/null +++ b/help/C/create-account.page @@ -0,0 +1,137 @@ + + + + + + + + Register an account with one of the supported messaging services. + + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + Register for a new account + +

+ 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. +

+

+ At the end of the registration process you should have a user + name (or an account ID) and a password + that you will use to add the account to Empathy. +

+

+ Click on the name of the service to visit its website. +

+ +
+ Instant Messaging Services + + + +

+ AIM +

+ + +

+ Google Talk +

+ + +

+ ICQ +

+ + +

+ Jabber +

+ +

+ 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 jabber.org, + the default one of the application. +

+ + + +

+ MSN +

+ + +

+ Yahoo! +

+ + +
+ +
+ Local Instant Messaging Services +

+ This service works when you are connected to a local network, + you do not need an Internet connection in order to use it. +

+ + +

+ Salut +

+ + + +

+ For more information, see . +

+ +
+ +
+ Telephony Services + +

+ These services will let you do voice call over the Internet with + other people using the same service or even to normal phones. +

+ + + +

+ Ekiga +

+ + +

+ Sipphone +

+ + + + +

+ 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. +

+ + +
+ diff --git a/help/C/disable-account.page b/help/C/disable-account.page new file mode 100644 index 00000000..2ded8067 --- /dev/null +++ b/help/C/disable-account.page @@ -0,0 +1,66 @@ + + + + + + + Prevent an account from logging-in automatically when you start + Empathy. + + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + Disable an account + +

+ Disabling an account means to deactivate it, temporarily or + permanently. All the conversations you had will be kept in your computer. +

+

+ After disabling an account, it is possible to enable it again. +

+ + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Press F4. +

+ + +

+ Choose EditAccounts. +

+ + + + +

+ Select the account you wish to disable from the box on the + left of the dialog. +

+ + +

+ Deselect the Enabled check-box. +

+ + + + diff --git a/help/C/empathy.xml b/help/C/empathy.xml deleted file mode 100644 index e6a1a728..00000000 --- a/help/C/empathy.xml +++ /dev/null @@ -1,1395 +0,0 @@ - - - - - -Empathy"> - - - - - - - - - - -]> - -
- - - - &app; Manual V&manrevision; - - - 2008, 2009 - Ubuntu Documentation Project - - - 2009 - GNOME Documentation Project - - - - - GNOME Documentation Project - - - - &legal; - - - - Milo - Casagrande - - GNOME Documentation Project -
milo@ubuntu.com
- - - Ubuntu Documentation Project -
milo@ubuntu.com
- - - - Seth - Dudenhofer - - Ubuntu Documentation Project -
sdudenhofer@gmail.com
- - - - - - - - - - - - - - - - - - - - - - - - Empathy Manual V&manrevision; - &date; - - Milo Casagrande - milo@ubuntu.com - - GNOME Documentation Project - - - - - Empathy Manual V2.1 - January 2009 - - Milo Casagrande - milo@ubuntu.com - - Ubuntu Documentation Project - - - - - Empathy Manual V2.0 - April 2008 - - Milo Casagrande - milo@ubuntu.com - - Seth Dudenhofer - sdudenhofer@gmail.com - - Ubuntu Documentation Project - - - - - - This manual describes version &appversion; of &appname;. - - - Feedback - - To report a bug or make a suggestion regarding the &app; application or - this manual, follow the directions in the GNOME Feedback Page. - - - - - - &appname; is an application for instant messaging. - - - - - - - Empathy - - - empathy - istant messaging - - - - Introduction - - &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. - - - &app; supports the following services: - - - - AIM - - - - - Google Talk - - - - - ICQ - - - - - IRC - - - - - Jabber (or XMPP) - - - - - MSN - - - - - Salut - - - - - SIP - - - - - Yahoo - - - - - And many others... - - - - - - - - Getting Started - - - Starting &appname; - You can start &app; in the following ways: - - - - Applications menu - - Choose - - Internet - Empathy IM Client - . - - - - - Command line - - Type empathy and then press - Enter. - - - - - - - - When You Start &appname; - - When you start &app; the following window is shown. - -
- &app; Main Window - - - - - - - - Shows &app; main window. Contains the titlebar, the - menubar, contact list, status icon and status arrow - button list. - - - - -
- - - - describes the components of - &app;'s main window. - - &app; Main Components - - - - - - - Component - - - Description - - - - - - - Menubar - - - - Contains menus used to perform actions in &app;. - - - - - - Status Drop-Down List - - - - Allows to update the status. - - - - - - Account Button - - - - Opens the Accounts dialog. - - - - - - Contact List - - - - Shows all the available contacts and their - associated status. - - - - - -
- - - - - - Accounts - - To use &app; you need at least one account of the supported services. - - - If you don't already have an account and you don't have your user - name and password, you need to - register a new account (see ). - - - In order to talk with other users, also called - contacts, you need to use the same service - they are using. If, for example, one contact is using the Jabber service, you need to have an - account registered with that service. - - - &app; can handle as many accounts on any supported services as you want and - you can have them all open at the same time. - - - - Registering an Account - - 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 user - name (or an account ID) and - a password that you will use to - create the account in &app;. - - - Click on the name of the service to visit its website: - - - - - - The AIM service. - - - - - - The Google - Talk service. - - - - - - The ICQ service. - - - - - - The MSN service. - - - - - - The Yahoo service. - - - - - - For registering a SIP account, you can use one of the - following service: - - - - - - - The Ekiga service. - - - - - - The FWD (Free - World Dialup) service. - - - - - - The Sipphone service. - - - - - - For registering a Jabber - 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 jabber.org. - - - If you already have a Jabber account, you can use one of - the following services: - - - - - - Salut - - - - - - - - Adding your Account to &app; - - To add your account to &app;, proceed as follows: - - - - From the main window - (Contact List) - click on the account button or press F4 to open the - Accounts dialog. - - - - - If it is the first time you launch &app;: - - - - From the Type drop-down list choose - the service you wish to add an account for, then click - on the Create button. - - - - - - Otherwise: - - - - Click on the Add button. - - - - - From the Type drop-down list choose - the service you wish to add an account for, then click - on the Create button. - - - - - - - - Fill the required fields with your user - name and - password. Optionally, you can - modify some advanced options. For more information, - see . - - - - - To enable the new account, select the - Enabled check-box next to - the name of the account in the box on the left. - - - - - - - Importing Accounts - - If you use another instant messaging program, you can import - the accounts from that program into &app; - - - - - At the moment &app; can import the accounts only from - the instant messaging program - Pidgin. For more information - about Pidgin, see the Pidgin website. - - - - - To import the accounts into &app;, proceed as follows: - - - - From the main window - (Contact List) - click on the account button or press F4 to open the - Accounts dialog. - - - - - Click on the Import Accounts... - button to open the Import - Accounts dialog. - - - - - Select the accounts you would like to import by - clicking on the Import check-box. - - - - - When you have selected all the desired accounts, click - OK to import them. If you don't - want to import the accounts, click - Cancel. - - - - - When you import a new account into &app;, it will not be - enabled by default. - - - To enable the new account, select the - Enabled check-box next to - the name of the account in the box on the left. - - - - - - - - - Editing an Account - - To edit one of your accounts, i.e. to change the - password or your user - name, proceed as follows: - - - - From the main window - (Contact List) - click on the account button or press F4 to open the - Accounts dialog. - - - - - Select the account you wish to edit in the box on the - left. - - - - - Modify the desired data. - - - - - - - - Based on the type of the account, it is possibile to edit - different settings. - - - - - To modify the identifier of an account, how &app; identifies - an account, proceed as follows: - - - - From the main window - (Contact List) - click on the account button or press F4 to open the - Accounts dialog. - - - - - Select the account you wish to edit in the box on the - left and double-click on its name. - - - - - Change the name of the account as you desire. - - - - - - - - Disabling and Removing an Account - - To disable an account, proceed as follows: - - - - - - From the main window - (Contact List) - click on the account button or press F4 - to open the - Accounts dialog. - - - - - Select the account you wish to disable in the box on the - left of the dialog and deselect the - Enabled check-box. - - - - - - To remove an account, proceed as follows: - - - - - - From the main window - (Contact List) - click on the account button or press F4 - to open the - Accounts dialog. - - - - - Select the account you wish to disable in the box on the - left of the dialog. - - - - - Click on the Remove button. - - - - - A dialog will be shown asking for confirmation. Click on - the Remove button to remove the account. - - - - - - - - Editing Personal Information - - 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: - - - - - - From the main - window, select - Edit - Personal Information - . - - - - - From the Account drop-down list, choose - the account you want to edit. - - - - - In the Alias text box, write your new - alias. - - - - - To change your icon, click on the person-looking button and - choose an image file. - - - - - When done, click Close. - - - - - - - - An alias is an alternative way you - can identify yourself. You can use your real - name or a nickname. - - - - - - - Advanced Options - - Based on the service you are using, it is possible to - configure more advanced options to modify the normal behavior of - &app;. - - - To configure these options, when you are adding a new - account, click on the drop-down section - Advanced. - - - - - Jabber (or <acronym>XMPP</acronym>) and Google Talk - - - - - - Encryption required (TLS/SSL) - - - - Select this option in order to use some sort of - encryption during your conversations. - - - - - - Ignore SSL certificate errors - - - - 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. - - - - - Select this option only if you are sure the - certificate is secure and you can trust it. - - - - - - - - Resource - - - - 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 - Priority one, you can - use your account simultaneously in two different - devices. For example, if you set one device to - desktop and the other - one to mobile, you can - connect with both of them and based on the - Priority value you will receive - messages on one of the two devices or both. - - - 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. - - - - - 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 - Priority spin box. - - - - - - - - Priority - - - - Use this spin box to indicate wich device, set in - the Resource 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. - - - You can set values in the range from - -128 to 127. - - - - - If you set the same value of this spin box in - both the devices, you will receive messages on - both of them. - - - - - - - - - In the Override server settings section - you can set options that take precedence over the default settings. - - - - Server - - - - Use this text box to write the name of the - server you want to use for this service. - - - - - - Port - - - - Use this spin box to set the number of the port of - the server to use. - - - You can set values in the range from - 0 to 65,555. - - - - - - Use old SSL - - - - Select this option to use the old version of the - secure protocol for encrypting your connection. - - - - - - - - - Yahoo - - - - - Ignore conference and chatrooms - invitations - - - - Select this option to ignore the invitations that - other people may send you. - - - - - - Room List locale - - - - The value of this text box identifies the language - used to retrieve the room list when connecting to - the Yahoo service. - - - If you need to change this value, use the two letter - code of your language. - - - - - - Charset - - - - The value of this text box identifies the set of the - characters used by &app;. - - - - - It is advise to leave this value to - UTF-8. Change it only - if that charset does not cover your language. - - - - - - - - Server - - - - Use this text box to write the name of the - server you want to use for this service. - - - - - - Port - - - - Use this spin box to set the number of the port of - the server to use. - - - You can set values in the range from - 0 to 65,555. - - - - - - Use Yahoo Japan - - - - 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. - - - - - - - - - <acronym>AIM</acronym>, GroupWise and <acronym>MSN</acronym> - - - - - Server - - - - Use this text box to write the name of the - server you want to use for this service. - - - - - - Port - - - - Use this spin box to set the number of the port of - the server to use. - - - You can set values in the range from - 0 to 65,555. - - - - - - - - - Salut - - - - - Published Name - - - - Use this text box to write the name that will be - visible to the other users of the network. - - - - - - Email - - - - Use this text box to write your email. - - - - - - Jabber ID - - - - Use this text box to write your Jabber ID, if you - have one. - - - - - - - - - ICQ - - - - - Charset - - - - The value of this text box identifies the set of the - characters used by &app;. - - - - - It is advise to leave this value to - UTF-8. Change it only - if that charset does not cover your language. - - - - - - - - Server - - - - Use this text box to write the name of the - server you want to use for this service. - - - - - - Port - - - - Use this spin box to set the number of the port of - the server to use. - - - You can set values in the range from - 0 to 65,555. - - - - - - - - - Gadu Gadu - - - - Nick - - - Use this text box to write an alternative name to - use with this service. - - - - - - - - - - - - - Contacts and Groups - - All the contacts are handled within &app;'s main window. - - - 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. - - - Adding and Removing a Contact - - To add a new contact, proceed as follows: - - - - - - From the main - window choose - Chat - Add Contact... - . The New Contact - dialog will be shown. - - - - - From the Account drop-down list, - choose the service used by the contact you are adding. - - - - - In the Identifier text box type the - address of the contact in the form - of - user name@service - domain. - - - - - In the Alias text box type the name - you want to give at the the new contact. - - - - - Click on Add to add the new contact. - - - - - - To remove a contact, proceed as follows: - - - - - - From the main - window, select the contact you would like - to remove and right-click on it. - - - - - From the popup menu, choose Remove to - remove the contact. - - - - - - - - An alias is an alternative way you - can identify that particular contact. You can use the real - name or the nickname of that person. - - - - - - Editing a Contact - - To edit a contact, proceed as follows: - - - - - - From the main - window, select the contact you would like - to modify and choose - Edit - Contact - Edit - , or right-click on it - and choose Edit. - - - - - - From the Edit Contact Information dialog, - you can modify the alias - and the group of the contact. - - - - - An alias is an alternative way you - can identify that particular contact. You can use the real - name or the nickname of that person. - - - - - For more information about groups, see and . - - - - - Adding a Contact to a Group - - To add a contact to one or more groups, proceed as follows: - - - - - - From the main - window, select the contact you would like - to modify and choose - Edit - Contact - Edit - , or right-click on it - and choose Edit. - - - - - From the Groups section, select the - group, or groups, you want to add the contact to. - - - - - When done, click Close. - - - - - - - - Adding a New Group - - To add a new group, proceed as follows: - - - - - - From the main - window, select one contact and choose - Edit - Contact - Edit - , or right-click on it - and choose Edit. - - - - - In the Groups section, write the - name of the group you want to add and then click on - Add Group. - - - - - When done, click Close. - - - - - - - - - -
diff --git a/help/C/figures/audio-input-microphone.png b/help/C/figures/audio-input-microphone.png new file mode 100644 index 00000000..f45d15d5 Binary files /dev/null and b/help/C/figures/audio-input-microphone.png differ diff --git a/help/C/figures/available.png b/help/C/figures/available.png new file mode 100644 index 00000000..66b24967 Binary files /dev/null and b/help/C/figures/available.png differ diff --git a/help/C/figures/away.png b/help/C/figures/away.png new file mode 100644 index 00000000..ff59e309 Binary files /dev/null and b/help/C/figures/away.png differ diff --git a/help/C/figures/busy.png b/help/C/figures/busy.png new file mode 100644 index 00000000..fec554d8 Binary files /dev/null and b/help/C/figures/busy.png differ diff --git a/help/C/figures/camera-web.png b/help/C/figures/camera-web.png new file mode 100644 index 00000000..e5406c5b Binary files /dev/null and b/help/C/figures/camera-web.png differ diff --git a/help/C/figures/extended-away.png b/help/C/figures/extended-away.png new file mode 100644 index 00000000..ca26ae5d Binary files /dev/null and b/help/C/figures/extended-away.png differ diff --git a/help/C/group-conversations.page b/help/C/group-conversations.page new file mode 100644 index 00000000..d56a7f86 --- /dev/null +++ b/help/C/group-conversations.page @@ -0,0 +1,15 @@ + + + + + + Start a group conversation with your contacts. + + + + + Group conversations + + diff --git a/help/C/index.page b/help/C/index.page new file mode 100644 index 00000000..729271b3 --- /dev/null +++ b/help/C/index.page @@ -0,0 +1,43 @@ + + + + + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Empathy Instant Messenger + +
+ Audio and video conversations +
+ +
+ Text conversations +
+ +
+ Manage accounts +
+ +
+ Advanced actions +
+ +
+ Fix common problems +
+ + diff --git a/help/C/irc-account.page b/help/C/irc-account.page new file mode 100644 index 00000000..1f81eb59 --- /dev/null +++ b/help/C/irc-account.page @@ -0,0 +1,128 @@ + + + + + + + Create an IRC account. + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + Create an IRC account + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Press F4. +

+ + +

+ Choose EditAccounts. +

+ + + + +

+ If it is the first time you launch Empathy: +

+ + +

+ From the Type drop-down list choose + IRC, then click on the Create button. +

+ + +

+ Otherwise: +

+ + +

+ Click on the Add button. +

+ + +

+ From the Type drop-down list choose + IRC, then click on the Create button. +

+ + + + +

+ From the Network drop-down list, select the name of the network + you are creating the account for. +

+ + + +

+ In the Nickname text box, type the name that will identify yourself + in the network you are creating the account. +

+ + +

+ In the Password text box, type the password you used to register + your nikcname. If you do not have one, leave this field blank. +

+ + +

+ In the Real name text box, type your real name. +

+ +

+ It is not necessary to insert your real name. +

+ + + +

+ In the Quit message text box, type a text message that will be + sent when you close your session. +

+ + +

+ To enable the new account, select the Enabled check-box + next to 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 Accounts + dialog, double-click on the name of the account in the box on the left of the dialog + and type the new name. +

+ + +

+ 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. +

+ + + diff --git a/help/C/irc-join-pwd.page b/help/C/irc-join-pwd.page new file mode 100644 index 00000000..e672bbe6 --- /dev/null +++ b/help/C/irc-join-pwd.page @@ -0,0 +1,29 @@ + + + + + + Join a password protected room. + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Join a protected room + +

+ At the moment it is not possible to join a password protected room. +

+ + diff --git a/help/C/irc-join-room.page b/help/C/irc-join-room.page new file mode 100644 index 00000000..37939926 --- /dev/null +++ b/help/C/irc-join-room.page @@ -0,0 +1,55 @@ + + + + + Entering an IRC channel. + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Join a room + + + +

+ From the Contact List window, choose + RoomJoin. +

+ + +

+ From the Account drop-down list, select the IRC account that + corresponds to the network you want to use. +

+ + +

+ In the Room text box, type the name of the channel you want to + join. Prefix the name with the hash character (#). +

+ + +

+ Click on Join to enter the room. +

+ + + + +

+ To join multiple rooms, you need to repeat the steps above for each room. +

+ + diff --git a/help/C/irc-manage.page b/help/C/irc-manage.page new file mode 100644 index 00000000..bb285f24 --- /dev/null +++ b/help/C/irc-manage.page @@ -0,0 +1,43 @@ + + + + + Manage IRC accounts with Empathy. + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Use IRC + + + Milo Casagrande +

+ 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. +

+ + +
+ Manage IRC accounts +
+ +
+ + Fix common problems +
+ + + diff --git a/help/C/irc-nick-password.page b/help/C/irc-nick-password.page new file mode 100644 index 00000000..1a73a2c4 --- /dev/null +++ b/help/C/irc-nick-password.page @@ -0,0 +1,92 @@ + + + + + + How to set the password of a nickname. + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Set the nickname password + +

+ 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. +

+ +

+ If you have registered your nickname with a password on a network that supports nickname + registration, you can use that password with Empathy to identify yourself as + the owner of the nickname. +

+ + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Press F4. +

+ + +

+ Choose EditAccounts. +

+ + + + +

+ Select the IRC account from the box on the left of the dialog. +

+ + +

+ If the account is enabled, disable it by deselecting the Enable + check-box next to the name of the account. +

+ + +

+ In the Password text box, type the password you used to register + your nikcname. +

+ + +

+ Enable the account by selecting the Enabled check-box + next to the name of the account. +

+ + + +

+ Once you are connected, you will receive a message from the nickname server that will + tell you of the established identification. +

+ + +

+ At the moment it is not possible to register an IRC nickname with Empathy, it is + only possible to use the password of an already registered nickname. +

+ + + diff --git a/help/C/legal.xml b/help/C/legal.xml index ac97e1de..6f643bec 100644 --- a/help/C/legal.xml +++ b/help/C/legal.xml @@ -1,76 +1,9 @@ - - - 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 link or in the file COPYING-DOCS - distributed with this manual. - - 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. - - - - 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. - - - - DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED - UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE - WITH THE FURTHER UNDERSTANDING THAT: - - - - 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 - - - - 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. - - - - - - + +

This work is licensed under a +Creative Commons +Attribution-Share Alike 3.0 United States License.

+

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.

+ diff --git a/help/C/offline-contacts.page b/help/C/offline-contacts.page new file mode 100644 index 00000000..6fa8c51e --- /dev/null +++ b/help/C/offline-contacts.page @@ -0,0 +1,59 @@ + + + + + + How to see the contacts that are not online. + + + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Display offline contacts + + + Milo Casagrande +

+ Need to rework on the terminology used. +

+ + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Choose ViewOffline Contacts. +

+ + +

+ Press CtrlH. +

+ + + + +

+ To hide the offline contacts again, repeat the same procedure above. +

+ + + + diff --git a/help/C/prob-conn-acctdisabled.page b/help/C/prob-conn-acctdisabled.page new file mode 100644 index 00000000..71caf567 --- /dev/null +++ b/help/C/prob-conn-acctdisabled.page @@ -0,0 +1,51 @@ + + + + + + The instant messaging account that you want to use is not enabled in + the list of accounts. + + + + Phil Bull + philbull@gmail.com + + + 2009 + GNOME Documentation Project + + + + +My account is not enabled + +

+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. +

+ + + +

+ Click EditAccounts and make sure + that the Enabled checkbox is checked. +

+ + +

+ Make sure that your username and password are correct. +

+ + +

+ Expand the Advanced section of the Accounts + window and make sure that all of the server settings are correct. +

+ + + + diff --git a/help/C/prob-conn-auth.page b/help/C/prob-conn-auth.page new file mode 100644 index 00000000..e4916729 --- /dev/null +++ b/help/C/prob-conn-auth.page @@ -0,0 +1,62 @@ + + + + + + + An error message appears in the main window saying that + "Authentication failed". + + + + + + + Phil Bull + philbull@gmail.com + + + + 2009 + GNOME Documentation Project + + + + + + I get a message that says "Authentication failed" + + + Milo Casagrande +

+ Could be useful to link here how to change your password or how to + recover it. Need to write that section. +

+ + +

+ If you try to connect and you get a message saying Authentication failed, + your instant messaging service is not allowing you to connect because it does not + recognize your username or password for some reason. +

+ + + +

+ 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. +

+ + +

+ Click the Edit Account button in the error message. Type + your username and password again to make sure that they are correct. + Deselect the Enabled box next to the name of your account and + then select it to try to connect to the service again. +

+ + + diff --git a/help/C/prob-conn-name.page b/help/C/prob-conn-name.page new file mode 100644 index 00000000..98e17c36 --- /dev/null +++ b/help/C/prob-conn-name.page @@ -0,0 +1,59 @@ + + + + + + + An error message appears in the main Empathy window which says + "Name in use". + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + + I get a message that says "Name in use" + +

+ 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. +

+ +

+ To resolve this problem, click on the Edit Account button and + perform one of the following: +

+ + + +

+ Change your nickname. +

+ + +

+ Set the password for that nickname, if you have registered that nickname + within the network you are using. For more information, + see . +

+ + + + diff --git a/help/C/prob-conn-neterror.page b/help/C/prob-conn-neterror.page new file mode 100644 index 00000000..f15a4c86 --- /dev/null +++ b/help/C/prob-conn-neterror.page @@ -0,0 +1,67 @@ + + + + + + + An error message appears in the main Empathy window which says + "Network error". + + + + Phil Bull + philbull@gmail.com + + + 2009 + GNOME Documentation Project + + + + + + +I get a message that says "Network error" + +

+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. +

+ + + +

+ Check that you are connected to the Internet or network. +

+ + + + +

+ Click the Edit Account button in the error message. +

+ + +

+ Expand the Advanced 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. +

+ + +

+ Uncheck the Enabled box next to the name of your account and + then check it again to try to connect to the service again. +

+ + + + + + diff --git a/help/C/prob-conn.page b/help/C/prob-conn.page new file mode 100644 index 00000000..137a5877 --- /dev/null +++ b/help/C/prob-conn.page @@ -0,0 +1,44 @@ + + + + + + Diagnose common problems connecting to an instant messaging service. + + + + + Phil Bull + philbull@gmail.com + + + 2009 + GNOME Documentation Project + + + + + +Problems connecting to an instant messaging service + + + Phil Bull +

This is a stub. We should identify the most common causes for a user not + being able to connect and document those.

+ + + + Phil Bull +

Check whether gui tags are allowed in section titles and descs.

+ + Milo Casagrande +

+ You can... but the end result is not very good: the title is in blue and the + gui element in grey. +

+ + + + diff --git a/help/C/remove-account.page b/help/C/remove-account.page new file mode 100644 index 00000000..5728b40d --- /dev/null +++ b/help/C/remove-account.page @@ -0,0 +1,70 @@ + + + + + Completely remove an account from Empathy. + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + Remove an account + +

+ Removing an account means to delete it from your computer with all + the conversations you had with other people. +

+

+ After removing an account you will not be able to recover it or to recover + the conversations you had. +

+ + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Press F4. +

+ + +

+ Choose EditAccounts. +

+ + + + +

+ Select the account you wish to remove from the box on the + left of the dialog. +

+ + +

+ Click on the Remove button. +

+ + +

+ A dialog will be shown asking for confirmation. Click on + the Remove button to permanently remove the + account. +

+ + + + diff --git a/help/C/salut-protocol.page b/help/C/salut-protocol.page new file mode 100644 index 00000000..8b23acac --- /dev/null +++ b/help/C/salut-protocol.page @@ -0,0 +1,52 @@ + + + + + + Undesrtanding the Salut protocol. + + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + What is the <em>Salut</em> service? + + + Milo Casagrande +

+ Need to work on this section, explaining people in clear words + what the hell is this service! +

+ + +

+ The Salut service is a serverless communication service: + you do not need to connect and authenticate to a central server in + order to use it. +

+

+ This kind of serverless messaging system is restricted to a local area + network and an active Internet connection is not necessary. +

+

+ 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. +

+

+ All the modern local area networks should be able to support this kind + of service. +

+ diff --git a/help/C/send-file.page b/help/C/send-file.page new file mode 100644 index 00000000..7d7b2ab7 --- /dev/null +++ b/help/C/send-file.page @@ -0,0 +1,90 @@ + + + + + Send a file from your computer to one of your contacts. + + + + + Phil Bull + philbull@gmail.com + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Send files + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Right-click on the contact you want to send a file, and select Send file. +

+ + +

+ Click on the contact you want to send a file, and choose Edit + ContactSend file. +

+ + + + +

+ Select the file to send, and click on Send. +

+ + +

+ The File Transfers window will appear. Wait for your contact to accept the + file transfer, or click Stop to halt the transfer. +

+ + + + +

+ It is possible to send files only using the following services: Jabber, + Google Talk and Salut. +

+ + +

+ 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. +

+

+ If they do not accept it, the status of the transfer will change to File + transfer cancelled, and the file will not be sent. +

+

+ Once a transfer is finished, you can close the File Transfers + window. If you have multiple finished transfers listed in the window, click on + Clear to empty the list. This will only remove the files from the + list and will not delete them from your computer. +

+ + +

+ In order to send a file to someone, you need to be connected to the Internet, or to + a local area network. +

+ + + diff --git a/help/C/send-message.page b/help/C/send-message.page new file mode 100644 index 00000000..bdf1c734 --- /dev/null +++ b/help/C/send-message.page @@ -0,0 +1,52 @@ + + + + + Send a message to one of your contacts. + + + + Phil Bull + philbull@gmail.com + + + 2009 + GNOME Documentation Project + + + + + + Send a message to someone + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Double-click the name of the contact that you want to have a conversation + with. +

+ + +

+ Right-click on the name of the contact you want to have a conversation with, and + select Chat. +

+ + + + +

+ A new window will open. Type a message into the box at the + bottom of the window and press Enter to send it. +

+ + + + diff --git a/help/C/set-custom-status.page b/help/C/set-custom-status.page new file mode 100644 index 00000000..36656a16 --- /dev/null +++ b/help/C/set-custom-status.page @@ -0,0 +1,163 @@ + + + + + + + + Set a personal message for your status. + + + + + Jim Campbell + jwcampbell@gmail.com + + + 2009 + GNOME Documentation Project + + + + + + Set a custom message + +

+ 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. +

+

+ It is possible to set a custom message based on the different statuses available. +

+ + + +

+ From the Contact List window, click on the drop-down list at + the top. +

+ + +

+ Select the status you want to add a custom message to. You have to select the one + identified with the label Custom Message. +

+ + +

+ Enter your custom message in the text box at the top of the window, and + press Enter to set the message. +

+ + +

+ 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. +

+

+ If you do not do it, the custom message will not be available the next time you + use Empathy. It will be saved only for the current session. +

+ + + +
+ + Edit, remove and add a custom message + + + +

+ From the Contact List window, click on the drop-down list at + the top. +

+ + +

+ Select Edit Custom Message. +

+ + + + +

+ To edit a custom message: +

+ + +

+ From the Saved Presets box, select the status message + you want to edit and double-click on it. +

+ + +

+ Type the new custom message and press Enter to modify it. +

+ + + + +

+ To remove a custom message: +

+ + +

+ From the Saved Presets box, select the status message you want + to remove. +

+ + +

+ Click on the Remove button. +

+ + + + +

+ To add a new custom message, from the Add New Preset section: +

+ + +

+ Click on the drop-down list to select the status you want to set a custom + message to. +

+ + +

+ Click on the text box, and type the new custom message. +

+ + +

+ Click on Add to add the new message to the presets ones. +

+ + + + + + +

+ When finished, click on Close. +

+ + + + +

+ 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 Contact List window. +

+ + +
+ + diff --git a/help/C/share-desktop.page b/help/C/share-desktop.page new file mode 100644 index 00000000..de795779 --- /dev/null +++ b/help/C/share-desktop.page @@ -0,0 +1,86 @@ + + + + + + Share the desktop with your contacts. + + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Share your desktop + +

+ 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. +

+ + +

+ 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. +

+ + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Select the contact you want to share your desktop with, and choose + EditContactShare my desktop. +

+ + +

+ Right-click on the name of the contact you want to share your desktop with, + and select Share my desktop. +

+ + + + +

+ 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. +

+

+ For more information about how to use the remote desktop viewer application, + refer to its help. +

+ + + +

+ When you share your desktop with someone else, it is possible to experience + system performance slowdown and low Internet speed. +

+ + +

+ 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 Empathy and a remote desktop + viewer application installed in their system. +

+ + + diff --git a/help/C/status-icons.page b/help/C/status-icons.page new file mode 100644 index 00000000..cc561cb8 --- /dev/null +++ b/help/C/status-icons.page @@ -0,0 +1,108 @@ + + + + + Understanding the various status icons. + + + + + + Milo Casagrande + milo@ubuntu.com + + + 2009 + GNOME Documentation Project + + + + + + Status icons + + + Milo Casagrande +

+ Need to understand when the extended away icon is used: how many minuts/hours should pass? +

+

+ Need also to check for images to work! +

+ + + + + + + + + + + + + + + + + + + + + + + +
+

+ Icon +

+ 		+

+ Description +

+
+

+ + Available icon + +

+ 		+

+ This is the default icon for the Available status. +

+

+ Use this icon when you are availble to have conversations with other + people. +

+
+

+ + Busy icon + +

+ 		+

+ This is the default icon for the Busy status. +

+

+ Use this icon when you do not want to be disturbed. +

+
+

+ + Away icon + +

+ 		+

+ This is the default icon for the Away status. +

+

+ 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. +

+
+ + diff --git a/help/C/video-call.page b/help/C/video-call.page new file mode 100644 index 00000000..1f65c608 --- /dev/null +++ b/help/C/video-call.page @@ -0,0 +1,59 @@ + + + + + + + Start a video conversation with one of your contacts. + + + + + Start a video conversation + + + +

+ From the Contact List window, perform one of the following: +

+ + +

+ Select the contact you want to have a conversation with, and click + on the video call icon next to their name. +

+ + +

+ Right-click on the name of the contact you want to have a conversation with, and + select Video Call. +

+ + + + +

+ A new window will open. When the connection is established, you will + see written, at the bottom of the window, Connected and the total + conversation time. +

+ + +

+ To close the conversation, click on Hang up. +

+ + + +

+ To turn a video conversation into an audio one, from the call window deselect + CallSend video, + or click on the video call icon. +

+ + + + + diff --git a/help/Makefile.am b/help/Makefile.am index f51965b5..2ba171df 100644 --- a/help/Makefile.am +++ b/help/Makefile.am @@ -1,8 +1,46 @@ include $(top_srcdir)/gnome-doc-utils.make -DOC_MODULE = empathy -DOC_ENTITIES = legal.xml +DOC_ID = empathy +DOC_INCLUDES = legal.xml DOC_FIGURES = \ - figures/empathy-main-window.png + figures/audio-input-microphone.png \ + figures/available.png \ + figures/away.png \ + figures/busy.png \ + figures/camera-web.png \ + figures/empathy-main-window.png \ + figures/extended-away.png + +DOC_PAGES = \ + add-account.page \ + add-contact.page \ + audio-call.page \ + audio-video.page \ + change-status.page \ + create-account.page \ + disable-account.page \ + group-conversations.page \ + index.page \ + irc-account.page \ + irc-join-pwd.page \ + irc-join-room.page \ + irc-manage.page \ + irc-nick-password.page \ + offline-contacts.page \ + prob-conn-acctdisabled.page \ + prob-conn-auth.page \ + prob-conn-name.page \ + prob-conn-neterror.page \ + prob-conn.page \ + remove-account.page \ + salut-protocol.page \ + send-file.page \ + send-message.page \ + set-custom-status.page \ + share-desktop.page \ + status-icons.page \ + video-call.page + + DOC_LINGUAS = ca cs de el en_GB es fi fr it ru sv dist-hook: doc-dist-hook