From d058ec42f339ff9ca62c729496030e6efa7edc19 Mon Sep 17 00:00:00 2001 From: Shaun McCance Date: Fri, 28 Aug 2009 12:24:42 -0500 Subject: [PATCH] [help] Adding information about the Accounts window and IRC --- help/C/account-irc.page | 145 ++++++++++++++++++++++++++++++++++ help/C/account-jabber.page | 62 +++++++++++++++ help/C/accounts-window.page | 38 +++++++++ help/C/figures/gtk-add.png | Bin 0 -> 400 bytes help/C/figures/gtk-edit.png | Bin 0 -> 744 bytes help/C/figures/gtk-remove.png | Bin 0 -> 215 bytes help/C/prob-conn-name.page | 6 +- help/Makefile.am | 3 + 8 files changed, 252 insertions(+), 2 deletions(-) create mode 100644 help/C/account-irc.page create mode 100644 help/C/account-jabber.page create mode 100644 help/C/accounts-window.page create mode 100644 help/C/figures/gtk-add.png create mode 100644 help/C/figures/gtk-edit.png create mode 100644 help/C/figures/gtk-remove.png diff --git a/help/C/account-irc.page b/help/C/account-irc.page new file mode 100644 index 00000000..a77d3a07 --- /dev/null +++ b/help/C/account-irc.page @@ -0,0 +1,145 @@ + + + + + + Shaun McCance + shaunm@gnome.org + + + 2009 + GNOME Documentation Project + + + + + IRC Account Details + +

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.

+ + +

You must have the telepathy-idle package installed + in order to use IRC in Empathy.

+ + + + + <gui>Network</gui> +

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. Empathy lists the most popular networks + in the Network drop-down list. You can add additional + networks. See below.

+ + + <gui>Nickname</gui> +

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 + you will need to change your nickname.

+ + + <gui>Password</gui> +

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.

+ + NickServ Passwords +

On some networks, nicknames can be registered using a service + known as NickServ. Empathy 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 for more + details.

+ + + + <gui>Real name</gui> +

You can provide your real name in addition to your nickname. Other + users will be able to see this when they view your information.

+ + + <gui>Quit message</gui> +

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.

+ + + + + +
+ + IRC Networks + + + Networks + +

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

+ + +

To add a network to the list, click Add.

 +

To modify a network in the list, select the network and click + Edit.

 +

To remove a network from the list, select the network and + click Remove.

 + + +

When adding or modifying a network, you can enter the following + information:

+ + + + <gui>Network</gui> +

This is the name of the network as you want it to appear in + the list of networks.

+ + + <gui>Charset</gui> +

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.

+ +

By default, Empathy 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.

+ + + <gui>Servers</gui> +

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 + Add and Remove buttons.

+

When a server is selected, click the field under Server + or Port to edit it. Alternatively, use the left and right + arrow keys to focus the field, and press the space bar to begin + editing.

+

Select the check box in the SSL 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.

+ + +
+ diff --git a/help/C/account-jabber.page b/help/C/account-jabber.page new file mode 100644 index 00000000..b6ba60a4 --- /dev/null +++ b/help/C/account-jabber.page @@ -0,0 +1,62 @@ + + + + + + Shaun McCance + shaunm@gnome.org + + + 2009 + GNOME Documentation Project + + + + + Jabber Account Details + +

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 Advanced + section. Normally, you will not need to use the advanced options + below. For general instructions on adding an account, see + .

+ + + + <gui>Encryption required (TLS/SSL)</gui> + <gui>Ignore SSL certificate errors</gui> +

Whenever possible, communication between Empathy and + the Jabber server is encrypted. If encrypted communication is not + possible, messages may be sent unencrypted. Select Encryption + required to prevent Empathy from communicating with + the Jabber server when encryption is not possible.

+

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 Ignore SSL + certificate errors to allow encrypted communication with + invalid certificates.

+ + + <gui>Resource</gui> + <gui>Priority</gui> +

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, Empathy will use + Telepathy as the resource.

+

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.

+ + + <gui>Override server settings</gui> +

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

+ + + + diff --git a/help/C/accounts-window.page b/help/C/accounts-window.page new file mode 100644 index 00000000..14e70564 --- /dev/null +++ b/help/C/accounts-window.page @@ -0,0 +1,38 @@ + + + + + + + Add, modify, and delete accounts. + + + Shaun McCance + shaunm@gnome.org + + + 2009 + GNOME Documentation Project + + + + + Accounts Window + +

The Accounts window allows you to add, modify, and delete + accounts.

+ +
+ + + + + Account Details +

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.

+
+ + diff --git a/help/C/figures/gtk-add.png b/help/C/figures/gtk-add.png new file mode 100644 index 0000000000000000000000000000000000000000..c541e6efc84d3ff61e3a49076183d0d5dd6c6f3f GIT binary patch literal 400 zcmV;B0dM|^P)L zQ#($>Kop#@T z%cLqvB(v#cW*r_3NHSe47Dle|vSb9sk?XofZlwp~@z{#v*z!Ejf+d!e)NVV?0=<4H z0PuFUMM|xfBa$ox?ALVp((8wx4<8?%_|3t5HZPo$k{}6=Rf?x4Ljb__%~hUdS#u9onO5laL%FV7IFst;pmq}1vHzn$nx=mj uAo(_#UK03-kR*w5>x{eb8#ImbT6hNsK5INnouuRd0000P)Px#24YJ`L;(K){{a7>y{D4^000SaNLh0L01FZT01FZU(%pXi00007bV*G`2iO7u z78MNEZFL#|0013yMObu0Z*6U5Zgc=ca%Ew3Wn>_CX>@2HRA^-&M@dak?_?!z0006% zNklPRa=bWop)9Cnc zgHk*YBb5Rmg5)kmJY`vLwD#|vJ=6Z0%``eT6icQOvY9e&M&j{BnR+??YiMM!FF(%8 z9em&45iTiZC9%ZfQjAzUO7zDZa|_>zFULs#Ow(|@vAC+D>iW~+{@x7+Mg&3dwU0I$ zqcz58j4^ng$MQ-X%d)7eJ5pQ}+Ir*3z@s_vL?Q)vCr>ruc`g$##t7L( z)Ycx@_Tl5Z9^h?YV2sJ4XpiR8&4?I81Y-oPH5FAAl$3_?Jdf2|d)W^sKD9aRPCi1` zz%c%NjDM+q_8NP7q3GLTW+$fm3lY}F*VNRAsO))Niq)I@g5b=|GzC4#AtY7wDGaW; zILP}iDM=<$s;~zN9LuJ)wGE}R+>1TCI23_P-fud#Kza8o$_~~ev-dH^P=KHS%d#2h ze;j1*jlkz~PSeA-=p3VdYuIqM=j1E6^UAKDu7w7gs@>W7{oKRG2-PLpX as{8>HLpH#oYpqxS0000ERFvuI;uvDl`*xBcSE~Vob9|S($WQmc z^3w0s9D@C!FAN`DS!kiL!(xV}w;ZR-w#r2xH2yL&tk{%Uw^j8n*Uhx(a#4nc!Wk1< za#aMAZCX`7#y=}=UNc4Lr?g^>z79j|{d= + + “Name in use” - An error message which says "Name in use" appears in the main window. + An error message which says “Name in use” appears in the main window. @@ -21,7 +23,7 @@ - I get a message that says "Name in use" + I get a message that says “Name in use”

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 95b218a4..ff79d05e 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 \ -- 2.39.2