1 <page xmlns="http://projectmallard.org/1.0/"
2 xmlns:e="http://projectmallard.org/experimental/"
3 type="topic" style="screen"
7 <revision pkgversion="2.28" version="0.1" date="2009-08-31" status="review">
9 <e:review by="shaunm@gnome.org" date="2009-08-31" status="done"/>
12 <credit type="author">
13 <name>Shaun McCance</name>
14 <email>shaunm@gnome.org</email>
19 <name>GNOME Documentation Project</name>
22 <desc>Additional information necessary for connecting to IRC networks.</desc>
23 <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
26 <title>IRC Account Details</title>
28 <p>IRC accounts require different information than many other types of
29 accounts. To create an IRC account, you must specify at least an IRC
30 network and a nickname. This page details the information you can
31 provide for an IRC account.</p>
33 <note style="info package">
34 <p>You must have the <sys>telepathy-idle</sys> package installed
35 in order to use IRC in <app>Empathy</app>.</p>
40 <title><gui>Network</gui></title>
41 <p>IRC is an open system that allows people to run separate IRC
42 networks. Each network is distinct and has its own users and
43 chat rooms. <app>Empathy</app> lists the most popular networks
44 in the <gui>Network</gui> drop-down list. You can add additional
45 networks. See <link xref="#networks"/> below.</p>
48 <title><gui>Nickname</gui></title>
49 <p>Your nickname is your unique name on the IRC network. Only one
50 person on a network may use a given nickname. If you get an error
51 message that says <link xref="prob-conn-name" role="error-msg"/>
52 you will need to change your nickname.</p>
55 <title><gui>Password</gui></title>
56 <p>Some servers, particularly those on private networks, require
57 a password to connect. If you are authorized to use the network,
58 the network administrators should provide you with a password.</p>
60 <title>NickServ Passwords</title>
61 <p>On some networks, nicknames can be registered using a service
62 known as NickServ. <app>Empathy</app> does not directly support
63 nickname passwords. On some networks, including the popular
64 FreeNode network, server passwords are automatically forwarded
65 to NickServ, allowing you to set this field to identify yourself
66 with NickServ. See <link xref="irc-nick-password"/> for more
71 <title><gui>Real name</gui></title>
72 <p>You can provide your real name in addition to your nickname. Other
73 users will be able to see this when they view your information.</p>
76 <title><gui>Quit message</gui></title>
77 <p>When you go offline, a quit message is sent to all the chat rooms
78 you’re in and to all the users you’re having a private conversation
79 with. Use this field to provide a custom quit message.</p>
87 <section id="networks">
89 <title type="link">IRC Networks</title>
92 <title>Networks</title>
94 <p><app>Empathy</app> includes a list of popular IRC networks. If you
95 wish to another IRC network, you can add it to the list. You can also
96 modify networks and remove them from the list.</p>
99 <item><p>To add a network to the list, click <media type="image"
100 mime="image/png" src="figures/gtk-add.png" width="16"
101 height="16">Add</media>.</p></item>
102 <item><p>To modify a network in the list, select the network and click
103 <media type="image" mime="image/png" src="figures/gtk-edit.png" width="16"
104 height="16">Edit</media>.</p></item>
105 <item><p>To remove a network from the list, select the network and
106 click <media type="image" mime="image/png" src="figures/gtk-remove.png"
107 width="16" height="16">Remove</media>.</p></item>
110 <p>When adding or modifying a network, you can enter the following
115 <title><gui>Network</gui></title>
116 <p>This is the name of the network as you want it to appear in
117 the list of networks.</p>
120 <title><gui>Charset</gui></title>
121 <p>This specifies the character encoding that is typically used on
122 this network. A character encoding is a specific way of recording
123 characters internally in a computer. There are many character
124 encodings, and you need to use the same character encoding as other
125 users to see their messages correctly.</p>
127 Translators: Recommend character encodings that are common
130 <p>By default, <app>Empathy</app> uses UTF-8, a modern character
131 encoding that can handle text from most of the world's languages.
132 Another common encoding for English and some other Western languages
136 <title><gui>Servers</gui></title>
137 <p>An IRC network may have many servers you can connect to. When
138 you are connected to a server on a particular network, you can
139 communicate with all users on all other servers on that network.
140 You can add and remove servers for this network using the
141 <gui>Add</gui> and <gui>Remove</gui> buttons.</p>
142 <p>When a server is selected, click the field under <gui>Server</gui>
143 or <gui>Port</gui> to edit it. Alternatively, use the left and right
144 arrow keys to focus the field, and press the space bar to begin
146 <p>Select the check box in the <gui>SSL</gui> column to encrypt
147 all communication with a server. Note that this does not prevent
148 other users on the network from seeing what you write on public