Mercurial > emacs
annotate doc/misc/rcirc.texi @ 111755:350f17da7963
Document byte-to-string in Lisp manual.
* objects.texi (Symbol Type):
* text.texi (Near Point):
* help.texi (Help Functions):
* functions.texi (Mapping Functions): Use string instead of
char-to-string in examples.
* nonascii.texi (Converting Representations): Document
byte-to-string.
* strings.texi (Creating Strings): Don't mention semi-obsolete
function char-to-string.
(String Conversion): Shorten discussion of semi-obsolete function
string-to-char. Link to Converting Representations.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Sun, 21 Nov 2010 13:07:47 -0500 |
parents | a91e94388547 |
children | 376148b31b5e |
rev | line source |
---|---|
84311 | 1 \input texinfo |
2 @c %**start of header | |
84329
3d431f1997d8
(setfilename): Go up one more level to ../../info.
Glenn Morris <rgm@gnu.org>
parents:
84311
diff
changeset
|
3 @setfilename ../../info/rcirc |
84311 | 4 @settitle rcirc Manual |
5 @c %**end of header | |
6 | |
7 @copying | |
109274
a91e94388547
Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents:
106815
diff
changeset
|
8 Copyright @copyright{} 2006, 2007, 2008, 2009, 2010 |
a91e94388547
Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents:
106815
diff
changeset
|
9 Free Software Foundation, Inc. |
84311 | 10 |
11 @quotation | |
12 Permission is granted to copy, distribute and/or modify this document | |
99709
6de181810d0f
Relicense all texi files under FDL 1.3 or later.
Glenn Morris <rgm@gnu.org>
parents:
96374
diff
changeset
|
13 under the terms of the GNU Free Documentation License, Version 1.3 or |
84311 | 14 any later version published by the Free Software Foundation; with no |
15 Invariant Sections, with the Front-Cover texts being ``A GNU Manual'', | |
16 and with the Back-Cover Texts as in (a) below. A copy of the license is | |
95937
6f0fce2c3559
Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents:
95874
diff
changeset
|
17 included in the section entitled ``GNU Free Documentation License''. |
84311 | 18 |
95874
eafbd7a5c9be
Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents:
92148
diff
changeset
|
19 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and |
eafbd7a5c9be
Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents:
92148
diff
changeset
|
20 modify this GNU manual. Buying copies from the FSF supports it in |
eafbd7a5c9be
Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents:
92148
diff
changeset
|
21 developing GNU and promoting software freedom.'' |
84311 | 22 @end quotation |
23 @end copying | |
24 | |
25 @dircategory Emacs | |
26 @direntry | |
109274
a91e94388547
Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents:
106815
diff
changeset
|
27 * Rcirc: (rcirc). Internet Relay Chat (IRC) client. |
84311 | 28 @end direntry |
29 | |
30 @titlepage | |
31 @title rcirc Manual | |
32 @page | |
33 @vskip 0pt plus 1filll | |
34 @insertcopying | |
35 @end titlepage | |
36 | |
102059
9bcea07061a8
consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents:
100974
diff
changeset
|
37 @contents |
9bcea07061a8
consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents:
100974
diff
changeset
|
38 |
84311 | 39 @ifnottex |
40 @node Top, Basics, (dir), (dir) | |
41 @top rcirc Manual | |
42 | |
43 @code{rcirc} is an Emacs IRC client. | |
44 | |
45 IRC (Internet Relay Chat) is a multi-user chat protocol. Users | |
46 communicate with each other in real-time. Communication occurs both in | |
47 topic channels which are collections of many users, or privately, with | |
48 just one other user. | |
49 | |
102059
9bcea07061a8
consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents:
100974
diff
changeset
|
50 @insertcopying |
9bcea07061a8
consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents:
100974
diff
changeset
|
51 |
9bcea07061a8
consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents:
100974
diff
changeset
|
52 @end ifnottex |
9bcea07061a8
consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents:
100974
diff
changeset
|
53 |
84311 | 54 @menu |
55 * Basics:: | |
56 * Reference:: | |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
57 * Fighting Information Overload:: |
84311 | 58 * Hacking and Tweaking:: |
59 * GNU Free Documentation License:: | |
60 * Key Index:: | |
61 * Variable Index:: | |
62 * Index:: | |
63 | |
64 @detailmenu | |
65 --- The Detailed Node Listing --- | |
66 | |
67 Basics | |
68 | |
69 * Internet Relay Chat:: | |
70 * Getting started with rcirc:: | |
71 | |
72 Reference | |
73 | |
74 * rcirc commands:: | |
75 * Useful IRC commands:: | |
76 * Configuration:: | |
77 | |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
78 Fighting Information Overload |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
79 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
80 * Channels:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
81 * People:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
82 * Keywords:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
83 * Notices:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
84 |
84311 | 85 Hacking and Tweaking |
86 | |
87 * Skipping /away messages using handlers:: | |
88 * Using fly spell mode:: | |
89 * Scrolling conservatively:: | |
90 * Changing the time stamp format:: | |
91 * Defining a new command:: | |
92 * Reconnecting after you have lost the connection:: | |
93 | |
94 @end detailmenu | |
95 @end menu | |
96 | |
97 @node Basics, Reference, Top, Top | |
98 @chapter Basics | |
99 | |
100 This chapter contains a brief introduction to IRC (Internet Relay Chat), | |
101 and a quick tutorial on @code{rcirc}. | |
102 | |
103 @menu | |
104 * Internet Relay Chat:: | |
105 * Getting started with rcirc:: | |
106 @end menu | |
107 | |
108 @node Internet Relay Chat, Getting started with rcirc, Basics, Basics | |
109 @section Internet Relay Chat | |
110 @cindex internet relay chat | |
111 @cindex irc | |
112 | |
113 @cindex channel | |
114 @dfn{Internet Relay Chat} (IRC) is a form of instant communication over the | |
115 Internet. It is mainly designed for group (many-to-many) communication | |
116 in discussion forums called channels, but also allows one-to-one | |
117 communication. | |
118 | |
119 @cindex instant messaging, comparison | |
120 @cindex server | |
121 @cindex network | |
122 Contrary to most Instant Messenger (IM) systems, users usually don't | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
123 connect to a central server. Instead, users connect to a random |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
124 server in a network, and servers relay messages from one to the next. |
84311 | 125 |
126 Here's a typical example: | |
127 | |
128 @cindex redirection to random servers | |
129 When you connect to the Freenode network | |
130 (@code{http://freenode.net/}), you point your IRC client at the | |
131 server @code{irc.freenode.net}. That server will redirect your client | |
132 to a random server on the network, such as @code{zelazny.freenode.net}. | |
133 | |
134 @cindex channel name | |
135 @cindex # starts a channel name | |
136 Once you're connected, you can send messages to all other users | |
137 connected to the same network, and you can join all channels on the same | |
138 network. You might join the @code{#emacs} and the @code{#rcirc} | |
139 channels, for example. (Typically, channel names begin with a hash | |
140 character.) | |
141 | |
142 Once you have joined a channel, anything you type will be broadcast to | |
143 all the other users on the same channel. | |
144 | |
145 @cindex addressing other people | |
146 @cindex other people, addressing them | |
147 @cindex talk to other people | |
148 If you want to address someone specifically, for example as an answer to | |
149 a question, it is customary to prefix the message with the nick followed | |
150 by a colon, like this: | |
151 | |
152 @example | |
153 deego: fsbot rules! | |
154 @end example | |
155 | |
156 @cindex nick completion | |
157 @cindex completion of nicks | |
158 @kindex TAB | |
159 Since this is so common, you can use @key{TAB} to do nick completion. | |
160 | |
161 @node Getting started with rcirc, , Internet Relay Chat, Basics | |
162 @section Getting started with rcirc | |
163 @cindex getting started | |
164 @cindex connecting to a server | |
165 | |
166 @cindex irc command | |
167 Use the command @kbd{M-x irc} to connect using the defaults. | |
168 @xref{Configuration}, if you want to change the defaults. | |
169 | |
170 Use @kbd{C-u M-x irc} if you don't want to use the defaults, eg. if you | |
171 want to connect to a different network, or connect to the same network | |
172 using a different nick. This will prompt you for four things: | |
173 | |
174 @table @asis | |
175 @cindex server, connecting | |
176 @cindex Freenode network | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
177 @item IRC Server |
84311 | 178 What server do you want to connect to? All the servers in a particular |
179 network are equivalent. Some networks use a round-robin system where a | |
180 single server redirects new connections to a random server in the | |
181 network. @code{irc.freenode.net} is such a server for the Freenode | |
182 network. Freenode provides the network ``for the Free and Open Source | |
96372
4a78563eb87f
American English spelling fix.
Glenn Morris <rgm@gnu.org>
parents:
95937
diff
changeset
|
183 Software communities, for not-for-profit organizations and for related |
84311 | 184 communities and organizations.'' |
185 | |
186 @cindex port, connecting | |
187 @cindex 6667, default IRC port | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
188 @item IRC Port |
84311 | 189 All network connections require a port. Just as web servers and clients |
190 use port 80 per default, IRC uses port 6667 per default. You rarely | |
191 have to use a different port. | |
192 | |
193 @cindex nick, connecting | |
194 @cindex changing nick | |
195 @cindex name changes | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
196 @item IRC Nick |
84311 | 197 @vindex user-login-name |
198 Every users needs a handle on-line. You will automatically be assigned | |
199 a slightly different nick if your chosen nick is already in use. If | |
200 your @code{user-login-name} is @code{alex}, and this nick is already | |
201 in use, you might for example get assigned the nick @code{alex`}. | |
202 | |
203 @cindex channels, connecting | |
204 @cindex initial channels | |
205 @cindex startup channels | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
206 @item IRC Channels |
84311 | 207 A space separated list of channels you want to join when connecting. |
208 You don't need to join any channels, if you just want to have one-to-one | |
209 conversations with friends on the same network. If you're new to the | |
210 Freenode network, join @code{#emacs}, the channel about all things | |
211 Emacs, or join @code{#rcirc}, the channel about @code{rcirc}. | |
212 @end table | |
213 | |
214 @cindex server buffer | |
215 When you have answered these questions, @code{rcirc} will create a server | |
216 buffer, which will be named something like @code{*irc.freenode.net*}, | |
217 and a channel buffer for each of the channels you wanted to join. | |
218 | |
219 @kindex RET | |
220 @cindex talking | |
221 @cindex communicating | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
222 To talk in a channel, just type what you want to say in a channel |
84311 | 223 buffer, and press @key{RET}. |
224 | |
225 @kindex C-c C-c | |
226 @cindex multiline messages | |
227 @cindex messages, multiple lines | |
228 @cindex pasting multiple lines | |
229 @cindex edit message before sending | |
230 If you want to paste multiple lines, such as source code, you can use | |
231 @kbd{C-c C-c} to edit your message in a separate buffer. Use @kbd{C-c | |
232 C-c} to finish editing. You still need to press @key{RET} to send it, | |
233 though. Generally, IRC users don't like people pasting more than around | |
234 four lines of code, so use with care. | |
235 | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
236 @comment This section copied from the Channels section. |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
237 @comment All index markers should point to the original! |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
238 Once you are connected to multiple channels, or once you've turned you |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
239 attention to other buffers in Emacs, you probably want to be notified |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
240 of any activity in channels not currently visible. All you need to do |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
241 is switch channel tracking on using @kbd{M-x rcirc-track-minor-mode}. |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
242 To make this permanent, add the following to your init file: |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
243 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
244 @example |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
245 (rcirc-track-minor-mode 1) |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
246 @end example |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
247 |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
248 Use @kbd{C-c C-@key{SPC}} to switch to these buffers. |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
249 |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
250 @node Reference, Fighting Information Overload, Basics, Top |
84311 | 251 @chapter Reference |
252 @cindex reference | |
253 | |
254 This is the reference section of the manual. It is not complete. For | |
255 complete listings of @code{rcirc} features, use Emacs built-in | |
256 documentation. | |
257 | |
258 @menu | |
259 * rcirc commands:: | |
260 * Useful IRC commands:: | |
261 * Configuration:: | |
262 @end menu | |
263 | |
264 @node rcirc commands, Useful IRC commands, Reference, Reference | |
265 @section rcirc commands | |
266 @cindex rcirc commands | |
267 @cindex commands | |
268 | |
269 @kindex C-h m | |
270 This is a list of commands that you may use in @code{rcirc}. It is not | |
271 complete. For a complete listing, press @kbd{C-h m} in an @code{rcirc} | |
272 buffer. | |
273 | |
274 In addition to using regular Emacs key bindings, you can call them by | |
275 typing them into an @code{rcirc} buffer. | |
276 | |
277 @cindex call commands | |
278 @cindex typing commands | |
279 @cindex commands | |
280 For instance, instead of using the command @kbd{C-c C-j} to join a new | |
281 channel, you may type this in an @code{rcirc} buffer, and press @key{RET}: | |
282 | |
283 @example | |
284 /join #emacs | |
285 @end example | |
286 | |
287 @cindex / starts a command | |
288 @cindex messages starting with a slash disappear | |
289 @cindex disappearing messages if starting with a slash | |
290 @cindex slash hides message | |
291 This is why you cannot start a message with a slash. You will have to | |
292 precede the command with a space, or rewrite your message in order to | |
293 send it to a channel. | |
294 | |
295 @cindex multiple words as parameters | |
296 @cindex string delimiters | |
297 @cindex quotes | |
298 @cindex double-quotes | |
299 Many commands take parameters. IRC commands usually ignore string | |
300 delimiters. Neither quote nor double-quote have special meanings in | |
301 IRC. | |
302 | |
303 @example | |
304 /nick "alex schroeder" | |
305 @end example | |
306 | |
307 This will try to change your nick to @code{"alex}. Usually this will | |
92148 | 308 fail because the double quote character is not a valid character for |
84311 | 309 nicks. |
310 | |
311 @cindex case insensitive commands | |
312 These commands are case insensitive. | |
313 | |
314 @cindex new command | |
315 @cindex unknown command | |
316 @cindex command unknown | |
317 If a command isn't known by @code{rcirc}, it will simply be sent along to the | |
318 server. There is a list of some useful commands like that in the next | |
319 section. | |
320 | |
321 @table @kbd | |
322 @item C-c C-j | |
323 @kindex C-c C-j | |
324 @cindex /join | |
325 @cindex join channels | |
326 @cindex other channels | |
327 @cindex rooms, joining | |
328 @cindex discussion, joining | |
329 This joins a channel such as @code{#rcirc} or @code{#emacs}. On most | |
330 networks, anybody can create new channels. If you want to talk with | |
331 some friends, for example, all you have to do is agree on a valid | |
332 channel name and join that channel. (Also @code{/join #emacs}.) | |
333 | |
334 @item C-c C-p | |
335 @kindex C-c C-p | |
336 @cindex /part | |
337 @cindex part a channel | |
338 @cindex leave a channel | |
339 @cindex disconnect from a channel | |
340 @cindex stop talking on a channel | |
341 @cindex kill channel buffer | |
342 This leaves the current channel. You can optionally provide a reason | |
343 for parting. When you kill a channel buffer, you automatically part the | |
344 corresponding channel. (Also @code{/part you are too weird!}.) | |
345 | |
346 @item C-c C-r | |
347 @kindex C-c C-r | |
348 @cindex /nick | |
349 @cindex change name | |
350 @cindex nick changing | |
351 @cindex rename yourself | |
352 @cindex other name | |
353 This changes your nick to some other name. Your nick must be unique | |
354 across the network. Most networks don't allow too many nick changes in | |
355 quick succession, and have restrictions on the valid characters in nick | |
356 names. (Also @code{/nick alex-test}) | |
357 | |
358 @item C-c C-w | |
359 @kindex C-c C-w | |
360 @cindex /whois | |
361 @cindex who are these people | |
362 @cindex identifying people | |
363 @cindex channels other people are on | |
364 @cindex what channels people are on | |
365 Gives you some basic information about a nick. This often includes what | |
366 other channels people are on. (Also @code{/whois fsbot}.) | |
367 | |
368 @item C-c C-q | |
369 @kindex C-c C-q | |
370 @cindex /query | |
371 @cindex starting a private conversation | |
372 @cindex one-to-one conversation | |
373 @cindex talk privately | |
374 @cindex private conversation | |
375 @cindex contact one person only | |
376 @cindex query a person | |
377 Starts a one-to-one conversation with another person on the same | |
378 network. A new buffer will be created for this conversation. It works | |
379 like a channel with only two members. (Also @code{/query fsbot}.) | |
380 | |
381 @item C-c @key{RET} | |
382 @kindex C-c RET | |
383 @cindex /msg | |
384 @cindex single message | |
385 @cindex message sending | |
386 This sends a single message to a nick. Like with @kbd{C-c C-q}, a new | |
387 buffer is created, where the response from the other party will show | |
388 up. (Also @code{/msg nickserv identify secret}.) | |
389 | |
390 @item C-c C-x | |
391 @kindex C-c C-x | |
392 @cindex /quit | |
393 @cindex quit | |
394 @cindex disconnect | |
395 @cindex kill connection | |
396 @cindex connection end | |
397 @cindex part all channels | |
398 @cindex end connection | |
399 @cindex server buffer killing | |
400 @cindex reason for quitting | |
401 This disconnects from the server and parts all channels. You can | |
402 optionally provide a reason for quitting. When you kill the server | |
403 buffer, you automatically quit the server and part all channels. (Also | |
404 @code{/quit ZZZzzz...}.) | |
405 @end table | |
406 | |
407 @node Useful IRC commands, Configuration, rcirc commands, Reference | |
408 @section Useful IRC commands | |
409 @cindex irc commands | |
410 @cindex commands | |
411 | |
412 As mentioned, if a command isn't known by @code{rcirc}, it will simply be sent | |
413 along to the server. Some such commands are available on nearly all IRC | |
414 servers, such as: | |
415 | |
416 @table @code | |
417 @item /away | |
418 @cindex /away | |
419 @cindex away status | |
420 @cindex pause status | |
421 @cindex unavailable status | |
422 @cindex set away status | |
423 This sets your status as ``being away'' if you provide a reason, or sets | |
424 your status as ``being back'' if you do not. People can use the | |
425 @kbd{C-c C-w} command to check your status. Example: @code{/away food}. | |
426 @end table | |
427 | |
428 @cindex irc resources | |
429 @cindex help about irc | |
430 Typical IRC servers implement many more commands. You can read more | |
431 about the fantastic world of IRC online at | |
432 @uref{http://www.irchelp.org/, the Internet Relay Chat (IRC) help | |
433 archive}. | |
434 | |
435 @node Configuration, , Useful IRC commands, Reference | |
436 @section Configuration | |
437 @cindex configuring rcirc | |
438 | |
439 These are some variables you can change to configure @code{rcirc} to your | |
440 liking. | |
441 | |
442 @table @code | |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
443 @item rcirc-server-alist |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
444 @vindex rcirc-server-alist |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
445 @cindex channels, configuration |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
446 @cindex initial channels, configuration |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
447 @cindex startup channels, configuration |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
448 @cindex servers, configuration |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
449 @cindex initial servers, configuration |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
450 @cindex startup servers, configuration |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
451 This variable contains an alist of servers to connect to by default |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
452 and the keywords parameters to use. The keyword parameters are |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
453 optional. If you don't provide any, the defaults as documented below |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
454 will be used. |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
455 |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
456 The most important parameter is the @code{:channels} parameter. It |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
457 controls which channels you will join by default as soon as you are |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
458 connected to the server. |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
459 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
460 Here's an example of how to set it: |
84311 | 461 |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
462 @example |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
463 (add-to-list 'rcirc-server-alist |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
464 '("otherworlders.org" |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
465 :channels ("#FUDGE" "#game-design"))) |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
466 @end example |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
467 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
468 By default you will be connected to the @code{rcirc} support channel: |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
469 @code{#rcirc} on @code{irc.freenode.net}. |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
470 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
471 @table @code |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
472 @item :nick |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
473 This overrides @code{rcirc-default-nick}. |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
474 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
475 @item :port |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
476 This overrides @code{rcirc-default-port}. |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
477 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
478 @item :user-name |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
479 This overrides @code{rcirc-default-user-name}. |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
480 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
481 @item :full-name |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
482 This overrides @code{rcirc-default-full-name}. |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
483 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
484 @item :channels |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
485 This describes which channels to join when connecting to the server. |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
486 If absent, no channels will be connected to automatically. |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
487 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
488 @end table |
84311 | 489 |
490 @item rcirc-default-nick | |
491 @vindex rcirc-default-nick | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
492 This variable is used for the default nick. It defaults to the login |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
493 name returned by @code{user-login-name}. |
84311 | 494 |
495 @example | |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
496 (setq rcirc-default-nick "kensanata") |
84311 | 497 @end example |
498 | |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
499 @item rcirc-default-port |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
500 @vindex rcirc-default-port |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
501 @cindex port |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
502 This variable contains the default port to connect to. It is 6667 by |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
503 default and rarely needs changing. |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
504 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
505 @item rcirc-default-user-name |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
506 @vindex rcirc-default-user-name |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
507 @cindex user name |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
508 This variable contains the default user name to report to the server. |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
509 It defaults to the login name returned by @code{user-login-name}, just |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
510 like @code{rcirc-default-nick}. |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
511 |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
512 @item rcirc-default-user-full-name |
84311 | 513 @vindex rcirc-default-user-full-name |
514 @cindex full name | |
515 @cindex real name | |
516 @cindex surname | |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
517 This variable is used to set your ``real name'' on IRC. It defaults |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
518 to the name returned by @code{user-full-name}. If you want to hide |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
519 your full name, you might want to set it to some pseudonym. |
84311 | 520 |
521 @example | |
522 (setq rcirc-default-user-full-name "Curious Minds Want To Know") | |
523 @end example | |
524 | |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
525 @item rcirc-authinfo |
84311 | 526 @vindex rcirc-authinfo |
527 @cindex authentification | |
528 @cindex identification | |
529 @cindex nickserv | |
530 @cindex login | |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
531 This variable is an alist used to automatically identify yourself on |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
532 networks. Each sublist starts with a regular expression that is |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
533 compared to the server address you're connecting to. The second |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
534 element in the list is a symbol representing the method to use, |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
535 followed by the arguments this method requires. |
84311 | 536 |
537 Here is an example to illustrate how you would set it: | |
538 | |
539 @example | |
540 (setq rcirc-authinfo | |
541 '(("freenode" nickserv "bob" "p455w0rd") | |
542 ("freenode" chanserv "bob" "#bobland" "passwd99") | |
543 ("bitlbee" bitlbee "robert" "sekrit"))) | |
544 @end example | |
545 | |
546 And here are the valid method symbols and the arguments they require: | |
547 | |
548 @table @code | |
549 @item nickserv | |
550 @cindex nickserv authentification | |
551 Use this symbol if you need to identify yourself as follows when | |
552 connecting to a network: @code{/msg nickserv identify secret}. The | |
553 necessary arguments are the nickname you want to use this for, and the | |
554 password to use. | |
555 | |
556 Before you can use this method, you will have to register your nick and | |
557 pick a password for it. Contact @code{nickserv} and check out the | |
558 details. (Using @code{/msg nickserv help}, for example.) | |
559 | |
560 @item chanserv | |
561 @cindex chanserv authentification | |
562 Use this symbol if you need to identify yourself as follows if you want | |
563 to join a particular channel: @code{/msg chanserv identify #underground | |
564 secret}. The necessary arguments are the nickname and channel you want | |
565 to use this for, and the password to use. | |
566 | |
567 Before you can use this method, a channel contact must tell you about | |
568 the password to use. Contact @code{chanserv} and check out the details. | |
569 (Using @code{/msg chanserv help}, for example.) | |
570 | |
571 @item bitlbee | |
572 @cindex bitlbee authentification | |
573 Use this symbol if you need to identify yourself in the Bitlbee channel | |
574 as follows: @code{identify secret}. The necessary arguments are the | |
575 nickname you want to use this for, and the password to use. | |
576 | |
577 @cindex gateway to other IM services | |
578 @cindex instant messaging, other services | |
579 @cindex Jabber | |
580 @cindex AIM | |
581 @cindex ICQ | |
582 @cindex MSN | |
583 @cindex Yahoo! | |
584 Bitlbee acts like an IRC server, but in fact it is a gateway to a lot of | |
585 other instant messaging services. You can either install Bitlbee | |
586 locally or use a public Bitlbee server. There, you need to create an | |
587 account with a password. This is the nick and password you need to | |
588 provide for the bitlbee authentification method. | |
589 | |
590 Later, you will tell Bitlbee about your accounts and passwords on all | |
591 the other instant messaging services, and Bitlbee will log you in. All | |
592 @code{rcirc} needs to know, is the login to your Bitlbee account. Don't | |
593 confuse the Bitlbee account with all the other accounts. | |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
594 |
84311 | 595 @end table |
596 | |
87351
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
597 @end table |
ff3b31ef10b4
(Configuration): Document rcirc-server-alist, remove
Alex Schroeder <alex@gnu.org>
parents:
87344
diff
changeset
|
598 |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
599 @node Fighting Information Overload, Hacking and Tweaking, Reference, Top |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
600 @chapter Fighting Information Overload |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
601 @cindex information overload |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
602 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
603 This is the section of the manual that caters to the busy person |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
604 online. There are support channels with several hundred people in |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
605 them. Trying to follow a conversation in these channels can be a |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
606 daunting task. This chapters tells you how @code{rcirc} can help. |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
607 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
608 @menu |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
609 * Channels:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
610 * People:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
611 * Keywords:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
612 * Notices:: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
613 @end menu |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
614 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
615 @node Channels, People, Fighting Information Overload, Fighting Information Overload |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
616 @section Channels |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
617 @cindex channels |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
618 @cindex modeline |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
619 |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
620 @comment This section copied to the Getting started with rcirc section |
84311 | 621 @kindex C-c C-SPC |
622 @vindex rcirc-track-minor-mode | |
623 @cindex switching channels | |
624 @cindex tracking activity | |
625 @cindex active channel | |
626 @cindex abbreviated channel names | |
627 @cindex modeline tracks activity | |
628 Most people want a notification when something is said on a channel they | |
629 have joined, particularly if they have been addressed directly. There | |
630 is a global minor mode that will do this kind of tracking for you. All | |
631 you need to do is switch it on using @kbd{M-x rcirc-track-minor-mode}. | |
632 To make this permanent, add the following to your init file: | |
633 | |
634 @example | |
635 (rcirc-track-minor-mode 1) | |
636 @end example | |
637 | |
638 When other people say things in buffers that are currently buried (no | |
639 window is showing them), the mode line will now show you the abbreviated | |
640 channel or nick name. Use @kbd{C-c C-@key{SPC}} to switch to these | |
641 buffers. | |
642 | |
643 @vindex rcirc-mode-hook | |
644 If you prefer not to load @code{rcirc} immediately, you can delay the | |
645 activation of this mode: | |
646 | |
647 @example | |
648 (add-hook 'rcirc-mode-hook | |
649 (lambda () | |
650 (rcirc-track-minor-mode 1))) | |
651 @end example | |
652 | |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
653 @cindex busy channels |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
654 If you've joined a very active support channel, tracking activity is |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
655 no longer useful. The channel will be always active. Switching to |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
656 active channels using @kbd{C-c C-@key{SPC}} no longer works as |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
657 expected. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
658 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
659 @kindex C-c C-l |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
660 @cindex low priority channels |
102151
328f4b370b74
Remove duplicate words.
Juanma Barranquero <lekktu@gmail.com>
parents:
102059
diff
changeset
|
661 The solution is to mark this channel as a low priority channel. |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
662 Use @kbd{C-c C-l} to make the current channel a low-priority channel. |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
663 Low priority channels have the modeline indicator ``LowPri''. |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
664 @kbd{C-c C-@key{SPC}} will not switch to low priority channels unless |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
665 you use the @kbd{C-u} prefix. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
666 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
667 @kindex C-c TAB |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
668 @cindex ignored channels |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
669 If you prefer a channel to never show up in the modeline, then you |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
670 have to ignore it. Use @kbd{C-c @key{TAB}} to ignore the current |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
671 channel. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
672 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
673 @node People, Keywords, Channels, Fighting Information Overload |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
674 @section People |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
675 @cindex people, how to ignore |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
676 @cindex nicks, how to ignore |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
677 @cindex friends |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
678 @cindex buddies |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
679 @cindex trolls |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
680 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
681 The most important command available to the discerning IRC user is |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
682 @code{/ignore}. It's the big equalizer online: If people aggravate |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
683 you, just ignore them. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
684 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
685 This is of course a crude all-or-nothing solution. Fear not, |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
686 @code{rcirc} offers alternatives: You can ``brighten'' your buddies |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
687 and ``dim'' certain other nicks that you don't want to ignore |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
688 altogether. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
689 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
690 @table @code |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
691 @item /ignore |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
692 @cindex /ignore |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
693 @cindex ignoring other people |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
694 @cindex trolls, ignoring |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
695 @cindex hide some posts |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
696 @cindex idiots online |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
697 This command toggles the ignore status of a nick, if you provide one. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
698 If you don't provide a nick, the command lists all the nicks you are |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
699 ignoring. All messages by ignored nicks are---you guessed it---ignored. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
700 Since only ``operators'' can kick people from channels, the |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
701 ignore command is often the only way to deal with some of the more |
87357
524874ca5949
(People): Changed /ignore example.
Alex Schroeder <alex@gnu.org>
parents:
87353
diff
changeset
|
702 obnoxious fellows online. Example: @code{/ignore rudybot}. |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
703 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
704 @item /bright |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
705 @cindex /bright |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
706 @cindex highlight other people |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
707 @cindex friends, highlight |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
708 @cindex buddies, highlight |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
709 @cindex nicks, highlight |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
710 @cindex brighten nicks |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
711 This command toggles the bright status of a nick, if you provide one. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
712 If you don't provide a nick, the command lists all the ``brightened'' |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
713 nicks. All messages by brightened nicks are---you guessed |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
714 it---brightened. Use this for your friends. Example: @code{/bright |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
715 rcy}. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
716 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
717 @item /dim |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
718 @cindex /dim |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
719 @cindex soft-ignore other people |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
720 @cindex obnoxious people online |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
721 @cindex rabble online |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
722 This command toggles the dim status of a nick, if you provide one. If |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
723 you don't provide a nick, the command lists all the ``dimmed'' nicks. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
724 All messages by dimmed nicks are---you guessed it---dimmed. Use this |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
725 for boring people and bots. If you are tracking channel activity, |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
726 messages by dimmed nicks will not register as activity. Example: |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
727 @code{/dim fsbot}. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
728 @end table |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
729 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
730 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
731 @node Keywords, Notices, People, Fighting Information Overload |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
732 @section Keywords |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
733 @cindex keywords |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
734 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
735 On a busy channel, you might want to ignore all activity (using |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
736 @kbd{C-c @key{TAB}}) and just watch for certain keywords. The |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
737 following command allows you to highlight certain keywords: |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
738 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
739 @table @code |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
740 @item /keyword |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
741 @cindex /keyword |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
742 This command toggles the highlighting of a keyword, if you provide |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
743 one. If you don't provide a keyword, the current keywords are |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
744 listed. Example: @code{/keyword manual}. |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
745 @end table |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
746 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
747 @node Notices, , Keywords, Fighting Information Overload |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
748 @section Notices |
102151
328f4b370b74
Remove duplicate words.
Juanma Barranquero <lekktu@gmail.com>
parents:
102059
diff
changeset
|
749 @cindex part notices, how to omit |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
750 @cindex join notices, how to omit |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
751 @cindex quit notices, how to omit |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
752 @cindex nick notices, how to omit |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
753 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
754 @kindex C-c C-o |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
755 @cindex low priority channels |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
756 In busy channels you might not be interested in all the joining, |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
757 parting, quitting, and renaming that goes on. You can omit those |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
758 notices using @kbd{C-c C-o}. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
759 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
760 @vindex rcirc-omit-responses |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
761 @cindex away notices, how to omit |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
762 You can control which notices get omitted via the |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
763 @code{rcirc-omit-responses} variable. Here's an example of how to |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
764 omit away messages: |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
765 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
766 @example |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
767 (setq rcirc-omit-responses '("JOIN" "PART" "QUIT" "NICK" "AWAY)) |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
768 @end example |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
769 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
770 @vindex rcirc-omit-threshold |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
771 Notice that these messages will not be omitted if the nick in question |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
772 has recently been active. After all, you don't want to continue a |
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
773 conversation with somebody who just left. That's why @code{rcirc} |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
774 checks recent lines in the buffer to figure out if a nick has been |
87353
941447179902
Changed single spaces after sentence end to double
Alex Schroeder <alex@gnu.org>
parents:
87351
diff
changeset
|
775 active and only omits a message if the nick has not been active. The |
87344
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
776 window @code{rcirc} considers is controlled by the |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
777 @code{rcirc-omit-threshold} variable. |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
778 |
fd687ec7715d
(Top): Fighting Information Overload chapter added.
Alex Schroeder <alex@gnu.org>
parents:
84329
diff
changeset
|
779 @node Hacking and Tweaking, GNU Free Documentation License, Fighting Information Overload, Top |
84311 | 780 @chapter Hacking and Tweaking |
781 @cindex hacking and tweaking | |
782 | |
783 Here are some examples of stuff you can do to configure @code{rcirc}. | |
784 | |
785 @menu | |
786 * Skipping /away messages using handlers:: | |
787 * Using fly spell mode:: | |
788 * Scrolling conservatively:: | |
789 * Changing the time stamp format:: | |
790 * Defining a new command:: | |
791 * Reconnecting after you have lost the connection:: | |
792 @end menu | |
793 | |
794 @node Skipping /away messages using handlers, Using fly spell mode, Hacking and Tweaking, Hacking and Tweaking | |
795 @section Skipping @code{/away} messages using handlers | |
796 @cindex /away messages | |
797 | |
798 @cindex handlers | |
799 @cindex status codes | |
800 The IRC protocol specifies how certain events are signaled from server | |
801 to client. These events have numbers and are dealt with using so-called | |
802 handlers. You can override existing handlers by exploiting the naming | |
803 convention adopted for @code{rcirc}. | |
804 | |
805 Here's how to stop @code{rcirc} from printing @code{/away} messages. | |
806 Since @code{rcirc} doesn't define a 301 handler, you don't need to | |
807 require @code{rcirc} before defining the handler: | |
808 | |
809 @example | |
810 (defun rcirc-handler-301 (process cmd sender args) | |
811 "/away message handler.") | |
812 @end example | |
813 | |
814 @node Using fly spell mode, Scrolling conservatively, Skipping /away messages using handlers, Hacking and Tweaking | |
815 @section Using fly spell mode | |
816 @cindex fly spell | |
817 @cindex spelling | |
818 @cindex spell-checking as you type | |
819 @cindex automatic spelling | |
820 @vindex rcirc-mode-hook | |
821 | |
822 The following code activates Fly Spell Mode | |
823 for @code{rcirc} buffers: | |
824 | |
825 @example | |
826 (add-hook 'rcirc-mode-hook (lambda () | |
827 (flyspell-mode 1))) | |
828 @end example | |
829 | |
830 @xref{Spelling, , Flyspell mode, emacs, The GNU Emacs Manual}, | |
831 for details. | |
832 | |
833 @node Scrolling conservatively, Changing the time stamp format, Using fly spell mode, Hacking and Tweaking | |
834 @section Scrolling conservatively | |
835 @cindex input line | |
836 @cindex scrolling | |
837 @vindex scroll-conservatively | |
838 @vindex rcirc-mode-hook | |
839 | |
840 IRC buffers are constantly growing. If you want to see as much as | |
841 possible at all times, you would want the prompt at the bottom of the | |
842 window when possible. The following snippet uses a local value for | |
843 @code{scroll-conservatively} to achieve this: | |
844 | |
845 @example | |
846 (add-hook 'rcirc-mode-hook | |
847 (lambda () | |
848 (set (make-local-variable 'scroll-conservatively) | |
849 8192))) | |
850 @end example | |
851 | |
852 @xref{Scrolling, , Scrolling conservatively, emacs, The GNU Emacs | |
853 Manual}, for details. | |
854 | |
855 @node Changing the time stamp format, Defining a new command, Scrolling conservatively, Hacking and Tweaking | |
856 @section Changing the time stamp format | |
857 @cindex time stamp | |
858 @cindex date time | |
859 @cindex format time stamp | |
860 @vindex rcirc-time-format | |
861 | |
862 @code{rcirc-time-format} is the format used for the time stamp. Here's | |
863 how to include the date in the time stamp: | |
864 | |
865 @example | |
866 (setq rcirc-time-format "%Y-%m-%d %H:%M ") | |
867 @end example | |
868 | |
869 @node Defining a new command, Reconnecting after you have lost the connection, Changing the time stamp format, Hacking and Tweaking | |
870 @section Defining a new command | |
871 @cindex defining commands | |
872 @cindex commands, defining | |
873 @cindex new commands, defining | |
874 | |
875 Here's a simple new command, @code{/sv}. With it, you can boast about | |
876 your IRC client. It shows how you can use @code{defun-rcirc-command} to | |
877 define new commands. | |
878 | |
879 We're waiting for the definition of this command until @code{rcirc} is loaded | |
880 because @code{defun-rcirc-command} is not yet available, and without | |
881 @code{rcirc} loaded, the command wouldn't do us much good anyway. | |
882 | |
883 @smallexample | |
884 (eval-after-load 'rcirc | |
885 '(defun-rcirc-command sv (arg) | |
886 "Boast about rcirc." | |
887 (interactive "i") | |
888 (rcirc-send-message process target | |
889 (concat "I use " rcirc-id-string)))) | |
890 @end smallexample | |
891 | |
892 @node Reconnecting after you have lost the connection, , Defining a new command, Hacking and Tweaking | |
893 @section Reconnecting after you have lost the connection | |
894 @cindex reconnecting | |
895 @cindex disconnecting servers, reconnecting | |
896 | |
897 If you're chatting from a laptop, then you might be familiar with this | |
898 problem: When your laptop falls asleep and wakes up later, your IRC | |
96374
0f44fb08e72f
American English spelling fix.
Glenn Morris <rgm@gnu.org>
parents:
96372
diff
changeset
|
899 client doesn't realize that it has been disconnected. It takes several |
84311 | 900 minutes until the client decides that the connection has in fact been |
901 lost. The simple solution is to use @kbd{M-x rcirc}. The problem is | |
902 that this opens an @emph{additional} connection, so you'll have two | |
903 copies of every channel buffer --- one dead and one live. | |
904 | |
905 The real answer, therefore, is a @code{/reconnect} command: | |
906 | |
907 @smallexample | |
908 (eval-after-load 'rcirc | |
909 '(defun-rcirc-command reconnect (arg) | |
910 "Reconnect the server process." | |
911 (interactive "i") | |
912 (unless process | |
913 (error "There's no process for this target")) | |
914 (let* ((server (car (process-contact process))) | |
915 (port (process-contact process :service)) | |
916 (nick (rcirc-nick process)) | |
917 channels query-buffers) | |
918 (dolist (buf (buffer-list)) | |
919 (with-current-buffer buf | |
920 (when (eq process (rcirc-buffer-process)) | |
921 (remove-hook 'change-major-mode-hook | |
922 'rcirc-change-major-mode-hook) | |
923 (if (rcirc-channel-p rcirc-target) | |
924 (setq channels (cons rcirc-target channels)) | |
925 (setq query-buffers (cons buf query-buffers)))))) | |
926 (delete-process process) | |
927 (rcirc-connect server port nick | |
928 rcirc-default-user-name | |
929 rcirc-default-user-full-name | |
930 channels)))) | |
931 @end smallexample | |
932 | |
933 @node GNU Free Documentation License, Key Index, Hacking and Tweaking, Top | |
934 @appendix GNU Free Documentation License | |
935 @include doclicense.texi | |
936 | |
937 | |
938 @node Key Index, Variable Index, GNU Free Documentation License, Top | |
939 @unnumbered Key Index | |
940 @printindex ky | |
941 | |
942 @node Variable Index, Index, Key Index, Top | |
943 @unnumbered Variable Index | |
944 @printindex vr | |
945 | |
946 @node Index, , Variable Index, Top | |
947 @unnumbered Index | |
948 @printindex cp | |
949 | |
950 @bye | |
951 | |
952 @ignore | |
953 arch-tag: 2589e562-3843-4ffc-8c2f-477cbad57c01 | |
954 @end ignore |