Revised.
[riece] / doc / riece-ja.texi
1 \input texinfo                  @c -*- mode: texinfo; coding: iso-2022-jp -*-
2 @c %**start of header
3 @setfilename riece-ja.info
4 @settitle Riece -- An IRC client for Emacsen --
5 @c %**end of header
6 @set VERSION 0.0.3
7 @c @documentlanguage ja
8
9 @dircategory GNU Emacs Lisp
10 @direntry
11 * Riece-ja: (riece-ja).   An IRC client for Emacsen
12 @end direntry
13
14 @ifinfo
15 This file describes Riece.
16
17 Copyright (C) 2003 Daiki Ueno.
18
19 Permission is granted to copy, distribute and/or modify this document
20 under the terms of the GNU Free Documentation License, Version 1.1 or
21 any later version published by the Free Software Foundation; with no
22 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
23 Texts.  A copy of the license is included in the section entitled "GNU
24 Free Documentation License".
25 @end ifinfo
26
27 @tex
28
29 @titlepage
30 @title Riece
31
32 @author by Daiki Ueno
33 @page
34
35 @vskip 0pt plus 1filll
36 Copyright @copyright{} 2003 Daiki Ueno.
37
38 Permission is granted to copy, distribute and/or modify this document
39 under the terms of the GNU Free Documentation License, Version 1.1 or
40 any later version published by the Free Software Foundation; with no
41 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
42 Texts.  A copy of the license is included in the section entitled "GNU
43 Free Documentation License".
44 @end titlepage
45 @page
46
47 @end tex
48
49 @node Top, Overview, (dir), (dir)
50 @top Riece user's manual
51
52 Riece \e$B$O\e(B Emacs \e$B$G\e(B IRC (Internet Relay Chat) \e$B$K;22C$9$k$?$a$N%W%m%0%i%`$G$9!#\e(B
53
54 @menu
55 * Overview::                    Riece \e$B$H$O2?$+\e(B
56 * Getting started::             
57 * Basic usage::                 \e$B4pK\E*$J$D$+$$$+$?\e(B
58 * Advanced usage::              \e$B?J$s$@$D$+$$$+$?\e(B
59 * Development::                 \e$B3+H/<T8~$1>pJs\e(B
60 * Index::                       
61 * Function Index::              
62 * Variable Index::              
63 @end menu
64
65 @node Overview, Getting started, Top, Top
66 @chapter Overview
67
68 Riece \e$B$O!"D9$$4V%a%s%F%J%s%9IT2DG=$J>uBV$K$"$C$?\e(B Liece \e$B$N%3!<%I$r40A4$K\e(B
69 \e$B=q$-D>$7$?$b$N$G$9!#%$%s%?!<%U%'!<%9$O!"\e(BLiece \e$B$+$i$[$H$s$I$=$N$^$^F'=1$7\e(B
70 \e$B$F$$$^$9!#\e(B
71
72 \e$B8=:_$N$H$3$m\e(B IRC \e$B%/%i%$%"%s%H$H$7$F$N5!G=$O==J,$G$O$"$j$^$;$s$,!"\e(BLiece 
73 \e$B$K$O$J$$FCD9$,$$$/$D$+$"$j$^$9!#0J2<$K$=$l$i$N0lIt$r5s$2$^$9!#\e(B
74
75 @itemize @bullet
76 @item \e$BJ#?t$N%5!<%P$KF1;~$K$D$J$2$k\e(B
77 @item \e$B0l1~\e(B API \e$B$i$7$$\e(B API \e$B$,MQ0U$5$l$F$$$k\e(B
78 @item \e$B%3!<%I%5%$%:$,>.$5$$\e(B (Liece \e$B$NH>J,DxEY\e(B)
79 @item \e$B%"%I%*%s$K$h$k3HD%$,2DG=\e(B
80 @item APEL \e$B$,$$$i$J$$\e(B
81 @end itemize
82
83 \e$B$h$j>\$7$$>pJs$O!"0J2<$N%Z!<%8$r8fMw$/$@$5$$!#\e(B
84
85 @itemize @bullet
86 @item http://wiliki.designflaw.org/index.cgi?Riece&l=jp
87 @item http://www.unixuser.org/~ueno/liece/
88 @end itemize
89
90 @node Getting started, Basic usage, Overview, Top
91 @chapter Getting started
92
93 @menu
94 * Required Environments::       \e$BF0:n4D6-\e(B
95 * Installation::                \e$B%$%s%9%H!<%kJ}K!\e(B
96 * Startup File::                \e$B@_Dj%U%!%$%k\e(B
97 @end menu
98
99 @node Required Environments, Installation, Getting started, Getting started
100 @section Required Environments
101
102 \e$B<!$K5s$2$k4D6-$GF0:n$r3NG'$7$F$$$^$9!#\e(B
103
104 @itemize @bullet
105 @item Emacs 20.7 \e$B0J>e\e(B
106 @item XEmacs 21.4 \e$B0J>e\e(B
107 @end itemize
108
109 @node Installation, Startup File, Required Environments, Getting started
110 @section Installation
111
112 Riece \e$B$N:G?7HG$O!"\e(B
113 @uref{http://wiliki.designflaw.org/index.cgi?Riece&l=jp} \e$B$GG[I[$7$F$$$^\e(B
114 \e$B$9!#E83+$7$?$i!"0J2<$N%3%^%s%I$r<B9T$9$k$3$H$G<j85$N4D6-$K%$%s%9%H!<%k$G\e(B
115 \e$B$-$^$9\e(B
116
117 @example
118 ./configure
119 make
120 make install
121 @end example
122
123 XEmacs \e$B$N%Q%C%1!<%8$H$7$F%$%s%9%H!<%k$9$k>l9g$K$O0J2<$N$h$&$K$7$^$9!#\e(B
124
125 @example
126 ./configure --with-xemacs[=xemacs-21.4.13]
127 make package
128 make install-package
129 @end example
130
131 XEmacs \e$B$N%Q%C%1!<%8$H$7$F%$%s%9%H!<%k$7$?>l9g$K$OI,MW$"$j$^$;$s$,!"\e(B
132 @kbd{M-x riece} \e$B$G5/F0$9$k$?$a$K$O!"\e(Bautoload \e$B$N@_Dj$r8f<+J,$N\e(B Emacs \e$B$N@_\e(B
133 \e$BDj%U%!%$%k$K2C$($kI,MW$,$"$j$^$9!#\e(B
134
135 @lisp
136 (autoload 'riece "riece" "Start Riece" t)
137 @end lisp
138
139 @node Startup File,  , Installation, Getting started
140 @section Startup file
141
142 \e$B$O$8$a$F$D$+$&>l9g$K$O!"$H$/$K2?$b@_Dj$9$kI,MW$O$"$j$^$;$s!#\e(B
143 \e$B$3$N>O$OFI$_Ht$P$7$F$/$@$5$$!#\e(B
144
145 Riece \e$B$O@_Dj%U%!%$%k$rJQ?t\e(B @code{riece-directory} \e$B$G;X<($5$l$k%G%#%l%/%H\e(B
146 \e$B%j\e(B (\e$B%G%U%)%k%H$O\e(B @file{~/.riece/}) \e$B$+$iFI$_9~$_$^$9!#$3$N%G%#%l%/%H%j$K\e(B
147 \e$B$O0J2<$NFs<oN`$N@_Dj%U%!%$%k$,3JG<$5$l$^$9!#\e(B
148
149 @table @code
150 @item riece-saved-variables-file
151 @vindex riece-saved-variables-file
152 \e$BA02s$N%;%C%7%g%s$N>pJs$r3JG<$7$^$9\e(B(\e$B%G%U%)%k%H$O\e(B @file{~/.riece/save})
153 @item riece-variables-file
154 @vindex riece-variables-file
155 \e$B%f!<%6$K8GM-$N@_Dj$r5-=R$7$^$9\e(B(\e$B%G%U%)%k%H$O\e(B @file{~/.riece/init})
156 @end table
157
158 \e$B5/F0;~$K$O!":G=i$K\e(B @code{riece-saved-variables-file} \e$B$r!"<!$K\e(B 
159 @code{riece-variables-file} \e$B$rFI$_9~$_$^$9!#%U%!%$%k$,B8:_$7$J$1$l$P2?$b\e(B
160 \e$B$7$^$;$s!#\e(B
161
162 @node Basic usage, Advanced usage, Getting started, Top
163 @chapter Basic usage
164
165 @kbd{M-x riece} \e$B$H$9$k$3$H$G5/F0$7$^$9!#%5!<%PL>$rJ9$+$l$k$N$GEz$($^$9!#\e(B
166 \e$B@\B32DG=$J\e(B IRC \e$B%5!<%P$O3F\e(B IRC \e$B%M%C%H%o!<%/Kh$K0[$J$j$^$9$,!"BgDq$O\e(B Web 
167 \e$B%Z!<%8$K0lMw$,$^$H$a$F$"$k$3$H$,B?$$$G$7$g$&!#\e(B
168
169 @itemize @bullet
170 @item http://irc.kyoto-u.ac.jp
171 @item http://freenode.net
172 @end itemize
173
174 \e$B$b$7%K%C%/%M!<%`$,4{$K;HMQ$5$l$F$$$k>l9g!"JL$N%K%C%/%M!<%`$NF~NO$rB%$5$l$^$9!#\e(B
175 \e$B%K%C%/%M!<%`$N=i4|CM$O\e(B @code{riece-nickname} \e$B$G@_Dj$7$^$9!#%G%U%)%k%H$G$O!"\e(B
176 \e$B%f!<%6$N%m%0%$%sL>$,$=$N$^$^;H$o$l$^$9!#\e(B
177 @vindex riece-nickname
178
179 \e$BL5;v$K@\B3$G$-$?$J$i!"<!$O%A%c%s%M%k$K;22C$7$F2qOC$r$7$F$_$^$7$g$&!#\e(B
180 @kbd{C-c j} \e$B$H%?%$%W$9$k$H!"%A%c%s%M%kL>$r?R$M$i$l$k$N$G!"E,Ev$J%A%c%s%M\e(B
181 \e$B%kL>$rF~NO$7$^$7$g$&!#$?$H$($P\e(B IRCnet \e$B$K$O\e(B @samp{#Liece} \e$B$H$$$&%A%c%s%M\e(B
182 \e$B%k$,$"$k$N$G!"%F%9%H$K$*;H$$$/$@$5$$!#\e(B
183
184 \e$B%A%c%s%M%k$KF~$k$3$H$,$G$-$?$i!"J8>O$rF~NO$7$F%j%?!<%s%-!<$r2!$9$HH/8@$9\e(B
185 \e$B$k$3$H$,$G$-$^$9!#B>$N?M$N2qOC$O2hLL1&>e$N%P%C%U%!$KI=<($5$l$^$9!#\e(B
186
187 @menu
188 * Commands::                    \e$B%3%^%s%I$N0lMw\e(B
189 * Connecting to multiple servers::  \e$BJ#?t$N%5!<%P$K$D$J$0$K$O\e(B
190 @end menu
191
192 @node Commands, Connecting to multiple servers, Basic usage, Basic usage
193 @section Commands
194
195 \e$BJ8>O$rF~NO$7$?%P%C%U%!\e(B @samp{*Commands*} \e$B$O!"%3%^%s%I%P%C%U%!$H8F$P$l!"\e(B
196 \e$B%3%^%s%I%P%C%U%!$+$i$OMM!9$J%3%^%s%I$rH/9T$9$k$3$H$,$G$-$^$9!#0J2<$K0lIt\e(B
197 \e$B$r5s$2$^$9!#\e(B
198
199 @subsection IRC commands
200 @table @kbd
201 @item RET
202 @findex riece-command-enter-message
203 \e$BJ8>O$rAw$j$^$9\e(B(@code{riece-command-enter-message})
204 @item C-RET
205 @findex riece-command-enter-message-as-notice
206 \e$BJ8>O$r\e(B NOTICE \e$B$H$7$FAw$j$^$9\e(B(@code{riece-command-enter-message-as-notice})
207 @item C-c j
208 @findex riece-command-join
209 \e$B%A%c%s%M%k$K;22C$7$^$9\e(B(@code{riece-command-join})
210 @item C-c C-p
211 @findex riece-command-part
212 \e$B%A%c%s%M%k$+$iN%C&$7$^$9\e(B(@code{riece-command-part})
213 @item C-c q
214 @findex riece-command-quit
215 IRC \e$B$r$d$a$^$9\e(B(@code{riece-command-quit})
216 @item C-c n
217 @findex riece-command-change-nickname
218 \e$B<+J,$N%K%C%/%M!<%`$rJQ99$7$^$9\e(B(@code{riece-command-change-nickname})
219 @item C-c f
220 @findex riece-command-finger
221 \e$B%f!<%6$N>pJs$rD4$Y$^$9\e(B(@code{riece-command-finger})
222 @item C-c C-k
223 @findex riece-command-kick
224 \e$B%f!<%6$r%A%c%s%M%k$+$i=3$j=P$7$^$9\e(B(@code{riece-command-kick})
225 @item C-c i
226 @findex riece-command-invite
227 \e$B%f!<%6$r%A%c%s%M%k$K>7BT$7$^$9\e(B(@code{riece-command-invite})
228 @item C-c l
229 @findex riece-command-list
230 \e$B%Q%?!<%s$KBP$7$F\e(B LIST \e$B$rH/9T$7$^$9\e(B(@code{riece-command-list})
231 @item C-c C-n
232 @findex riece-command-names
233 \e$B%Q%?!<%s$KBP$7$F\e(B NAMES \e$B$rH/9T$7$^$9\e(B(@code{riece-command-names})
234 @item C-c w
235 @findex riece-command-who
236 \e$B%Q%?!<%s$KBP$7$F\e(B WHO \e$B$rH/9T$7$^$9\e(B(@code{riece-command-who})
237 @item C-c t
238 @findex riece-command-topic
239 \e$B%A%c%s%M%k$N%H%T%C%/$r@_Dj$7$^$9\e(B(@code{riece-command-topic})
240 @item C-c C-m
241 @findex riece-command-change-mode
242 \e$B%A%c%s%M%k$N%b!<%I$r@_Dj$7$^$9\e(B(@code{riece-command-change-mode})
243 @item C-c o
244 @findex riece-command-set-operators
245 \e$B%f!<%6$K%*%Z%l!<%?8"8B$rM?$($^$9!#A0CV0z?t\e(B (@kbd{C-u}) \e$B$rM?$($k$H!"%f!<%6$+$iH/8@8"$rC%$$$^$9\e(B(@code{riece-command-set-operators})
246 @item C-c v
247 @findex riece-command-set-speakers
248 \e$B%f!<%6$KH/8@8"$rM?$($^$9!#A0CV0z?t\e(B (@kbd{C-u}) \e$B$rM?$($k$H!"%f!<%6$+$iH/8@8"$rC%$$$^$9\e(B(@code{riece-command-set-speakers})
249 @item C-c /
250 @findex riece-command-raw
251 \e$B@8$N\e(B IRC \e$B%3%^%s%I$rAw$j$^$9\e(B(@code{riece-command-raw})
252 @end table
253
254 @subsection Window manipulating commands
255 @table @kbd
256 @item C-c r
257 @findex riece-command-configure-windows
258 \e$B%&%#%s%I%&$r:FIA2h$7$^$9\e(B(@code{riece-command-configure-windows})
259 @item C-c C-j
260 @findex riece-command-next-channel
261 \e$B<!$N%A%c%s%M%k$K0\$j$^$9\e(B(@code{riece-command-next-channel})
262 @item C-c <
263 @findex riece-command-previous-channel
264 \e$BA0$N%A%c%s%M%k$K0\$j$^$9\e(B(@code{riece-command-previous-channel})
265 @item C-c >
266 @findex riece-command-next-channel
267 \e$B<!$N%A%c%s%M%k$K0\$j$^$9\e(B(@code{riece-command-next-channel})
268 @item C-c \e$B?t;z\e(B
269 @findex riece-command-switch-to-channel-by-number
270 @var{n}\e$BHVL\$N%A%c%s%M%k$K0\F0$7$^$9\e(B(@code{riece-command-switch-to-channel-by-number})
271 @item C-c C-c \e$B?t;z\e(B
272 @findex riece-command-switch-to-channel-by-number
273 @var{n} + 10\e$BHVL\$N%A%c%s%M%k$K0\F0$7$^$9\e(B(@code{riece-command-switch-to-channel-by-number})
274 @item C-c $
275 @findex riece-command-end-of-buffer
276 \e$B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$N%S%e!<$r2<C<$^$G0\F0$7$^$9\e(B(@code{riece-command-end-of-buffer})
277 @item C-c SPC
278 @findex riece-command-scroll-up
279 \e$B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$r>eJ}8~$K%9%/%m!<%k$7$^$9\e(B(@code{riece-command-scroll-up})
280 @item C-c DEL
281 @findex riece-command-scroll-down
282 \e$B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$r2<J}8~$K%9%/%m!<%k$7$^$9\e(B(@code{riece-command-scroll-down})
283 @end table
284
285 @subsection Status toggle commands
286 @table @kbd
287 @item C-c C-t c
288 @findex riece-command-toggle-channel-buffer-mode
289 \e$B%A%c%s%M%k%P%C%U%!$NI=<(!&HsI=<($r@Z$jBX$($^$9\e(B(@code{riece-command-toggle-channel-buffer-mode})
290 @item C-c C-t C
291 @findex riece-command-toggle-channel-list-buffer-mode
292 \e$B%A%c%s%M%k%j%9%H%P%C%U%!$NI=<(!&HsI=<($r@Z$jBX$($^$9\e(B(@code{riece-command-toggle-channel-list-buffer-mode})
293 @item C-c C-t u
294 @findex riece-command-toggle-user-list-buffer-mode
295 \e$B%f!<%6%j%9%H%P%C%U%!$NI=<(!&HsI=<($r@Z$jBX$($^$9\e(B(@code{riece-command-toggle-user-list-buffer-mode})
296 @item C-c C-t f
297 @findex riece-command-toggle-freeze
298 \e$B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$N%9%/%m!<%k$r6X;_$7$^$9\e(B(@code{riece-command-toggle-freeze})
299 @item C-c C-t o
300 @findex riece-command-toggle-own-freeze
301 \e$B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$N%9%/%m!<%k$r!"<+J,$,H/8@$9$k$^$G6X;_$7$^$9\e(B(@code{riece-command-toggle-own-freeze})
302 @item C-c C-t a
303 @findex riece-command-toggle-away
304 \e$B<+J,$NN%@J>uBV$r@Z$jBX$($^$9\e(B(@code{riece-command-toggle-away})
305 @end table
306
307 @node Connecting to multiple servers,  , Commands, Basic usage
308 @section Connecting to multiple servers
309
310 Riece \e$B$NBg$-$JFCD9$K!"J#?t$N%5!<%P$KF1;~$K@\B3$9$k5!G=$,$"$j$^$9!#\e(B
311
312 \e$B?7$?$J%5!<%P$K@\B3$7!"$=$N%5!<%P>e$N%A%c%s%M%k$K;22C$9$k<j=g$O0J2<$N$h$&\e(B
313 \e$B$K$J$j$^$9!#\e(B
314
315 @enumerate
316 @item
317 @kbd{C-c O} (@code{riece-command-open-server}) \e$B$H$7$^$9!#%5!<%PL>$rJ9$+$l$k$N$GEz$($^$9!#\e(B
318
319 @item
320 @kbd{C-c j} (@code{riece-command-join}) \e$B$G%A%c%s%M%k$K;22C$7$^$9!#$3$3$G!"\e(B
321 \e$B%A%c%s%M%kL>$N8e$K6uGr$G6h@Z$C$F%5!<%PL>$rB3$1$^$9!#6uGr$rF~NO$9$k$K$O!"\e(B
322 @kbd{C-q} \e$B$r;H$$$^$9!#$?$H$($P!"%5!<%P\e(B @samp{irc6} \e$B>e$N\e(B @samp{#Liece} \e$B$K;22C$9$k$K$O\e(B @kbd{C-c j #Liece C-q SPC irc6} \e$B$H%?%$%W$9$k$3$H$K$J$j$^$9!#\e(B
323 @end enumerate
324
325 \e$B%A%c%s%M%k$KF~$i$:$K%3%^%s%I$rAw$k$K$O!"\e(B@kbd{C-c M}
326 (@code{riece-command-universal-server-name-argument}) \e$B$,JXMx$G$9!#\e(B
327
328 \e$B%5!<%P$H$N@\B3$K4X$9$k%3%^%s%I$O0J2<$NDL$j$G$9!#\e(B
329
330 @table @kbd
331 @item C-c O
332 @findex riece-command-open-server
333 \e$BJL$N%5!<%P$K@\B3$7$^$9\e(B(@code{riece-command-open-server})
334 @item C-c C
335 @findex riece-command-close-server
336 \e$B%5!<%P$H$N@\B3$r@ZCG$7$^$9\e(B(@code{riece-command-close-server})
337 @item C-c M
338 @findex riece-command-universal-server-name-argument
339 \e$BFCDj$N%5!<%P$KBP$7$F!"B3$/%3%^%s%I$rH/9T$7$^$9\e(B(@code{riece-command-universal-server-name-argument})
340 @end table
341
342 @node Advanced usage, Development, Basic usage, Top
343 @chapter Advanced usage
344
345 \e$B$3$N>O$G$O!"$b$C$H?J$s$@;H$$J}$r2r@b$7$^$9!#\e(B
346
347 @menu
348 * Server settings::             \e$B%5!<%P$N>\:Y@_Dj\e(B
349 * Add-ons::                     \e$B%"%I%*%s$H$O\e(B
350 * Writing add-ons::             \e$B@lMQ$N%"%I%*%s$r=q$/$K$O\e(B
351 * Handler hooks::               \e$B%O%s%I%i$N?6Iq$$$NJQ99\e(B
352 @end menu
353
354 @node Server settings, Add-ons, Advanced usage, Advanced usage
355 @section Server settings
356
357 IRC \e$B%5!<%P$O\e(B @code{riece-server} \e$BJ8;zNs$H$7$F;XDj$7$^$9!#\e(B
358 \e$B$3$3$G\e(B @code{riece-server} \e$B$N%U%)!<%^%C%H$O\e(B "<\e$B%5!<%P$N%[%9%HL>\e(B>:<\e$B%]!<%HHV9f\e(B>[:<\e$B%Q%9%o!<%I\e(B>]" \e$B$H$J$j$^$9!#\e(B
359 @vindex riece-server
360
361 @code{riece-server-alist} \e$B$rE,@Z$K@_Dj$9$k$H!"%-!<%o!<%I$r;H$C$F!"$h$j>\\e(B
362 \e$B:Y$J;XDj$,2DG=$K$J$j$^$9!#0J2<$OI.<T$N@_Dj$+$iH4$-=P$7$?Nc$G$9!#\e(B
363 @vindex riece-server-alist
364
365 @example
366 (setq riece-server-alist
367       '(("irc6" :host "irc6.nara.wide.ad.jp")
368         ("plum" :host "localhost" :service 26667
369          :function relay-open-network-stream))
370       riece-server "irc6")
371 @end example
372
373 @code{riece-server-alist} \e$B$N3FMWAG$N0UL#$O0J2<$NDL$j$G$9!#\e(B
374
375 @itemize
376 @item
377 @samp{irc6} \e$B$H$$$&N,5-L>$G\e(B @samp{irc6.nara.wide.ad.jp} \e$B$K@\B3\e(B
378
379 @item
380 @samp{plum} \e$B$H$$$&N,5-L>$G\e(B @code{relay-open-network-stream} \e$B$rDL$8$F\e(B (SSH \e$B7PM3$G\e(B) \e$B@\B3\e(B
381 @end itemize
382
383 \e$B;XDj2DG=$J%-!<%o!<%I$O0J2<$NDL$j$G$9!#\e(B
384
385 @table @code
386 @item :host
387 \e$B%5!<%P$N%[%9%HL>$^$?$O\e(B IP \e$B%"%I%l%9\e(B
388 @item :service
389 \e$B%5!<%P$N%5!<%S%9L>$^$?$O%]!<%HHV9f\e(B
390 @item :nickname
391 \e$B@\B3;~$N%K%C%/%M!<%`\e(B
392 @item :username
393 \e$B@\B3;~$N%f!<%6%M!<%`\e(B
394 @item :password
395 \e$B@\B3;~$N%Q%9%o!<%I\e(B
396 @item :function
397 \e$B@\B3MQ4X?t\e(B
398 @item :coding-system
399 \e$B%3!<%G%#%s%0%7%9%F%`\e(B
400 @end table
401
402 @node Add-ons, Writing add-ons, Server settings, Advanced usage
403 @section Add-ons
404
405 Riece \e$B$G$O!"%f!<%6$,?7$?$J5!G=$rDI2C$7!"<+M3$K<h$j30$7$G$-$k$h$&!"%"%I%*\e(B
406 \e$B%s$H8F$P$l$k5!9=$rMQ0U$7$F$$$^$9!#%"%I%*%s$ODL>o$N\e(B elisp \e$B%b%8%e!<%k$r3H\e(B
407 \e$BD%$7$?$b$N$G!"%m!<%I$N=gHV$@$1$G$O$J$/!"=i4|2==hM}$N0MB84X78$b5-=R$9$k$3\e(B
408 \e$B$H$,$G$-$^$9!#\e(B
409
410 \e$B8=:_!"0J2<$N%b%8%e!<%k$,%"%I%*%s$H$7$F<BAu$5$l$F$$$^$9!'\e(B
411
412 @table @samp
413 @item riece-highlight
414 \e$B%P%C%U%!$N?'IU$1\e(B
415 @item riece-ctcp
416 CTCP (Client To Client Protocol)
417 @item riece-url
418 \e$B2qOC$K8=$l$?\e(B URL \e$B$N<}=8\e(B
419 @item riece-unread
420 \e$BH/8@$N$"$C$?%A%c%s%M%k$K\e(B@samp{!}\e$B%^!<%/$r$D$1$k\e(B
421 @item riece-rdcc
422 DCC (Direct Client Connection) \e$B$K$h$k%U%!%$%kE>Aw\e(B
423 @end table
424
425 \e$B$3$l$i$N$&$A!"\e(B@samp{riece-highlight} \e$B$H\e(B @samp{riece-ctcp} \e$B$O%G%U%)%k%H$G\e(B
426 \e$BAH$_9~$^$l$F$$$^$9!#\e(B
427
428 \e$B%"%I%*%s$rAH$_9~$`$K$O\e(B @code{riece-addons} \e$B$r@_Dj$7$^$9!#$?$H$($P\e(B 
429 @samp{riece-url} \e$B$rAH$_9~$`>l9g$K$O!"\e(B@file{~/.riece/init.el} \e$B$K0J2<$N$h\e(B
430 \e$B$&$K5-=R$7$^$9!#\e(B
431 @vindex riece-addons
432
433 @example
434 (add-to-list 'riece-addons 'riece-url t)
435 @end example
436
437 @node Writing add-ons, Handler hooks, Add-ons, Advanced usage
438 @section Writing add-ons
439
440 \e$B%"%I%*%s$N>r7o$rK~$?$9%b%8%e!<%k$O0J2<$N4X?t$rDs6!$7$^$9!#\e(B
441
442 @table @samp
443 @item <\e$B%b%8%e!<%kL>\e(B>-requires
444 \e$B0MB8$9$kB>$N%"%I%*%s\e(B(\e$B%7%s%\%k$N%j%9%H\e(B)\e$B$rJV$7$^$9\e(B(\e$B%*%W%7%g%s\e(B)
445 @item <\e$B%b%8%e!<%kL>\e(B>-insinuate
446 \e$B=i4|2==hM}$r9T$$$^$9\e(B
447 @end table
448
449 Riece \e$BB&$G$O0J2<$N=hM}$r9T$$$^$9!#\e(B
450
451 @enumerate
452 @item
453 \e$BJQ?t\e(B @code{riece-addons} \e$B$KNs5s$5$l$?%b%8%e!<%k$rFI$_9~$`\e(B
454
455 @item
456 \e$B$=$l$>$l$N%b%8%e!<%k$KBP$7!"\e(B@samp{<\e$B%b%8%e!<%kL>\e(B>-requires} \e$B$,MQ0U$5$l$F$$$l$P8F$S=P$7$F0MB8%0%i%U$r:n$k\e(B
457
458 @item
459 \e$B0MB8%0%i%U$KBP$7$F%H%]%m%8%+%k%=!<%H\e(B (cf. tsort(1)) \e$B$r9T$&\e(B
460
461 @item
462 \e$BF@$?0MB8=g=x$K=>$C$F\e(B @samp{<\e$B%b%8%e!<%kL>\e(B>-insinuate} \e$B8F$S=P$9\e(B
463 @end enumerate
464
465 \e$B:n@.$7$?%"%I%*%s$O!"\e(B@code{load-path} \e$B$NDL$C$?%G%#%l%/%H%j!"$^$?$O\e(B 
466 @code{riece-addon-directory} (\e$B%G%U%)%k%H$G$O\e(B @file{~/.riece/addons/}) \e$B$K\e(B
467 \e$BCV$/$3$H$GAH$_9~$_2DG=$J>uBV$K$J$j$^$9!#\e(B
468 @vindex riece-addon-directory
469
470 @node Handler hooks,  , Writing add-ons, Advanced usage
471 @section Handler hooks
472
473 Riece \e$B$K$O!"%O%s%I%i%U%C%/$H8F$P$l$kFC<l$J%U%C%/$,$"$j$^$9!#$3$l$i$O\e(B IRC 
474 \e$B$N%a%C%;!<%8$r<u$1<h$C$?A08e$G<B9T$5$l$k%U%C%/$G$9!#\e(B
475
476 \e$B@bL@$N$?$a$K\e(B @samp{message} \e$B$r\e(B IRC \e$B$N%a%C%;!<%8L>\e(B(PRIVMSG \e$B$J$I\e(B)\e$B$rA4$F>.\e(B
477 \e$BJ8;z$K$7$?$b$N$H$7$^$9!#\e(B
478
479 @table @code
480 @item riece-<message>-hook
481 @samp{message} \e$B$,FO$$$?$H$-$K:G=i$K8F$P$l$k%U%C%/\e(B
482 @item riece-after-<message>-hook
483 @samp{message} \e$B$N=hM}$,=*$o$C$?8e$K8F$P$l$k%U%C%/\e(B
484 @end table
485
486 \e$B$3$3$G\e(B @code{riece-<message>-hook} \e$B$NJV$jCM$K$O0UL#$,$"$j!"Hs\e(B nil \e$B$rJV$9\e(B
487 \e$B$b$N$,$"$l$P!"$=$N8e$N=hM}$r$*$3$J$$$^$;$s!#$^$?!"$=$N>l9g$K$O\e(B 
488 @code{riece-after-<message>-hook} \e$B$b8F$S=P$5$l$^$;$s!#\e(B
489
490 \e$B%U%C%/$N0z?t$O\e(B RFC2812 \e$B$N\e(B @samp{prefix} \e$B$H\e(B @samp{Parameters} \e$B$KAjEv$9$k\e(B 
491\e$B$D$N0z?t$,EO$j$^$9!#\e(B
492
493 @node Development, Index, Advanced usage, Top
494 @chapter Development
495
496 \e$B3+H/<TJg=8Cf!#\e(B
497
498 @menu
499 * CVS::                         
500 * Debugging::                   
501 * Modules::                     
502 * Namespace management::        
503 @end menu
504
505 @node CVS, Debugging, Development, Development
506 @section CVS
507
508 Riece \e$B$N3+H/$O\e(B CVS \e$B$rMxMQ$7$F9T$C$F$$$^$9!#\e(BCVS \e$B%5!<%P$+$i:G?7$N%9%J%C%W\e(B
509 \e$B%7%g%C%H$r<hF@$9$k$K$O0J2<$N$h$&$K$7$^$9!#\e(B
510
511 @enumerate
512 @item
513 CVS \e$B%5!<%P$X$N%m%0%$%s\e(B
514
515 @example
516 cvs -d :pserver:anonymous@@cvs.m17n.org:/cvs/root login
517 CVS password: [CR] # NULL string
518 @end example
519
520 @item
521 \e$B%b%8%e!<%k$N%A%'%C%/%"%&%H\e(B
522
523 @example
524 cvs -d :pserver:anonymous@@cvs.m17n.org:/cvs/root checkout riece
525 @end example
526
527 @item
528 @file{configure} \e$B$N@8@.\e(B
529
530 @example
531 autoreconf -f -i -v
532 @end example
533 @end enumerate
534
535 @node Debugging, Modules, CVS, Development
536 @section Debugging
537
538 @code{riece-debug} \e$B$r\e(B @code{t} \e$B$K@_Dj$9$k$H!"%G%P%C%0=PNO$,M-8z$K$J$j$^\e(B
539 \e$B$9!#$^$?!"%5!<%P$+$i$N@8$N=PNO$,\e(B " *IRC*[<\e$B%5!<%PL>\e(B>]" \e$B%P%C%U%!$K>C$5$l$:\e(B
540 \e$B$K;D$j$^$9!#\e(B
541 @vindex riece-debug
542
543 @node Modules, Namespace management, Debugging, Development
544 @section Modules
545
546 \e$B4pK\E*$K0MB84X78$N>e0L$K$"$k$b$N$+$i!'\e(B
547
548 @subsection Core modules
549 @table @samp
550 @item riece-globals
551 \e$BBg0hJQ?t$NDj5A\e(B 
552 @item riece-options
553 \e$B%f!<%6%*%W%7%g%s$NDj5A\e(B 
554 @item riece-version
555 \e$B%P!<%8%g%s$NDj5A\e(B 
556 @item riece-inlines
557 \e$B;(B?$J%$%s%i%$%s4X?t$NDj5A\e(B 
558 @item riece-coding
559 \e$B%3!<%G%#%s%0%7%9%F%`4XO"$N4X?t$NDj5A\e(B 
560 @item riece-complete
561 \e$B%_%K%P%C%U%!$G$NJd40$r=u$1$k4X?t$NDj5A\e(B 
562
563 @item riece-identity
564 channel/user object \e$B$NBg0hI=5-$rA`:n$9$k4X?t$NDj5A\e(B 
565 @item riece-channel
566 channel object \e$B4XO"$NDj5A\e(B 
567 @item riece-user
568 user object \e$B4XO"$NDj5A\e(B 
569
570 @item riece-misc
571 \e$B;(B?$J4X?t$NDj5A\e(B(\e$B%$%s%i%$%s4X?t$r=|$/\e(B) 
572 @item riece-display
573 \e$BI=<(MQ%P%C%U%!$N4IM}\e(B 
574 @item riece-server
575 IRC\e$B%5!<%P$H$N@\B34IM}\e(B 
576
577 @item riece-naming
578 \e$BL>A04IM}$N$?$a$N\e(B mediator \e$B$N$h$&$J$b$N\e(B 
579 @item riece-message
580 message object \e$B4XO"$NDj5A\e(B 
581
582 @item riece-filter
583 \e$B%W%m%;%9%U%#%k%?$N%(%s%H%j%]%$%s%H\e(B 
584 @item riece-handle
585 \e$BDL>o$N%a%C%;!<%8$N%O%s%I%i!#\e(Briece-filter \e$B$N$_$+$i8F$P$l$k\e(B 
586 @item riece-000
587 000\e$BHVBf$N\e(B numeric reply \e$B$N%O%s%I%i!#\e(Briece-filter \e$B$N$_$+$i8F$P$l$k\e(B 
588 @item riece-200
589 200\e$BHVBf$N\e(B numeric reply \e$B$N%O%s%I%i!#\e(Briece-filter \e$B$N$_$+$i8F$P$l$k\e(B 
590 @item riece-300
591 300\e$BHVBf$N\e(B numeric reply \e$B$N%O%s%I%i!#\e(Briece-filter \e$B$N$_$+$i8F$P$l$k\e(B 
592 @item riece-400
593 400\e$BHVBf$N\e(B numeric reply \e$B$N%O%s%I%i!#\e(Briece-filter \e$B$N$_$+$i8F$P$l$k\e(B 
594 @item riece-500
595 500\e$BHVBf$N\e(B numeric reply \e$B$N%O%s%I%i!#\e(Briece-filter \e$B$N$_$+$i8F$P$l$k\e(B 
596
597 @item riece-commands
598 \e$B%3%^%s%I$NDj5A\e(B 
599 @item riece
600 \e$B%(%s%H%j%]%$%s%H!#3F%P%C%U%!$N%b!<%IDj5A$J$I\e(B 
601 @end table
602
603 @subsection Add-ons
604 @table @samp
605 @item riece-highlight
606 \e$B%P%C%U%!$N?'IU$1\e(B
607 @item riece-ctcp
608 CTCP (Client To Client Protocol)
609 @item riece-url
610 \e$B2qOC$K8=$l$?\e(B URL \e$B$N<}=8\e(B
611 @item riece-unread
612 \e$BH/8@$N$"$C$?%A%c%s%M%k$K\e(B@samp{!}\e$B%^!<%/$r$D$1$k\e(B
613 @item riece-rdcc
614 DCC (Direct Client Connection) \e$B$K$h$k%U%!%$%kE>Aw\e(B (Ruby \e$B$K$h$k<BAu\e(B)
615 @item riece-ndcc
616 DCC (Direct Client Connection) \e$B$K$h$k%U%!%$%kE>Aw\e(B (Emacs 21.3 \e$B$N\e(B @code{make-network-connection} \e$B$K$h$k<BAu\e(B)
617 @end table
618
619 @node Namespace management,  , Modules, Development
620 @section Namespace management
621
622 Riece \e$B$OJ#?t$N%5!<%P$KF1;~$K@\B3$9$k$?$a!"%5!<%PKh$KJL!9$NL>A06u4V$r4IM}\e(B
623 \e$B$7$F$$$^$9!#$3$NL>A06u4V$K$O!"%5!<%P$N%W%m%;%9$K7k$SIU$1$i$l$?%P%C%U%!$N\e(B
624 \e$B%m!<%+%kJQ?t$r2p$7$F%"%/%;%9$7$^$9!#\e(B
625
626 @subsection Obtaining server buffer
627 \e$B%5!<%P$N%P%C%U%!$r<hF@$9$k$K$O!"$^$:$O$8$a$K%5!<%P$NL>A0$rF@$kI,MW$,$"$j\e(B
628 \e$B$^$9!#$3$l$K$O\e(B @code{riece-find-server-name} \e$B$r;H$$$^$9!#$3$N4X?t$O!">u\e(B
629 \e$B67$K1~$8$FA*Br$9$Y$-%5!<%P$NL>A0$rJV$7$^$9!#6qBNE*$K$O0J2<$N=g=x$G8!:w$r\e(B
630 \e$B9T$$$^$9!#\e(B
631 @findex riece-find-server-name
632
633 @enumerate
634 @item
635 @vindex riece-overrinding-server-name
636 \e$BBg0hJQ?t\e(B @code{riece-overrinding-server-name} \e$B$NCM\e(B
637
638 @item
639 @vindex riece-server-name
640 @code{riece-server-name} \e$B$,%+%l%s%H%P%C%U%!$N%m!<%+%kJQ?t$G$"$k$J$i$P!"\e(B
641 \e$B4{$K%W%m%;%9$N%P%C%U%!$K$$$k$H$_$J$;$k$N$G!"\e(B@code{riece-server-name} \e$B$N\e(B
642 \e$BCM$=$N$b$N\e(B
643
644 @item
645 @vindex riece-current-channel
646 \e$B%f!<%6$,8=:_$$$k%A%c%s%M%k\e(B (@code{riece-current-channel}) \e$B$NBg0hL>\e(B(\e$B8e=R\e(B)
647 \e$B$+$i@Z$j=P$7$?%5!<%PL>\e(B
648 @end enumerate
649
650 \e$B$3$&$7$FF@$?%5!<%PL>$G\e(B @code{riece-server-process-alist} \e$B$r:w$-!"%5!<%P\e(B
651 \e$B$N%W%m%;%9$r<hF@$7$^$9!#%^%/%m\e(B riece-with-server-buffer \e$B$r;H$&$H!"$3$3$^\e(B
652 \e$B$G$r0l3g$G$d$C$?$&$($G!"%W%m%;%9$N%P%C%U%!$G<0$rI>2A$9$k$3$H$,$G$-$^$9!#\e(B
653 @vindex riece-server-process-alist
654
655 @subsection Global name
656 \e$BJ#?t$N%5!<%P$K7R$$$@>l9g!"%A%c%s%M%kL>$d%K%C%/$r\e(B(\e$B%5!<%P$N%P%C%U%!>e$@$1\e(B
657 \e$B$G$O$J$/\e(B)\e$BBg0hE*$K6hJL$9$kI,MW$,@8$8$^$9!#$=$3$G!"$3$l$i$NL>A0$r9)IW$7$F!"\e(B
658 \e$BL>A0$N8e$K6uGr$r64$s$G%5!<%PL>$r;XDj$9$k<jK!$r:N$C$F$$$^$9!#$3$l$rBg0hL>\e(B
659 \e$B$H8F$S$^$9!#$?$H$($P!"\e(B@samp{irc6} \e$B$H$$$&%5!<%P$N\e(B @samp{#Liece} \e$B$H$$$&%A%c\e(B
660 \e$B%s%M%k$NBg0hL>$O\e(B @samp{#Liece irc6} \e$B$H$J$j$^$9!#\e(B
661
662 \e$B$3$3$G6h@Z$j$r6uGr$K$7$F$$$k$N$O!"\e(BRFC2812 \e$B$G%A%c%s%M%k$K;HMQ$G$-$J$$J8;z\e(B
663 \e$B$@$+$i$G$9!#\e(B
664
665 \e$BBg0hL>$r07$&$K$O!"\e(B@samp{riece-identity} \e$B$H$$$&Cj>]$r2p$7$^$9!#$3$N%b%8%e!<\e(B
666 \e$B%k$G$O!"0J2<$N$h$&$J4X?t$,Dj5A$5$l$F$$$^$9!#\e(B
667
668 @defun riece-make-identity prefix &optional server
669 \e$BBg0hI=5-$r:n$j=P$7$^$9!#\e(Bserver \e$B$,>JN,$5$l$?>l9g$K$O!"\e(Briece-find-server-name \e$B$r;H$C$F<hF@$7$?%5!<%PL>$r;H$$$^$9\e(B
670 @end defun
671
672 @defun riece-identity-prefix identity
673 \e$BBg0hI=5-$+$i%5!<%PL>$r=|$/ItJ,$rJV$7$^$9\e(B
674 @end defun
675
676 @defun riece-identity-server identity
677 \e$BBg0hI=5-$+$i%5!<%P$r=|$/ItJ,$rJV$7$^$9\e(B
678 @end defun
679  
680 @defun riece-identity-equal a b
681 \e$BFs$D$NBg0hI=5-$,F1Ey$+D4$Y$^$9!#0z?t$H$7$FM?$($i$l$?J8;zNs$K%5!<%PL>$,IU\e(B
682 \e$B2C$5$l$F$$$J$1$l$P!"IU2C$7$F$+$i8!::$r9T$$$^$9\e(B
683 @end defun
684
685 @defun riece-identity-equal-no-server a b
686 @code{riece-identity-equal} \e$B$H0l=o$G$9$,!"%5!<%PL>$NIU2C$O9T$$$^$;$s\e(B
687 @end defun
688
689 @subsection Channel and user management
690 IRC \e$B$N%A%c%s%M%k$H%f!<%6$O4pK\E*$KC1$J$k%Y%/%?!<$H$7$FI=8=$5$l$F$$$^$9!#\e(B
691 JOIN \e$B$d\e(B PART \e$B$H$$$C$?FCJL$JA`:n$O!"$3$l$i$N%*%V%8%'%/%H$K$O7k$S$D$1$^$;\e(B
692 \e$B$s!#7k$S$D$1$?$[$&$,%*%V%8%'%/%H;X8~$GNI$$$N$G$O$J$$$+!"$H$$$&0U8+$b$"$j\e(B
693 \e$B$^$9$,!"$=$N$h$&$K$9$k$H!"Aj8_$N7k$SIU$-$,6[L)$K$J$j$9$.!"%9%Q%2%C%F%#$N\e(B
694 \e$B$b$H$K$J$k$3$H$O4{$K7P83:Q$_$G$9!#\e(B
695
696 @subsubsection Channels
697 @code{riece-channel} \e$B$O!"\e(BIRC \e$B$N%A%c%s%M%k$rI=$9%*%V%8%'%/%H$G$9!#0J2<$N\e(B
698 \e$BMWAG$r;}$A$^$9!#\e(B
699
700 @table @samp
701 @item users
702 \e$B;22C$7$F$$$k%f!<%6$NL>A0\e(B(\e$B6I=jL>\e(B)\e$B$N%j%9%H\e(B 
703 @item operators
704 \e$B%*%Z%l!<%?8"8B$r$b$D%f!<%6$NL>A0$N%j%9%H\e(B 
705 @item speakers
706 \e$BH/8@8"$r$b$D%f!<%6$NL>A0$N%j%9%H\e(B 
707 @item modes
708 \e$B%A%c%s%M%k$N%b!<%I\e(B(\e$BJ8;z$N%j%9%H\e(B) 
709 @item banned
710 @samp{MODE +b} \e$B$G;XDj$5$l$?%Q%?!<%s$N0lMw\e(B 
711 @item invited
712 @samp{MODE +I} \e$B$G;XDj$5$l$?%Q%?!<%s$N0lMw\e(B 
713 @item uninvited
714 @samp{MODE +e} \e$B$G;XDj$5$l$?%Q%?!<%s$N0lMw\e(B
715 @end table
716
717 @subsubsection Users
718 @code{riece-user} \e$B$O!"\e(BIRC \e$B$K;22C$7$F$$$k%f!<%6$rI=$9%*%V%8%'%/%H$G$9!#0J\e(B
719 \e$B2<$NMWAG$r;}$A$^$9!#\e(B
720
721 @table @samp
722 @item channels
723 \e$B;22C$7$F$$$k%A%c%s%M%k$NL>A0\e(B(\e$B6I=jL>\e(B)\e$B$N%j%9%H\e(B 
724 @item user-at-host
725 "<user>@@<host>" \e$B$N7A$GM?$($i$l$k%f!<%6$N>pJs\e(B 
726 @item modes
727 \e$B%f!<%6$N%b!<%I\e(B(\e$BJ8;z$N%j%9%H\e(B) 
728 @item away
729 AWAY \e$BCf$+$I$&$+\e(B 
730 @end table
731
732 @subsubsection Mediator
733 \e$B$5$F!"%A%c%s%M%k$H%f!<%6$N;22C$r4IM}$9$k$?$a$K!"\e(B @code{riece-naming} \e$B$H\e(B
734 \e$B$$$&>e0L$N%b%8%e!<%k$rMQ0U$7$F$$$^$9!#$3$l$O!"%G%6%$%s%Q%?!<%s$G$$$&$H$3\e(B
735 \e$B$m$N\e(B Mediator \e$B%Q%?!<%s$KAjEv$9$k$b$N$G$9!#\e(B
736
737 @code{riece-naming} \e$B$r2p$9$k$3$H$G!"A0=R$N%A%c%s%M%k!&%f!<%6%*%V%8%'%/%H\e(B
738 \e$B$KD>@\<j$r?($l$k$3$H$J$/!"L>A06u4V$K0BA4$K%"%/%;%9$9$k$3$H$,$G$-$^$9!#\e(B
739
740 \e$BDs6!$9$k<g$J4X?t$O0J2<$N\e(B 3 \e$B$D$G$9!#\e(B
741
742 @defun riece-naming-assert-join user-name channel-name
743 \e$B%f!<%6$,%A%c%s%M%k$K;22C$7$?$3$H$rI=L@$7$^$9\e(B
744 @end defun
745
746 @defun riece-naming-assert-part user-name channel-name
747 \e$B%f!<%6$,%A%c%s%M%k$+$iN%C&$7$?$3$H$rI=L@$7$^$9\e(B 
748 @end defun
749
750 @defun riece-naming-assert-rename old-name new-name
751 \e$B%f!<%6$NL>A0$,JQ99$5$l$?$3$H$rI=L@$7$^$9\e(B 
752 @end defun
753
754 @node Index, Function Index, Development, Top
755 @chapter Index
756 @printindex cp
757
758 @node Function Index, Variable Index, Index, Top
759 @chapter Function Index
760 @printindex fn
761
762 @node Variable Index,  , Function Index, Top
763 @chapter Variable Index
764 @printindex vr
765
766 @summarycontents
767 @contents
768 @bye
769
770 @c End: