annotate doc/misc/rcirc.texi @ 98036:70619fdc3dac

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