diff options
-rw-r--r-- | help/C/account-irc.page | 145 | ||||
-rw-r--r-- | help/C/account-jabber.page | 62 | ||||
-rw-r--r-- | help/C/accounts-window.page | 38 | ||||
-rw-r--r-- | help/C/figures/gtk-add.png | bin | 0 -> 400 bytes | |||
-rw-r--r-- | help/C/figures/gtk-edit.png | bin | 0 -> 744 bytes | |||
-rw-r--r-- | help/C/figures/gtk-remove.png | bin | 0 -> 215 bytes | |||
-rw-r--r-- | help/C/prob-conn-name.page | 6 | ||||
-rw-r--r-- | help/Makefile.am | 3 |
8 files changed, 252 insertions, 2 deletions
diff --git a/help/C/account-irc.page b/help/C/account-irc.page new file mode 100644 index 000000000..a77d3a07f --- /dev/null +++ b/help/C/account-irc.page @@ -0,0 +1,145 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" style="screen" + id="account-irc"> + + <info> + <revision pkgversion="2.28" version="0.1" date="2009-08-26" status="stub"/> + <credit type="author"> + <name>Shaun McCance</name> + <email>shaunm@gnome.org</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>IRC Account Details</title> + + <p>IRC accounts require different information than many other types of + accounts. To create an IRC account, you must specify at least an IRC + network and a nickname. This page details the information you can + provide for an IRC account.</p> + + <note style="info package"> + <p>You must have the <sys>telepathy-idle</sys> package installed + in order to use IRC in <app>Empathy</app>.</p> + </note> + + <terms> + <item> + <title><gui>Network</gui></title> + <p>IRC is an open system that allows people to run separate IRC + networks. Each network is distinct and has its own users and + chat rooms. <app>Empathy</app> lists the most popular networks + in the <gui>Network</gui> drop-down list. You can add additional + networks. See <link xref="#networks"/> below.</p> + </item> + <item> + <title><gui>Nickname</gui></title> + <p>Your nickname is your unique name on the IRC network. Only one + person on a network may use a given nickname. If you get an error + message that says <link xref="prob-conn-name" role="error-msg"/> + you will need to change your nickname.</p> + </item> + <item> + <title><gui>Password</gui></title> + <p>Some servers, particularly those on private networks, require + a password to connect. If you are authorized to use the network, + the network administrators should provide you with a password.</p> + <note> + <title>NickServ Passwords</title> + <p>On some networks, nicknames can be registered using a service + known as NickServ. <app>Empathy</app> does not directly support + nickname passwords. On some networks, including the popular + FreeNode network, server passwords are automatically forwarded + to NickServ, allowing you to set this field to identify yourself + with NickServ. See <link xref="irc-nick-password"/> for more + details.</p> + </note> + </item> + <item> + <title><gui>Real name</gui></title> + <p>You can provide your real name in addition to your nickname. Other + users will be able to see this when they view your information.</p> + </item> + <item> + <title><gui>Quit message</gui></title> + <p>When you go offline, a quit message is sent to all the chat rooms + you’re in and to all the users you’re having a private conversation + with. Use this field to provide a custom quit message.</p> + </item> + </terms> + +<!-- +telepathy-idle note +--> + + <section id="networks"> + <info> + <title type="link">IRC Networks</title> + </info> + + <title>Networks</title> + + <p><app>Empathy</app> includes a list of popular IRC networks. If you + wish to another IRC network, you can add it to the list. You can also + modify networks and remove them from the list.</p> + + <list> + <item><p>To add a network to the list, click <media type="image" + mime="image/png" src="figures/gtk-add.png" width="16" + height="16">Add</media>.</p></item> + <item><p>To modify a network in the list, select the network and click + <media type="image" mime="image/png" src="figures/gtk-edit.png" width="16" + height="16">Edit</media>.</p></item> + <item><p>To remove a network from the list, select the network and + click <media type="image" mime="image/png" src="figures/gtk-remove.png" + width="16" height="16">Remove</media>.</p></item> + </list> + + <p>When adding or modifying a network, you can enter the following + information:</p> + + <terms> + <item> + <title><gui>Network</gui></title> + <p>This is the name of the network as you want it to appear in + the list of networks.</p> + </item> + <item> + <title><gui>Charset</gui></title> + <p>This specifies the character encoding that is typically used on + this network. A character encoding is a specific way of recording + characters internally in a computer. There are many character + encodings, and you need to use the same character encoding as other + users to see their messages correctly.</p> + <!-- + Translators: Recommend character encodings that are common + for your language. + --> + <p>By default, <app>Empathy</app> uses UTF-8, a modern character + encoding that can handle text from most of the world's languages. + Another common encoding for English and some other Western languages + is ISO-8859-1.</p> + </item> + <item> + <title><gui>Servers</gui></title> + <p>An IRC network may have many servers you can connect to. When + you are connected to a server on a particular network, you can + communicate with all users on all other servers on that network. + You can add and remove servers for this network using the + <gui>Add</gui> and <gui>Remove</gui> buttons.</p> + <p>When a server is selected, click the field under <gui>Server</gui> + or <gui>Port</gui> to edit it. Alternatively, use the left and right + arrow keys to focus the field, and press the space bar to begin + editing.</p> + <p>Select the check box in the <gui>SSL</gui> column to encrypt + all communication with a server. Note that this does not prevent + other users on the network from seeing what you write on public + chat rooms.</p> + </item> + </terms> + </section> +</page> diff --git a/help/C/account-jabber.page b/help/C/account-jabber.page new file mode 100644 index 000000000..b6ba60a4d --- /dev/null +++ b/help/C/account-jabber.page @@ -0,0 +1,62 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="topic" style="screen" + id="account-jabber"> + + <info> + <revision pkgversion="2.28" version="0.1" date="2009-08-27" status="review"/> + <credit type="author"> + <name>Shaun McCance</name> + <email>shaunm@gnome.org</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>Jabber Account Details</title> + + <p>Most Jabber accounts will require only a login ID and a password + to connect. For some accounts or on certain types of networks, you + may need to enter additional information in the <gui>Advanced</gui> + section. Normally, you will not need to use the advanced options + below. For general instructions on adding an account, see + <link xref="add-account"/>.</p> + + <terms> + <item> + <title><gui>Encryption required (TLS/SSL)</gui></title> + <title><gui>Ignore SSL certificate errors</gui></title> + <p>Whenever possible, communication between <app>Empathy</app> and + the Jabber server is encrypted. If encrypted communication is not + possible, messages may be sent unencrypted. Select <gui>Encryption + required</gui> to prevent <app>Empathy</app> from communicating with + the Jabber server when encryption is not possible.</p> + <p>Some Jabber servers may encrypt data using invalid certificates, + or using certificates from unknown authorities. If you trust the + server you are connecting to, you can select <gui>Ignore SSL + certificate errors</gui> to allow encrypted communication with + invalid certificates.</p> + </item> + <item> + <title><gui>Resource</gui></title> + <title><gui>Priority</gui></title> + <p>If you have multiple applications (for instance, on separate computers) + connected to your account at the same time, you can set a resource to + uniquely identify each one. By default, <app>Empathy</app> will use + <input>Telepathy</input> as the resource.</p> + <p>You can set the priority to specify which application should receive + incoming messages from your contacts. New messages will be sent to the + application with the highest priority.</p> + </item> + <item> + <title><gui>Override server settings</gui></title> + <p><app>Empathy</app> will use default settings to connect to the + Jabber server based on your login ID. For some Jabber servers, you + will need to enter custom server settings manually. These settings + should be provided for you by your Jabber provider.</p> + </item> + </terms> + +</page> diff --git a/help/C/accounts-window.page b/help/C/accounts-window.page new file mode 100644 index 000000000..14e705641 --- /dev/null +++ b/help/C/accounts-window.page @@ -0,0 +1,38 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="accounts-window"> + + <info> + <link type="topic" xref="add-account"/> + <link type="topic" xref="disable-account"/> + <link type="topic" xref="remove-account"/> + <desc>Add, modify, and delete accounts.</desc> + <revision pkgversion="2.28" version="0.1" date="2009-08-26" status="incomplete"/> + <credit type="author"> + <name>Shaun McCance</name> + <email>shaunm@gnome.org</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>Accounts Window</title> + + <p>The <gui>Accounts</gui> window allows you to add, modify, and delete + accounts.</p> + + <section id="details"> + <info> + <link type="topic" xref="account-jabber"/> + <link type="topic" xref="account-irc"/> + </info> + <title>Account Details</title> + <p>For most types of accounts, you can simply enter a login ID and + a password. Certain accounts or account types, however, may require + additional information.</p> + </section> + +</page> diff --git a/help/C/figures/gtk-add.png b/help/C/figures/gtk-add.png Binary files differnew file mode 100644 index 000000000..c541e6efc --- /dev/null +++ b/help/C/figures/gtk-add.png diff --git a/help/C/figures/gtk-edit.png b/help/C/figures/gtk-edit.png Binary files differnew file mode 100644 index 000000000..5200e14f5 --- /dev/null +++ b/help/C/figures/gtk-edit.png diff --git a/help/C/figures/gtk-remove.png b/help/C/figures/gtk-remove.png Binary files differnew file mode 100644 index 000000000..6b8361e31 --- /dev/null +++ b/help/C/figures/gtk-remove.png diff --git a/help/C/prob-conn-name.page b/help/C/prob-conn-name.page index 3e4edd40c..593c60dca 100644 --- a/help/C/prob-conn-name.page +++ b/help/C/prob-conn-name.page @@ -5,8 +5,10 @@ <info> <link type="guide" xref="prob-conn"/> <link type="guide" xref="irc-manage#problems"/> + <link type="seealso" xref="account-irc"/> + <title type="link" role="error-msg">“Name in use”</title> <desc> - An error message which says "<gui>Name in use</gui>" appears in the main window. + 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"/> @@ -21,7 +23,7 @@ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> </info> - <title>I get a message that says "Name in use"</title> + <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 diff --git a/help/Makefile.am b/help/Makefile.am index 95b218a47..ff79d05e5 100644 --- a/help/Makefile.am +++ b/help/Makefile.am @@ -11,6 +11,9 @@ DOC_FIGURES = \ figures/empathy-main-window.png DOC_PAGES = \ + account-irc.page \ + account-jabber.page \ + accounts-window.page \ add-account.page \ add-contact.page \ audio-call.page \ |