X-Git-Url: https://cgit.sxemacs.org/?p=riece;a=blobdiff_plain;f=doc%2Friece-ja.texi;h=27052cc628fbb4d5d52922eaecd90dec734d7b0d;hp=f96e8e97ce1a4c6e35b4dfae8eae830218abe85b;hb=4948fb6d3debd4e5abca4e986f4516a01b1818d2;hpb=005a2a7642c9f43d699922799801124a77d56f5d diff --git a/doc/riece-ja.texi b/doc/riece-ja.texi index f96e8e9..27052cc 100644 --- a/doc/riece-ja.texi +++ b/doc/riece-ja.texi @@ -3,7 +3,7 @@ @setfilename riece-ja.info @settitle Riece -- An IRC client for Emacsen -- @c %**end of header -@set VERSION 0.0.4 +@set VERSION 1.0.7 @c @documentlanguage ja @dircategory GNU Emacs Lisp @@ -14,7 +14,7 @@ @ifinfo This file describes Riece. -Copyright (C) 2003 Daiki Ueno. +Copyright (C) 2003,2004,2005 Daiki Ueno. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -33,7 +33,7 @@ Free Documentation License". @page @vskip 0pt plus 1filll -Copyright @copyright{} 2003 Daiki Ueno. +Copyright @copyright{} 2003,2004,2005 Daiki Ueno. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -54,8 +54,9 @@ Riece $B$O(B Emacs $B$G(B IRC (Internet Relay Chat) $B$K;22C$9$k$?$a$N%W%m% @menu * Overview:: Riece $B$H$O2?$+(B * Getting started:: -* Basic usage:: $B4pK\E*$J$D$+$$$+$?(B -* Advanced usage:: $B?J$s$@$D$+$$$+$?(B +* Basic usage:: $B4pK\E*$J;H$$J}(B +* Advanced usage:: $B?J$s$@;H$$J}(B +* Tips:: $BJXMx$J@_Dj(B * Development:: $B3+H/pJs(B * Index:: * Function Index:: @@ -66,23 +67,25 @@ Riece $B$O(B Emacs $B$G(B IRC (Internet Relay Chat) $B$K;22C$9$k$?$a$N%W%m% @chapter Overview Riece $B$O!"D9$$4V%a%s%F%J%s%9IT2DG=$J>uBV$K$"$C$?(B Liece $B$N%3!<%I$r40A4$K(B -$B=q$-D>$7$?$b$N$G$9!#%$%s%?!<%U%'!<%9$O!"(BLiece $B$+$i$[$H$s$I$=$N$^$^F'=1$7(B -$B$F$$$^$9!#(B +$B=q$-D>$7$?$b$N$G$9!#%f!<%6%$%s%?!<%U%'!<%9$NBgItJ,$O(B Liece $B$N$b$N$rF'=1(B +$B$7$F$$$^$9!#(B -$B8=:_$N$H$3$m(B IRC $B%/%i%$%"%s%H$H$7$F$N5!G=$O==J,$G$O$"$j$^$;$s$,!"(BLiece -$B$K$O$J$$FCD9$,$$$/$D$+$"$j$^$9!#0J2<$K$=$l$i$N0lIt$r5s$2$^$9!#(B +Riece $B$K$O(B Liece $B$K$O$J$$FCD9$,$$$/$D$+$"$j$^$9!#(B +$B0J2<$K$=$l$i$N0lIt$r5s$2$^$9!#(B @itemize @bullet -@item $BJ#?t$N%5!<%P$KF1;~$K$D$J$2$k(B -@item $B0l1~(B API $B$i$7$$(B API $B$,MQ0U$5$l$F$$$k(B -@item $B%3!<%I%5%$%:$,>.$5$$(B (Liece $B$NH>J,DxEY(B) -@item $B%"%I%*%s$K$h$k3HD%$,2DG=(B -@item APEL $B$,$$$i$J$$(B +@item $BJ#?t$N(B IRC $B%5!<%P$KF1;~$K@\B32DG=(B +@item $B%"%I%*%s$K$h$j5!G=$NDI2C$d$N(B elisp $B%Q%C%1!<%8$K0MB8$7$J$$$?$a!"%$%s%9%H!<%k$,4JC1(B +@item $B@_Dj$,4JC1$G!"A02s5/F0;~$N@_Dj$r5-O?!&I|85$9$k;EAH$_$rDs6!(B +@item $BCJ3,E*$JA`:n@bL@=q$,ImB0(B +@item $B:G?7$N(B IRC $B$N%/%i%$%"%s%H%W%m%H%3%k(B (RFC2812) $B$K=`5r(B @end itemize $B$h$j>\$7$$>pJs$O!"0J2<$N%Z!<%8$r8fMw$/$@$5$$!#(B @itemize @bullet +@item http://www.nongnu.org/riece/ @item http://wiliki.designflaw.org/index.cgi?Riece&l=jp @item http://www.unixuser.org/~ueno/liece/ @end itemize @@ -123,7 +126,7 @@ make install XEmacs $B$N%Q%C%1!<%8$H$7$F%$%s%9%H!<%k$9$k>l9g$K$O0J2<$N$h$&$K$7$^$9!#(B @example -./configure --with-xemacs[=xemacs-21.4.13] +./configure --with-xemacs[=xemacs-21.4.15] make package make install-package @end example @@ -139,25 +142,28 @@ XEmacs $B$N%Q%C%1!<%8$H$7$F%$%s%9%H!<%k$7$?>l9g$K$OI,MW$"$j$^$;$s$,!"(B @node Startup File, , Installation, Getting started @section Startup file -$B$O$8$a$F$D$+$&>l9g$K$O!"$H$/$K2?$b@_Dj$9$kI,MW$O$"$j$^$;$s!#(B -$B$3$N>O$OFI$_Ht$P$7$F$/$@$5$$!#(B +$B$3$N>O$G$O!"@_Dj%U%!%$%k$K$D$$$F2r@b$7$^$9!#(B + +$B;n$7$K;H$C$F$_$k>l9g$K$O!"FC$K2?$b@_Dj$9$kI,MW$O$"$j$^$;$s!#(B +$B$3$N>O$OFI$_Ht$P$7$F$b9=$$$^$;$s!#(B Riece $B$O@_Dj%U%!%$%k$rJQ?t(B @code{riece-directory} $B$G;X<($5$l$k%G%#%l%/%H(B $B%j(B ($B%G%U%)%k%H$O(B @file{~/.riece/}) $B$+$iFI$_9~$_$^$9!#$3$N%G%#%l%/%H%j$K(B -$B$O0J2<$NFspJs$r3JG<$7$^$9(B($B%G%U%)%k%H$O(B @file{~/.riece/save}) +$BA02s$N%;%C%7%g%s$G99?7$5$l$?@_Dj$,<+F0E*$KJ]B8$5$l$^$9(B($B%G%U%)%k%H$O(B @file{~/.riece/save}) @item riece-variables-file @vindex riece-variables-file $B%f!<%6$K8GM-$N@_Dj$r5-=R$7$^$9(B($B%G%U%)%k%H$O(B @file{~/.riece/init}) @end table $B5/F0;~$K$O!":G=i$K(B @code{riece-saved-variables-file} $B$r!"e=q$-$5$l$^$9!#(B @node Basic usage, Advanced usage, Getting started, Top @chapter Basic usage @@ -176,10 +182,10 @@ Riece $B$O@_Dj%U%!%$%k$rJQ?t(B @code{riece-directory} $B$G;X<($5$l$k%G%#%l%/% $B%f!<%6$N%m%0%$%sL>$,$=$N$^$^;H$o$l$^$9!#(B @vindex riece-nickname -$BL5;v$K@\B3$G$-$?$J$i!"$r?R$M$i$l$k$N$G!"E,Ev$J%A%c%s%M(B -$B%kL>$rF~NO$7$^$7$g$&!#$?$H$($P(B IRCnet $B$K$O(B @samp{#Liece} $B$H$$$&%A%c%s%M(B -$B%k$,$"$k$N$G!"%F%9%H$K$*;H$$$/$@$5$$!#(B +$BL5;v$K@\B3$G$-$?$i!"$r?R$M$i$l$k$N$G!"E,Ev$J%A%c(B +$B%s%M%kL>$rF~NO$7$^$7$g$&!#(BIRCnet $B$K$O(B @samp{#Riece} $B$H$$$&%A%c%s%M%k$,$"(B +$B$k$N$G!"%F%9%H$K$*;H$$$/$@$5$$!#(B $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(B $B$k$3$H$,$G$-$^$9!#B>$N?M$N2qOC$O2hLL1&>e$N%P%C%U%!$KI=<($5$l$^$9!#(B @@ -191,10 +197,10 @@ Riece $B$O@_Dj%U%!%$%k$rJQ?t(B @code{riece-directory} $B$G;X<($5$l$k%G%#%l%/% * Connecting to multiple servers:: $BJ#?t$N%5!<%P$K$D$J$0$K$O(B @end menu -@node Windows, Commands, Basic usage, Basic usage +@node Windows, Indicators, Basic usage, Basic usage @section Windows -$B%G%U%)%k%H$N@_Dj$G$O!"%A%c%s%M%k$KF~$k$H!"2<$N?^$K<($9$h$&$J8^$D$N%&%#%s(B +$B%G%U%)%k%H$N@_Dj$G$O!"%A%c%s%M%k$KF~$k$H!"2<$N?^$K<($9$h$&$J(B 5 $B$D$N%&%#%s(B $B%I%&$+$i$J$k2hLL$K@Z$jBX$o$j$^$9!#(B @example @@ -236,7 +242,7 @@ Riece $B$O@_Dj%U%!%$%k$rJQ?t(B @code{riece-directory} $B$G;X<($5$l$k%G%#%l%/% $B%"%6!<%:%P%C%U%!(B (@samp{*Others*})$B!#8=:_$N%A%c%s%M%k0J30$N2qOC$,N.$l$^$9!#(B @end enumerate -@node Indicators +@node Indicators, Commands, Windows, Basic usage @section Indicators $B%3%^%s%I%P%C%U%!$d%A%c%s%M%k%P%C%U%!$N%b!<%I%i%$%s$N:8C<$K$O!"(B @@ -261,7 +267,7 @@ Riece: --- ueno #Liece [n] $B$P(B @samp{f}) @end enumerate -@node Commands, Connecting to multiple servers, Windows, Basic usage +@node Commands, Connecting to multiple servers, Indicators, Basic usage @section Commands $BJ8>O$rF~NO$7$?%P%C%U%!$O!"%3%^%s%I%P%C%U%!$H8F$P$l!"%3%^%s%I%P%C%U%!$+$i(B @@ -281,6 +287,9 @@ Riece: --- ueno #Liece [n] @item C-c C-p @findex riece-command-part $B%A%c%s%M%k$+$iN%C&$7$^$9(B(@code{riece-command-part}) +@item C-c p +@findex riece-command-enter-message-to-user +$B08@h$r;XDj$7$F8=:_$N9T$rAw$j$^$9(B(@code{riece-command-enter-message-to-user}) @item C-c q @findex riece-command-quit IRC $B$r$d$a$^$9(B(@code{riece-command-quit}) @@ -313,10 +322,13 @@ IRC $B$r$d$a$^$9(B(@code{riece-command-quit}) $B%A%c%s%M%k$N%b!<%I$r@_Dj$7$^$9(B(@code{riece-command-change-mode}) @item C-c o @findex riece-command-set-operators -$B%f!<%6$K%*%Z%l!<%?8"8B$rM?$($^$9!#A0CV0z?t(B (@kbd{C-u}) $B$rM?$($k$H!"%f!<%6$+$iH/8@8"$rC%$$$^$9(B(@code{riece-command-set-operators}) +$B%f!<%6$K%*%Z%l!<%?8"8B$rM?$($^$9!#A0CV0z?t(B (@kbd{C-u}) $B$rM?$($k$H!"%f!<%6$+$i%*%Z%l!<%?8"8B$rC%$$$^$9(B(@code{riece-command-set-operators}) @item C-c v @findex riece-command-set-speakers $B%f!<%6$KH/8@8"$rM?$($^$9!#A0CV0z?t(B (@kbd{C-u}) $B$rM?$($k$H!"%f!<%6$+$iH/8@8"$rC%$$$^$9(B(@code{riece-command-set-speakers}) +@item C-c V +@findex riece-version +Riece $B$N%P!<%8%g%s$rI=<($7$^$9!#A0CV0z?t(B (@kbd{C-u}) $B$rM?$($k$H!"$h$j>\:Y$J>pJs$rI=<($7$^$9!#(B @item C-c / @findex riece-command-raw $B@8$N(B IRC $B%3%^%s%I$rAw$j$^$9(B(@code{riece-command-raw}) @@ -336,12 +348,18 @@ IRC $B$r$d$a$^$9(B(@code{riece-command-quit}) @item C-c > @findex riece-command-next-channel $BeC<$^$G0\F0$7$^$9(B(@code{riece-command-beginning-of-buffer}) @item C-c $ @findex riece-command-end-of-buffer $B%A%c%s%M%k%P%C%U%!!"$^$?$O%@%$%"%m%0%P%C%U%!$N%S%e!<$r2uBV$r@Z$jBX$($^$9(B(@code{riece-command-toggle-away}) @@ -410,7 +430,7 @@ Riece $B$NBg$-$JFCD9$K!"J#?t$N%5!<%P$KF1;~$K@\B3$9$k5!G=$,$"$j$^$9!#(B $BFCDj$N%5!<%P$KBP$7$F!"B3$/%3%^%s%I$rH/9T$7$^$9(B(@code{riece-command-universal-server-name-argument}) @end table -@node Advanced usage, Development, Basic usage, Top +@node Advanced usage, Tips, Basic usage, Top @chapter Advanced usage $B$3$N>O$G$O!"$b$C$H?J$s$@;H$$J}$r2r@b$7$^$9!#(B @@ -418,17 +438,20 @@ Riece $B$NBg$-$JFCD9$K!"J#?t$N%5!<%P$KF1;~$K@\B3$9$k5!G=$,$"$j$^$9!#(B @menu * Server settings:: $B%5!<%P$N>\:Y@_Dj(B * Add-ons:: $B%"%I%*%s$H$O(B -* Writing add-ons:: $B@lMQ$N%"%I%*%s$r=q$/$K$O(B -* Handler hooks:: $B%O%s%I%i$N?6Iq$$$NJQ99(B @end menu @node Server settings, Add-ons, Advanced usage, Advanced usage @section Server settings -IRC $B%5!<%P$O(B @code{riece-server} $BJ8;zNs$H$7$F;XDj$7$^$9!#(B -$B$3$3$G(B @code{riece-server} $B$N%U%)!<%^%C%H$O(B "<$B%5!<%P$N%[%9%HL>(B>:<$B%]!<%HHV9f(B>[:<$B%Q%9%o!<%I(B>]" $B$H$J$j$^$9!#(B +$B5/F0;~$K%G%U%)%k%H$G@\B3$9$k(B IRC $B%5!<%P$O(B @code{riece-server} $B$G;XDj$7$^$9!#(B @vindex riece-server +$B$3$3$G(B @code{riece-server} $B$OJ8;zNs$G$"$j!"$=$N%U%)!<%^%C%H$O(B>:<$B%]!<%HHV9f(B>[:<$B%Q%9%o!<%I(B>]" +@end example + @code{riece-server-alist} $B$rE,@Z$K@_Dj$9$k$H!"%-!<%o!<%I$r;H$C$F!"$h$j>\(B $B:Y$J;XDj$,2DG=$K$J$j$^$9!#0J2<$OI.Aw(B $B%_%K%P%C%U%!$N$_$G(B IRC $B$r$9$k(B @item riece-log $B2qOC$N%m%0$N<}=8(B +@item riece-doctor +doctor.el $B$HO"7H$7$F@:?@2J0e$K$J$j$9$^$9(B @item riece-alias $B%A%c%s%M%kL>$d%K%C%/%M!<%`$NJLL>$rDj5A(B +@item riece-skk-kakutei +SKK $B;HMQ;~$KJQ49%b!<%I$N0u$rH/8@$+$iuBV$K$J$k$3$H$KHw$(!"(B +PING $B$K1~Ez$9$k(B local proxy $B7PM3$G(B IRC $B%5!<%P$K@\B3(B +@item riece-lsdb +$B%"%I%l%9D"(B LSDB (Lovely Sister Database) +@uref{http://lsdb.sourceforge.jp} $B$HO"7H(B +@item riece-xface +$B%f!<%6%j%9%H%P%C%U%!$K%f!<%6$N(B X-Face $B$rI=<((B +@item riece-ctlseq +$B%3%s%H%m!<%k%7!<%1%s%9(B (^B $B$J$I(B) $B$K$h$k6/D4I=<((B +@item riece-ignore +$B;XDj$7$?%f!<%6$NH/8@$rL5;k(B +@item reice-hangman +$B%A%c%s%M%kFb$G(B hangman(6) $B$GM7$V(B +@item riece-biff +$BB>$N%P%C%U%!$K$$$k;~$KH/8@$,$"$k$H%b!<%I%i%$%s$K0u(B ("[R]") $B$rI=<((B +@item riece-kakasi +$BF|K\8l$NDL$i$J$$C2A(B +@item riece-google +$B%-!<%o!<%I$r(B Google $B$G8!:w(B +@item riece-keepalive +IRC $B%5!<%P$H$N@\B3$rJ];}(B @end table -$B$3$l$i$N$&$A!"(B@samp{riece-highlight} $B$H(B @samp{riece-ctcp} $B$O%G%U%)%k%H$G(B -$BAH$_9~$^$l$F$$$^$9!#(B +$B$3$l$i$N$&$A!"(B@samp{riece-highlight} $B$H(B @samp{riece-ctcp}$B!"(B +@samp{riece-url}$B!"(B @samp{riece-unread}$B!"(B @samp{riece-guess}$B!"(B +@samp{riece-history}$B!"(B @samp{riece-button}$B!"(B@samp{riece-menu}$B!"(B +@samp{riece-ignore}$B!"(B@samp{riece-log}$B!"(B@samp{riece-alias}$B!"(B +@samp{riece-ctlseq}$B!"(B@samp{riece-keyword} $B$O%G%U%)%k%H$GAH$_9~$^$l$F$$$^$9!#(B $B%"%I%*%s$rAH$_9~$`$K$O(B @code{riece-addons} $B$r@_Dj$7$^$9!#$?$H$($P(B -@samp{riece-url} $B$rAH$_9~$`>l9g$K$O!"(B@file{~/.riece/init.el} $B$K0J2<$N$h(B +@samp{riece-alias} $B$rAH$_9~$`>l9g$K$O!"(B@file{~/.riece/init.el} $B$K0J2<$N$h(B $B$&$K5-=R$7$^$9!#(B @vindex riece-addons @example -(add-to-list 'riece-addons 'riece-url) +(add-to-list 'riece-addons 'riece-alias) @end example -@node Writing add-ons, Handler hooks, Add-ons, Advanced usage -@section Writing add-ons +@node Tips, Development, Advanced usage, Top +@comment node-name, next, previous, up +@chapter Tips -$B%"%I%*%s$N>r7o$rK~$?$9%b%8%e!<%k$O0J2<$N4X?t$rDs6!$7$^$9!#(B +$B$3$N>O$G$O!"$h$/J9$+$l$kR2p$7$^$9!#(B -@table @samp -@item <$B%b%8%e!<%kL>(B>-requires -$B0MB8$9$kB>$N%"%I%*%s(B($B%7%s%\%k$N%j%9%H(B)$B$rJV$7$^$9(B($B%*%W%7%g%s(B) -@item <$B%b%8%e!<%kL>(B>-insinuate -$B=i4|2==hM}$r9T$$$^$9(B -@end table +@section $B%A%c%s%M%kL>!V(B#$B$[$2(B:*.jp$B!W$r!V(B%$B$[$2!W$HN,5-$7$?$$(B -Riece $BB&$G$O0J2<$N=hM}$r9T$$$^$9!#(B +$B0J2<$N9T$r(B @file{~/.riece/init.el} $B$KDI2C$7$^$9!'(B -@enumerate -@item -$BJQ?t(B @code{riece-addons} $B$KNs5s$5$l$?%b%8%e!<%k$rFI$_9~$`(B +@example +(add-to-list 'riece-addons 'riece-alias) +@end example -@item -$B$=$l$>$l$N%b%8%e!<%k$KBP$7!"(B@samp{<$B%b%8%e!<%kL>(B>-requires} $B$,MQ0U$5$l$F$$$l$P8F$S=P$7$F0MB8%0%i%U$r:n$k(B +@section $BD>A0$K$$$?%A%c%s%M%k$KLa$j$?$$(B +@vindex riece-guess-channel-try-functions -@item -$B0MB8%0%i%U$KBP$7$F%H%]%m%8%+%k%=!<%H(B (cf. tsort(1)) $B$r9T$&(B +$B0J2<$N9T$r(B @file{~/.riece/init.el} $B$KDI2C$9$k$3$H$G!"(B +@kbd{C-c g} $B$GMzNr$rC)$j$D$D0\F0$G$-$^$9!#(B -@item -$BF@$?0MB8=g=x$K=>$C$F(B @samp{<$B%b%8%e!<%kL>(B>-insinuate} $B8F$S=P$9(B -@end enumerate +@example +(add-hook 'riece-guess-channel-try-functions + 'riece-guess-channel-from-history) +@end example -$B:n@.$7$?%"%I%*%s$O!"(B@code{load-path} $B$NDL$C$?%G%#%l%/%H%j!"$^$?$O(B -@code{riece-addon-directory} ($B%G%U%)%k%H$G$O(B @file{~/.riece/addons/}) $B$K(B -$BCV$/$3$H$GAH$_9~$_2DG=$J>uBV$K$J$j$^$9!#(B -@vindex riece-addon-directory +@section $BH/8@$,$"$k$H%P%C%U%!$,%9%/%m!<%k$9$k$N$r;_$a$?$$(B -@node Handler hooks, , Writing add-ons, Advanced usage -@section Handler hooks +@kbd{C-c C-t f} $B$G$9!#(B(irchat $B$G$O(B @kbd{C-c C-f}) "t"oggle "f"reeze $B$H3P(B +$B$($^$7$g$&!#(B -Riece $B$K$O!"%O%s%I%i%U%C%/$H8F$P$l$kFC~$rM^@)$7$?$$(B -$B@bL@$N$?$a$K(B @samp{message} $B$r(B IRC $B$N%a%C%;!<%8L>(B(PRIVMSG $B$J$I(B)$B$rA4$F>.(B -$BJ8;z$K$7$?$b$N$H$7$^$9!#(B +@code{riece-addons} $B$+$i!"?'IU$1(B (@samp{riece-highlight})$B!"%\%?%s(B +(@samp{riece-button})$B!"%"%$%3%s(B (@samp{riece-icon}) $B$r=|$-$^$9!#(B -@table @code -@item riece--hook -@samp{message} $B$,FO$$$?$H$-$K:G=i$K8F$P$l$k%U%C%/(B -@item riece-after--hook -@samp{message} $B$N=hM}$,=*$o$C$?8e$K8F$P$l$k%U%C%/(B +$B$?$H$($P?'IU$1$r$d$a$?$$$N$G$"$l$P!"0J2<$N9T$r(B @file{~/.riece/init.el} +$B$KDI2C$7$^$9!'(B + +@example +(setq riece-addons (delq 'riece-highlight riece-addons)) +@end example + +@section $B%-!<%o!<%I$KH?1~$7$F2;$rLD$i$7$?$$(B +@vindex riece-keyword-notify-functions + +XEmacs $B$G$O!"0J2<$N@_Dj$r(B @file{~/.riece/init.el} $B$K2C$($k$3$H$G!"(B"$B$[$2(B" +$B$d(B "$B$U$,(B" $B$KH?1~$7$F8z2L2;(B($B$3$NNc$G$O!"%+%C%3!<$NLD$-@<(B)$B$rLD$i$9$3$H$,$G(B +$B$-$^$9!#(B + +@example +(load-default-sounds) +(setq riece-keywords '("$B$[$2(B" "$B$U$,(B")) +(add-hook 'riece-keyword-notify-functions + (lambda (keyword message) (play-sound 'cuckoo))) +@end example + +Emacs $B$N>l9g$O(B,$B0J2<$N@_Dj$r(B @file{~/.riece/init.el} $B$K2C$($k$3$H$G(B, +"$B$[$2(B" $B$d(B "$B$U$,(B" $B$KH?1~$7$F2;$rLD$i$9$3$H$,$G$-$^$9!#(B + +@example +(defun cuckoo () + "play cuckoo.au" + (call-process "play" nil 0 t + ".../cuckoo.au")) + (setq riece-keywords '("$B$[$2(B" "$B$U$,(B")) + (add-hook 'riece-keyword-notify-functions + (lambda (keyword message) (cuckoo))) +@end example + +$B8z2L2;$G$O$J$/%7%s%W%k$K%S!<%W2;$rLD$i$7$?$$>l9g$O!"0J2<$N@_Dj$r(B +@file{~/.riece/init.el} $B$K2C$($^$9!#(B + +@example +(setq riece-keywords '("$B$[$2(B" "$B$U$,(B")) +(add-hook 'riece-keyword-notify-functions + (lambda (keyword message) (ding))) +@end example + +@section SKK $B$r;H$C$F$$$F!"JQ49%b!<%I$N0u(B ($B"&(B) $B$rAw?.$7$?$/$J$$(B + +$B0J2<$N9T$r(B @file{~/.riece/init.el} $B$KDI2C$7$^$9!'(B + +@example +(add-to-list 'riece-addons 'riece-skk-kakutei) +@end example + +@section $B%A%c%s%M%k$NHV9f$r8GDj$7$?$$(B +@vindex riece-default-channel-binding + +$B0J2<$N9T$r(B @file{~/.riece/init.el} $B$KDI2C$7$^$9!'(B + +@example +(setq riece-default-channel-binding + '("#Liece" "#emacsen" nil "#debianjp")) +@end example + +1: #Liece, 2: #emacsen, 4: #debianjp $B$N$h$&$K3dEv$F$i$l$^$9!#(Bnil $B$O%G%U%)(B +$B%k%H$G$O<+F03dEv$F$NBP>]$K$J$i$J$$$3$H0UL#$7!"?7$?$J%A%c%s%M%k$K;22C$7$?(B +$B>l9g!"$=$N%A%c%s%M%k$,(B 3 $BHVL\$N%A%c%s%M%k$H$7$F07$o$l$^$9!#(B + +@section $B5/F0;~$K%Q%9%o!<%I$D$-$N%A%c%s%M%k$K;22C$7$?$$(B +@vindex riece-startup-channel-list +@vindex riece-startup-server-list + +$B0J2<$N9T$r(B @file{~/.riece/init.el} $B$KDI2C$7$^$9!'(B + +@example +(setq riece-startup-channel-list + '(("#secret" "password") "#Liece")) +@end example + +$BJ#?t$N%5!<%P>e$N%A%c%s%M%k$K;22C$9$k$K$O!"(B +@code{riece-startup-server-list} $B$bJ;$;$F@_Dj$9$kI,MW$,$"$j$^$9!#(B + +$BNc$H$7$F!"(B@code{riece-server} $B$H(B @code{riece-server-alist} $B$r0J2<$N$h$&(B +$B$K@_Dj$7$?$H$7$^$9!#(B + +@example +(setq riece-server "ircnet" + riece-server-alist '(("ircnet" :host "irc6.nara.wide.ad.jp") + ("freenode" :host "irc.ipv6.freenode.net"))) +@end example + +$B$3$N>l9g!"%G%U%)%k%H$G$O(B "ircnet" $B$@$1$K@\B3$7$^$9$,!"(B +@code{riece-startup-server-list} $B$r0J2<$N$h$&$K@_Dj$9$k$3$H$G!"(B +"freenode" $B$K$b@\B3$9$k$h$&$K$J$j$^$9!#(B + +@example +(setq riece-startup-server-list '("freenode")) +@end example + +@section HTTP $B%W%m%-%71[$7$K(B IRC $B%5!<%P$K@\B3$7$?$$(B +relay.el $B$H(B connect.c $B$r;H$&$H!"(B +HTTP $B%W%m%-%7$r2p$7$F(B IRC $B%5!<%P$K@\B3$9$k$3$H$,$G$-$^$9!#(B + +@table @asis +@item relay.el +@uref{http://www.taiyo.co.jp/~gotoh/lisp/relay.el} + +@item connect.c +@uref{http://www.taiyo.co.jp/~gotoh/ssh/connect.html} @end table -$B$3$3$G(B @code{riece--hook} $B$NJV$jCM$K$O0UL#$,$"$j!"Hs(B nil $B$rJV$9(B -$B$b$N$,$"$l$P!"$=$N8e$N=hM}$r$*$3$J$$$^$;$s!#$^$?!"$=$N>l9g$K$O(B -@code{riece-after--hook} $B$b8F$S=P$5$l$^$;$s!#(B +$B$?$H$($P!"(B"proxy.example.com:8080" $B7PM3$G(B irc.tokyo.wide.ad.jp $B$K@\B3$9(B +$B$k>l9g$K$O!"0J2<$N9T$r(B @file{~/.riece/init.el} $B$KDI2C$7$^$9!'(B -$B%U%C%/$N0z?t$O(B RFC2812 $B$N(B @samp{prefix} $B$H(B @samp{Parameters} $B$KAjEv$9$k(B -2 $B$D$N0z?t$,EO$j$^$9!#(B +@example +(require 'relay) +(setq relay-command-alist (cons '("^irc\.tokyo\.wide\.ad\.jp$" + "connect" "-H" "proxy.example.com:8080" + host service) + relay-command-alist) + riece-server-alist (cons '("proxy-tokyo" :host "irc.tokyo.wide.ad.jp" + :function relay-open-network-stream) + riece-server-alist)) +@end example + +@section IRC $B%m%0$r%U%!%$%k$KJ]B8$7$?$$(B +@vindex riece-log-directory-map + +$B0J2<$N9T$r(B @file{~/.riece/init.el} $B$KDI2C$7$^$9!'(B + +@example +(add-to-list 'riece-addons 'riece-log) +@end example + +$B%m%0%U%!%$%k$O%G%U%)%k%H$G$O(B @file{~/.riece/log} $B$N2<$K%5!<%PL>!"%A%c%s(B +$B%M%kL>$N%G%#%l%/%j$,:n@.$5$l!"$=$NCf$KF|$K$AKh$KJ]B8$5$l$^$9!#$?$@$7%G%U%)(B +$B%k%H$N%5!<%P$N>l9g$O!"%5!<%PL>$N%G%#%l%/%H%j$O>JN,$5$l$^$9!#(B + +US-ASCII $B0J30$N%G%#%l%/%H%jL>$,J8;z2=$1$9$k$H$$$&?M$O!"(B +@code{file-name-coding-system} $B$NCM$rE,@Z$K@_Dj$9$k$+!"$"$k$$$O(B +@code{riece-log-directory-map} $B$G%A%c%s%M%kL>$HJ]B8@h$N%G%#%l%/%H%jL>$H(B +$B$NBP1~%j%9%H$r0J2<$NNc$N$h$&$K!"(BUS-ASCII $B$N$_$r;HMQ$7$?%G%#%l%/%H%jL>$K(B +$B$J$k$h$&$K@_Dj$9$k;v$G2sHr=PMh$^$9!'(B + +@example +(setq riece-log-directory-map '(("#$B$j!<$9(B" . "riece"))) +@end example -@node Development, Index, Advanced usage, Top +@node Development, Index, Tips, Top @chapter Development $B3+H/e0L$K$"$k$b$N$+$i!'(B -@subsection Core modules @table @samp @item riece-globals $BBg0hJQ?t$NDj5A(B @@ -634,13 +830,15 @@ autoreconf -f -i -v $B%f!<%6%*%W%7%g%s$NDj5A(B @item riece-version $B%P!<%8%g%s$NDj5A(B -@item riece-inlines -$B;(B?$J%$%s%i%$%s4X?t$NDj5A(B @item riece-coding $B%3!<%G%#%s%0%7%9%F%`4XO"$N4X?t$NDj5A(B @item riece-complete $B%_%K%P%C%U%!$G$NJd40$r=u$1$k4X?t$NDj5A(B +@item riece-addon +$B%"%I%*%s4IM}(B +@item riece-mode +channel/user $B$N%b!<%I4IM}(B @item riece-identity channel/user object $B$NBg0hI=5-$rA`:n$9$k4X?t$NDj5A(B @item riece-channel @@ -649,7 +847,12 @@ channel object $B4XO"$NDj5A(B user object $B4XO"$NDj5A(B @item riece-misc -$B;(B?$J4X?t$NDj5A(B($B%$%s%i%$%s4X?t$r=|$/(B) +$B;(B?$J4X?t$NDj5A(B +@item riece-signal +$B%7%0%J%k(B(@pxref{Signals})$B4IM}(B + +@item riece-layout +$B%&%#%s%I%&%l%$%"%&%H4IM}(B @item riece-display $BI=<(MQ%P%C%U%!$N4IM}(B @item riece-server @@ -663,42 +866,27 @@ message object $B4XO"$NDj5A(B @item riece-filter $B%W%m%;%9%U%#%k%?$N%(%s%H%j%]%$%s%H(B @item riece-handle -$BDL>o$N%a%C%;!<%8$N%O%s%I%i!#(Briece-filter $B$N$_$+$i8F$P$l$k(B +$BDL>o$N%a%C%;!<%8$N%O%s%I%i!#(Briece-filter $B$+$i8F$P$l$k(B @item riece-000 -000$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$N$_$+$i8F$P$l$k(B +000$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$+$i8F$P$l$k(B @item riece-200 -200$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$N$_$+$i8F$P$l$k(B +200$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$+$i8F$P$l$k(B @item riece-300 -300$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$N$_$+$i8F$P$l$k(B +300$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$+$i8F$P$l$k(B @item riece-400 -400$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$N$_$+$i8F$P$l$k(B +400$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$+$i8F$P$l$k(B @item riece-500 -500$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$N$_$+$i8F$P$l$k(B +500$BHVBf$N(B numeric reply $B$N%O%s%I%i!#(Briece-filter $B$+$i8F$P$l$k(B @item riece-commands $B%3%^%s%I$NDj5A(B +@item riece-irc +IRC $B%W%m%H%3%k%$%s%?!<%U%'!<%9(B @item riece $B%(%s%H%j%]%$%s%H!#3F%P%C%U%!$N%b!<%IDj5A$J$I(B @end table -@subsection Add-ons -@table @samp -@item riece-highlight -$B%P%C%U%!$N?'IU$1(B -@item riece-ctcp -CTCP (Client To Client Protocol) -@item riece-url -$B2qOC$K8=$l$?(B URL $B$N<}=8(B -@item riece-unread -$BH/8@$N$"$C$?%A%c%s%M%k$K(B@samp{!}$B%^!<%/$r$D$1$k(B -@item riece-rdcc -DCC (Direct Client to Client protocol) $B$K$h$k%U%!%$%kE>Aw(B (Ruby $B$K$h$kAw(B (Emacs 21.3 $B$N(B -@code{make-network-connection} $B$K$h$kA06u4V$r4IM}(B @@ -709,7 +897,7 @@ Riece $B$OJ#?t$N%5!<%P$KF1;~$K@\B3$9$k$?$a!"%5!<%PKh$KJL!9$NL>A06u4V$r4IM}(B $B%5!<%P$N%W%m%;%9$rF@$k$K$O!"$^$:$O$8$a$K%5!<%P$NL>A0$rF@$kI,MW$,$"$j(B $B$^$9!#%5!<%P$NL>A0$O0J2<$K5s$2$k$$$/$D$+$NJ}K!$GA06u4V$r4IM}(B @item @samp{riece-identity} $B%*%V%8%'%/%H$K7k$SIU$1$i$l$?%5!<%PL>(B($B8e=R(B) -@end table +@end enumerate $B$3$&$7$FF@$?%5!<%PL>$G(B @code{riece-server-process} $B$r8F=P$7!"%5!<%P$N(B $B%W%m%;%9$rA0$,JQ99$5$l$?$3$H$rI=L@$7$^$9(B @end defun +@node Signals, Writing add-ons, Namespace management, Development +@section Signals + +$B2hLL$N:FIA2h$r8zN(NI$/9T$&$?$a$K!"%$%Y%s%H$HIA2hBP>]$N%*%V%8%'%/%H(B($B%P%C(B +$B%U%!$d!"%b!<%I%i%$%s$N0u(B @pxref{Indicators})$B$r7k$SIU$1$k%a%+%K%:%`$rMQ0U(B +$B$7$F$$$^$9!#(B + +$B2?$i$+$N%$%Y%s%H$,H/@8$9$k$H!"%7%0%J%k$,Aw=P$5$l$^$9!#%7%0%J%k$N35G0$O!"(B +Qt $B$d(B GTK+ $B$H$$$C$?(B GUI $B%D!<%k%-%C%H$KMQ0U$5$l$F$$$k$b$N$HF1MM$G$9!#(B + +$B%7%0%J%k$rAw=P$9$k$K$O!"(B@samp{riece-emit-signal} $B$r;H$$$^$9!#(B + +@defun riece-emit-signal signal-name &rest args +@var{signal-name} $B$G;X<($5$l$k%7%0%J%k$r!"0z?t(B @var{args} $B$H$H$b$KAw=P$7$^$9(B +@end defun + +$B%7%0%J%k$K1~Ez$9$k$K$O!"(B@samp{riece-connect-signal} $B$r;H$$$^$9!#(B + +@defun riece-connect-signal signal-name slot-function &optional filter-function handback +@var{signal-name} $B$G;X<($5$l$k%7%0%J%k$K1~Ez$9$k4X?t(B @var{slot-function} +$B$r7k$SIU$1$^$9!#(B@var{slot-function} $B$K;XDj$5$l$?4X?t$O(B 2 $B$D$N0z?t$rl9g$K$O!"(B +@var{slot-function} $B$,8F$P$l$k$3$H$O$"$j$^$;$s!#(B +@end defun + +$B%7%0%J%k%*%V%8%'%/%H$K%"%/%;%9$9$k$K$O!"0J2<$N4X?t$r;H$$$^$9!#(B + +@defun riece-signal-name +$B%7%0%J%k$NL>A0(B($B%7%s%\%k(B)$B$rJV$7$^$9!#(B +@end defun + +@defun riece-signal-args +$B%7%0%J%kAw=P;~$KM?$($i$l$?0z?t$rJV$7$^$9!#(B +@end defun + +$B8=:_!"0J2<$N%7%0%J%k$,I8=`$GEPO?$5$l$F$$$^$9!'(B + +@table @samp +@item channel-list-changed +$B;22C$7$F$$$k%A%c%s%M%k$N0lMw$NJQ2=(B +@item user-list-changed +$B%A%c%s%M%k$N;22CA0$rJQ99(B +($B0z?t$O!"0JA0$H8=:_$NL>A0$KAjEv$9$k(B @samp{riece-identity} $B%*%V%8%'%/%H(B) +@item user-away-changed +$B%f!<%6$NN%@J>uBV$NJQ2=(B +($B0z?t$O!"%f!<%6$KAjEv$9$k(B @samp{riece-identity} $B%*%V%8%'%/%H(B) +@item user-operator-changed +$B%f!<%6$N%*%Z%l!<%?>uBV$NJQ2=(B +($B0z?t$O!"%f!<%6$KAjEv$9$k(B @samp{riece-identity} $B%*%V%8%'%/%H(B) +@item channel-topic-changed +$B%A%c%s%M%k$N%H%T%C%/$NJQ2=(B +($B0z?t$O!"%A%c%s%M%k$KAjEv$9$k(B @samp{riece-identity} $B%*%V%8%'%/%H(B) +@item channel-modes-changed +$B%A%c%s%M%k$N%b!<%I$NJQ2=(B +($B0z?t$O!"%A%c%s%M%k$KAjEv$9$k(B @samp{riece-identity} $B%*%V%8%'%/%H(B) +@item channel-operators-changed +$B%A%c%s%M%k$G%*%Z%l!<%?8"8B$r;}$D%f!<%6$N0lMw$NJQ2=(B +($B0z?t$O!"%A%c%s%M%k$KAjEv$9$k(B @samp{riece-identity} $B%*%V%8%'%/%H(B) +@item channel-speakers-changed +$B%A%c%s%M%k$GH/8@8"$r;}$D%f!<%6$N0lMw$NJQ2=(B +($B0z?t$O!"%A%c%s%M%k$KAjEv$9$k(B @samp{riece-identity} $B%*%V%8%'%/%H(B) +@item buffer-freeze-changed +$B%P%C%U%!$NE`7k>uBV$NJQ2=(B +($B0z?t$O%P%C%U%!(B) +@end table + +@node Writing add-ons, Handler hooks, Signals, Development +@section Writing add-ons + +$B%"%I%*%s$N>r7o$rK~$?$9%b%8%e!<%k$O0J2<$N4X?t$rDs6!$7$^$9!#(B + +@table @samp +@item <$B%b%8%e!<%kL>(B>-requires +$B0MB8$9$kB>$N%"%I%*%s(B($B%7%s%\%k$N%j%9%H(B)$B$rJV$7$^$9(B($B%*%W%7%g%s(B) +@item <$B%b%8%e!<%kL>(B>-insinuate +$B=i4|2==hM}$r9T$$$^$9(B +@end table + +$B$^$?!"%"%I%*%s$N@bL@$r!"JQ?t(B @samp{<$B%b%8%e!<%kL>(B>-description} $B$K@_Dj$9(B +$B$k$3$H$b$G$-$^$9!#$3$NJ8;zNs$O(B @kbd{M-x riece-command-list-addons} $B$K$h(B +$B$k%"%I%*%s$N0lMwI=<($K;H$o$l$^$9!#(B + +$BM-8z2=!&L58z2=$KBP1~$7$?%"%I%*%s$O!"JQ?t(B @samp{<$B%b%8%e!<%kL>(B>-enabled} +$B$K8=:_$N>uBV$rJ];}$7$^$9!#CM$,(B @samp{nil} $B$G$"$l$PL58z!"(B@samp{t} $B$G$"$l(B +$B$PM-8z$G$9!#2C$($F!"0J2<$N4X?t$rDs6!$7$^$9!#(B + +@table @samp +@item <$B%b%8%e!<%kL>(B>-enable +$B%"%I%*%s$rM-8z$K$7$^$9(B +@item <$B%b%8%e!<%kL>(B>-disable +$B%"%I%*%s$rL58z$K$7$^$9(B +@end table + +Riece $B$O5/F0;~$K0J2<$N=hM}$r9T$$$^$9!#(B + +@enumerate +@item +$BJQ?t(B @code{riece-addons} $B$KNs5s$5$l$?%b%8%e!<%k$rFI$_9~$`(B + +@item +$B$=$l$>$l$N%b%8%e!<%k$KBP$7!"(B@samp{<$B%b%8%e!<%kL>(B>-requires} $B$,MQ0U$5$l$F$$$l$P8F$S=P$7$F0MB8%0%i%U$r:n$k(B + +@item +$B0MB8%0%i%U$KBP$7$F%H%]%m%8%+%k%=!<%H(B (cf. tsort(1)) $B$r9T$&(B + +@item +$BF@$i$l$?0MB8=g=x$K=>$C$F(B @samp{<$B%b%8%e!<%kL>(B>-insinuate} $B8F$S=P$9(B + +@item +$B$b$7!"%"%I%*%s$,M-8z2=!&L58z2=$KBP1~$7$F$*$j!"L@<(E*$KL58z2=$5$l$F$$$J$1$l$P!"(B +@samp{<$B%b%8%e!<%kL>(B>-enable}$B$r8F$S=P$9!#(B +@end enumerate + +$B:n@.$7$?%"%I%*%s$O!"(B@code{load-path} $B$NDL$C$?%G%#%l%/%H%j!"$^$?$O(B +@code{riece-addon-directory} ($B%G%U%)%k%H$G$O(B @file{~/.riece/addons/}) $B$K(B +$BCV$/$3$H$GAH$_9~$_2DG=$J>uBV$K$J$j$^$9!#(B +@vindex riece-addon-directory + +@node Handler hooks, , Writing add-ons, Development +@section Handler hooks + +Riece $B$K$O!"%O%s%I%i%U%C%/$H8F$P$l$kFC(B(PRIVMSG $B$J$I(B)$B$rA4$F>.(B +$BJ8;z$K$7$?$b$N$H$7$^$9!#(B + +@table @code +@item riece--hook +@samp{message} $B$,FO$$$?$H$-$K:G=i$K8F$P$l$k%U%C%/(B +@item riece-after--hook +@samp{message} $B$N=hM}$,=*$o$C$?8e$K8F$P$l$k%U%C%/(B +@end table + +$B$3$3$G(B @code{riece--hook} $B$NJV$jCM$K$O0UL#$,$"$j!"Hs(B nil $B$rJV$9(B +$B$b$N$,$"$l$P!"$=$N8e$N=hM}$r$*$3$J$$$^$;$s!#$^$?!"$=$N>l9g$K$O(B +@code{riece-after--hook} $B$b8F$S=P$5$l$^$;$s!#(B + +$B%U%C%/$N0z?t$O(B RFC2812 $B$N(B @samp{prefix} $B$H(B @samp{Parameters} $B$KAjEv$9$k(B +2 $B$D$N0z?t$,EO$j$^$9!#(B + @node Index, Function Index, Development, Top @chapter Index @printindex cp