sieve-ja.texi

   1 \input texinfo                  @c -*-texinfo-*-
   2
   3 @setfilename sieve-ja
   4 @settitle Emacs Sieve Manual
   5 @synindex fn cp
   6 @synindex vr cp
   7 @synindex pg cp
   8 @iftex
   9 @firstparagraphindent insert
  10 @end iftex
  11
  12 @copying
  13 This file documents the Emacs Sieve package.
  14
  15 Copyright @copyright{} 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
  16 Free Software Foundation, Inc.
  17
  18 @quotation
  19 Permission is granted to copy, distribute and/or modify this document
  20 under the terms of the GNU Free Documentation License, Version 1.3 or
  21 any later version published by the Free Software Foundation; with no
  22 Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
  23 and with the Back-Cover Texts as in (a) below.  A copy of the license
  24 is included in the section entitled ``GNU Free Documentation License''.
  25
  26 \e$B$3$NJ8=q$r!"%U%j!<%=%U%H%&%'%":bCDH/9T$N\e(B GNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q\e(B
  27 \e$BBh\e(B 1.3 \e$BHG$^$?$O$=$l0J9_$NHG$,Dj$a$k>r7o$N2<$GJ#@=!"G[I[!"$"$k$$$OJQ99$9\e(B
  28 \e$B$k$3$H$r5v2D$7$^$9!#JQ99IT2DItJ,$O;XDj$7$^$;$s!#!H\e(BA GNU Manual\e$B!I$OI=I=;f\e(B
  29 \e$B%F%-%9%H!"0J2<$N\e(B (a) \e$B$ON"I=;f%F%-%9%H$G$9!#$3$NMxMQ5vBz7@Ls=q$NJ#<L$O\e(B
  30 \e$B!V\e(BGNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q!W$H$$$&>O$K4^$^$l$F$$$^$9!#\e(B
  31
  32 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
  33 modify this GNU manual.  Buying copies from the FSF supports it in
  34 developing GNU and promoting software freedom.''
  35
  36 (a) FSF \e$B$NN"I=;f%F%-%9%H\e(B:\e$B!V$"$J$?$K$O$3$N\e(B GNU Manual \e$B$rJ#@=$7$?$jJQ99$9\e(B
  37 \e$B$k<+M3$,$"$j$^$9!#\e(BFSF \e$B$+$i$NJ#<L$N9XF~$O\e(B GNU \e$B$N3+H/$H%=%U%H%&%'%"$N<+M3\e(B
  38 \e$B$NB%?J$r;Y1g$7$^$9!#!W\e(B
  39 @end quotation
  40 @end copying
  41
  42 @dircategory Emacs
  43 @direntry
  44 * Sieve-ja: (sieve-ja).         Managing Sieve scripts in Emacs (Japanese).
  45 @end direntry
  46 @iftex
  47 @finalout
  48 @end iftex
  49 @setchapternewpage odd
  50
  51 @titlepage
  52 @title Emacs Sieve Manual
  53
  54 @author by Simon Josefsson
  55 @page
  56 @vskip 0pt plus 1filll
  57 @insertcopying
  58 @end titlepage
  59
  60 @node Top
  61 @top Sieve Support for Emacs
  62
  63 \e$B$3$N%^%K%e%"%k$O\e(B Emacs Sieve \e$B%Q%C%1!<%8$N@bL@=q$G$9!#\e(B
  64
  65 \e$B$3$l$O\e(B Sieve \e$B%b!<%I$H!V\e(BSieve-\e$B4IM}!W\e(B(Manage Sieve) \e$B$N$?$a$N%f!<%6!<%:%^%K%e\e(B
  66 \e$B%"%k$H$7$F!"$*$h$S\e(B @samp{sieve-manage} \e$B%W%m%H%3%k$r07$&\e(B Emacs Lisp
  67 API \e$B$N$?$a$N%j%U%!%l%s%9%^%K%e%"%k$H$7$F3hMQ$5$l$k$3$H$r0U?^$7$F$$$^$9!#\e(B
  68
  69 Sieve \e$B$O%5!<%P!<B&$G%a!<%k$r_I2a$9$k$?$a$N8@8l$G$9!#$=$N8@8l$O\e(B RFC
  70 3028 \e$B$KJ8=q2=$5$l$F$$$^$9!#$3$N%^%K%e%"%k$NL\E*$O8@8l$r@bL@$9$k$3$H$G$O\e(B
  71 \e$B$J$$$N$G!"\e(BRFC 3028 \e$B$O<j85$KCV$$$F$*$$$F$/$@$5$$!#\e(B
  72
  73 \e$B$^$H$b$J\e(B Sieve \e$B$N;qNA$O\e(B @uref{http://www.cyrusoft.com/sieve/} \e$B$K$"$j$^$9!#\e(B
  74
  75 \e$BLuCm\e(B: Sieve == \e$BdA\e(B (\e$B$U$k$$\e(B)
  76
  77 @menu
  78 * Installation::          \e$B$3$N%Q%C%1!<%8$r;H$&$?$a$N=`Hw\e(B
  79 * Sieve Mode::            Sieve \e$B%9%/%j%W%H$NJT=8\e(B
  80 * Managing Sieve::        \e$B1s3V%5!<%P!<>e$N\e(B Sieve \e$B%9%/%j%W%H$r4IM}$9$k\e(B
  81 * Examples ::             Sieve \e$B%3!<%I$NJRNZ\e(B
  82 * Manage Sieve API ::     \e$B!V\e(BSieve-\e$B4IM}!W%W%m%H%3%k\e(B API \e$B$N%$%s%?!<%U%'!<%9\e(B
  83 * Standards::             \e$B;H$o$l$F$$$k\e(B RFC \e$B$H:n6HJ8=q$N35N,\e(B
  84 * GNU Free Documentation License:: \e$B$3$NJ8=q$NMxMQ5vBz7@Ls=q\e(B
  85 * Index::                 \e$B4X?t$*$h$SJQ?t$N:w0z\e(B
  86 @end menu
  87
  88 @node Installation
  89 @chapter \e$B%$%s%9%H!<%k\e(B
  90 @cindex Install
  91 @cindex Setup
  92
  93 Sieve \e$B%Q%C%1!<%8$O$"$J$?$N\e(B Emacs \e$B$NHG$KIUB0$7$F$$$F!"$9$0$K;H$($k$h$&$K\e(B
  94 \e$B$J$C$F$$$k$O$:$G$9!#\e(B
  95
  96 \e$B$=$&$J$C$F$$$J$$$N$G$"$l$P!"$3$N%Q%C%1!<%8$r<j:n6H$G@_Dj$9$k$?$a$K!"0J2<\e(B
  97 \e$B$N%3%^%s%I$r\e(B @code{~/.emacs} \e$B%U%!%$%k$K=q$-9~$s$G$/$@$5$$\e(B:
  98
  99 @lisp
 100 (autoload 'sieve-mode "sieve-mode")
 101 @end lisp
 102 @lisp
 103 (setq auto-mode-alist (cons '("\\.s\\(v\\|iv\\|ieve\\)\\'" . sieve-mode)
 104                             auto-mode-alist))
 105 @end lisp
 106
 107 @node Sieve Mode
 108 @chapter Sieve \e$B%b!<%I\e(B
 109
 110 Sieve \e$B%b!<%I$O!"9=J8$K4p$E$$$?%$%s%G%s%H!"\e(Bfont-lock \e$B$N%5%]!<%H!"$*$h\e(B
 111 \e$B$S\e(B Sieve \e$B%9%/%j%W%H$r3Z$KJT=8$G$-$k$h$&$K$9$k$?$a$N$=$NB>$NJXMx$J5!G=$r\e(B
 112 \e$BDs6!$7$^$9!#\e(B
 113
 114 \e$B$3$N%a%8%c!<%b!<%I$K@Z$jBX$($k$K$O\e(B @samp{M-x sieve-mode} \e$B$r;H$C$F$/$@$5\e(B
 115 \e$B$$!#$3$N%3%^%s%I$O\e(B @code{sieve-mode-hook} \e$B$GM?$($i$l$?%U%C%/$r<B9T$7$^$9!#\e(B
 116
 117 @vindex sieve-mode-map
 118 @vindex sieve-mode-syntax-table
 119 Sieve \e$B%b!<%I$O\e(B @code{c-mode} \e$B$+$iGI@8$7$F$$$F!"%3%a%s%H$N9=J80J30$O$H$F\e(B
 120 \e$B$b;w$F$$$^$9!#%$%s%G%s%H$r%+%9%?%^%$%:$9$kJQ?t$,$"$k$N$HF1MM$K!"%-!<%^%C\e(B
 121 \e$B%W\e(B (@code{sieve-mode-map}) \e$B$O\e(B @code{c-mode} \e$B$N$b$N$r<u$17Q$.$^$9!#\e(B
 122 Sieve \e$B%b!<%I$O@lMQ$NN,8lI=\e(B (@code{sieve-mode-abbrev-table}) \e$B$H9=J8%F!<%V\e(B
 123 \e$B%k\e(B (@code{sieve-mode-syntax-table}) \e$B$r;}$C$F$$$^$9!#\e(B
 124
 125 \e$BJT=8$KLrN)$D4X?t$K2C$($F!"\e(BSieve \e$B%b!<%I$K$O\e(B Sieve \e$B%9%/%j%W%H$r1s3V4IM}$9\e(B
 126 \e$B$k$?$a$N%-!<@_Dj$b$"$j$^$9!#\e(B@xref{Managing Sieve}.
 127
 128 @table @kbd
 129 @item C-c RET
 130 @kindex C-c RET
 131 @findex sieve-manage
 132 @cindex manage remote sieve script
 133 \e$B!V\e(BSieve-\e$B4IM}!W%W%m%H%3%k\e(B (Managesieve protocol) \e$B$r;H$C$F!"1s3V%5!<%P!<$K\e(B
 134 \e$B@\B3$7$^$9!#\e(B
 135
 136 @item C-c C-l
 137 @kindex C-c C-l
 138 @findex sieve-upload
 139 @cindex upload sieve script
 140 \e$B8=:_@\B3$7$F$$$k%5!<%P!<$K\e(B Sieve \e$B%9%/%j%W%H$r%"%C%W%m!<%I$7$^$9!#\e(B
 141 @end table
 142
 143 @node Managing Sieve
 144 @chapter Sieve \e$B$N4IM}\e(B
 145
 146 \e$B!V\e(BSieve-\e$B4IM}!W$O!"1s3V%5!<%P!<$K$"$k\e(B Sieve \e$B%9%/%j%W%H$rI=<($9$k$?$a$K;H\e(B
 147 \e$B$o$l$kFCJL$J%b!<%I$G$9!#$=$l$O\e(B @kbd{M-x sieve-manage RET} \e$B$G5/F0$7!"$=$N\e(B
 148 \e$B%5!<%P!<$K$*$1$k%f!<%6!<L>$H!"I,MW$J>l9g$K$O;q3J>ZL@=q\e(B (credentials) \e$B$N\e(B
 149 \e$BF~NO$r5a$a$^$9!#\e(B
 150
 151 \e$B%5!<%P!<$H$N@\B3$K@.8y$9$k$H!"!V\e(BSieve-\e$B4IM}!W%P%C%U%!!<$K$O0J2<$N$h$&$J$b\e(B
 152 \e$B$N$,I=<($5$l$^$9\e(B:
 153
 154 @example
 155 Server  : mailserver:2000
 156
 157 2 scripts on server, press RET on a script name edits it, or
 158 press RET on <new script> to create a new script.
 159         <new script>
 160  ACTIVE .sieve
 161         template.siv
 162 @end example
 163
 164 \e$B%9%/%j%W%H$N0l$D$,6/D4I=<($5$l!"I8=`$N%]%$%s%H0\F0%3%^%s%I\e(B (@kbd{<up>},
 165 @kbd{<down>} \e$B$J$I\e(B) \e$B$G%j%9%HFb$r0\F0$9$k$3$H$,$G$-$^$9!#\e(B
 166
 167 \e$B0J2<$N%3%^%s%I$,!V\e(BSieve-\e$B4IM}!W%P%C%U%!!<$GMxMQ2DG=$G$9\e(B:
 168
 169 @table @kbd
 170 @item m
 171 @kindex m
 172 @findex sieve-activate
 173 \e$B8=:_$N6/D4I=<($5$l$?%9%/%j%W%H$r3h@-2=$7$^$9!#\e(B
 174
 175 @item u
 176 @kindex u
 177 @findex sieve-deactivate
 178 \e$B8=:_$N6/D4I=<($5$l$?%9%/%j%W%H$rIT3h@-2=$7$^$9!#\e(B
 179
 180 @item C-M-?
 181 @kindex C-M-?
 182 @findex sieve-deactivate-all
 183 \e$B$9$Y$F$N%9%/%j%W%H$rIT3h@-2=$7$^$9!#\e(B
 184
 185 @item r
 186 @kindex r
 187 @findex sieve-remove
 188 \e$B8=:_$N6/D4I=<($5$l$?%9%/%j%W%H$r<h$j=|$-$^$9!#\e(B
 189
 190 @item RET
 191 @item mouse-2
 192 @item f
 193 @kindex RET
 194 @kindex mouse-2
 195 @kindex f
 196 @findex sieve-edit-script
 197 \e$B%5!<%P!<%P%C%U%!!<$r1#$7$F!"8=:_$N6/D4I=<($5$l$?%9%/%j%W%H$r\e(B Sieve \e$B%b!<\e(B
 198 \e$B%I\e(B (@pxref{Sieve Mode}) \e$B$GJT=8$9$k$?$a$N?7$7$$%P%C%U%!!<$K%@%&%s%m!<%I$7\e(B
 199 \e$B$^$9!#\e(B
 200
 201 @item o
 202 @kindex o
 203 @findex sieve-edit-script-other-window
 204 Sieve \e$B%b!<%I\e(B (@pxref{Sieve Mode}) \e$B$GJT=8$9$k$?$a$K!"8=:_$N6/D4I=<($5$l$?\e(B
 205 \e$B%9%/%j%W%H$r4^$s$G$$$k?7$7$$%P%C%U%!!<$r!"JL%&%#%s%I%&$G:n@.$7$^$9!#\e(B
 206
 207 @item q
 208 @kindex q
 209 @findex sieve-bury-buffer
 210 \e$B@\B3$r@Z$i$:$K!V\e(BSieve-\e$B4IM}!W%P%C%U%!!<$r1#$7$^$9!#\e(B
 211
 212 @item ?
 213 @item h
 214 @kindex ?
 215 @kindex h
 216 @findex sieve-help
 217 \e$B%_%K%P%C%U%!!<$K%X%k%W$rI=<($7$^$9!#\e(B
 218 @end table
 219
 220 @node Examples
 221 @chapter \e$BNc\e(B
 222
 223 Sieve \e$B$r=OCN$7$F$$$J$$$J$i!"$3$N>O$K$[$s$N>/$7$@$1$"$k%3!<%I$NCGJR$rMxMQ\e(B
 224 \e$B$9$l$PNI$$$G$7$g$&!#\e(BSieve \e$B8@8l$G%<%m$+$i5,B'$r=q$/$3$H$,$b$C$H2wE,$K46$8\e(B
 225 \e$B$i$l$k$h$&$K$J$k$^$G$O!"$=$l$i$r%+%C%H!u%Z!<%9%H$7$F9%$-$J$h$&$KJQ99$7$F\e(B
 226 \e$B$/$@$5$$!#\e(B
 227
 228 \e$B0J2<$N40A4$J\e(B Sieve \e$B%9%/%j%W%H$O!"9gCW$9$k\e(B @samp{Sender:} \e$B%X%C%@!<$r;}$D\e(B
 229 \e$B$9$Y$F$N%a%C%;!<%8$r!";XDj$5$l$?%a!<%k%\%C%/%9$K3JG<$7$^$9!#B?$/$N%a!<%j\e(B
 230 \e$B%s%0%j%9%H$,$3$N7A<0$r;H$C$F$$$^$9!#:G=i$N9T$O\e(B Sieve \e$B%5!<%P!<$,3N<B\e(B
 231 \e$B$K\e(B @code{fileinto} \e$B%3%^%s%I$rM}2r$G$-$k$h$&$K$9$k$?$a$N$b$N$G$9!#\e(B
 232
 233 @example
 234 require "fileinto";
 235
 236 if address "sender" "owner-w3-beta@@xemacs.org" @{
 237         fileinto "INBOX.w3-beta";
 238 @}
 239 @end example
 240
 241 \e$B>/?t$N%a!<%j%s%0%j%9%H$O\e(B @samp{Sender:} \e$B%X%C%@!<$r;H$$$^$;$s$,!"$"$kJL$N\e(B
 242 \e$B%X%C%@!<$KFHFC$N<1JL;R$,$"$j$^$9!#0J2<$N%9%/%j%W%H$O40A4$G$O$J$/!"$9$G\e(B
 243 \e$B$K\e(B @code{fileinto} \e$B$,FI$_9~$^$l$F$$$k$3$H$r2>Dj$7$F$$$^$9!#\e(B
 244
 245 @example
 246 if header :contains "Delivered-To" "auc-tex@@sunsite.dk" @{
 247         fileinto "INBOX.auc-tex";
 248 @}
 249 @end example
 250
 251 \e$B:G8e$O!"$I$s$JFHFC$N<1JL;R$b;}$C$F$$$J$$@dK>E*$J%a!<%j%s%0%j%9%H$N$?$a$K!"\e(B
 252 @samp{To:} \e$B$H\e(B @samp{Cc} \e$B%X%C%@!<$K$*$1$k9gCW$r6/$$$i$l$kNc$G$9!#A0$N$b$N\e(B
 253 \e$B$HF1MM$K!"$3$NCGJR$O\e(B @code{fileinto} \e$B$,FI$_9~$^$l$F$$$k$3$H$r2>Dj$7$F$$\e(B
 254 \e$B$^$9!#\e(B
 255
 256 @example
 257 if address ["to", "cc"] "kerberos@@mit.edu" @{
 258         fileinto "INBOX.kerberos";
 259 @}
 260 @end example
 261
 262 @node Manage Sieve API
 263 @chapter \e$B!V\e(BSieve-\e$B4IM}!W$N\e(B API
 264
 265 @file{sieve-manage.el} \e$B%i%$%V%i%j!<$K$O\e(B @sc{managesieve} \e$B%W%m%H%3%k$G%5!<\e(B
 266 \e$B%P!<$HOC$9$?$a$N!"Dc3,AX$N4X?t72$,$"$j$^$9!#\e(B
 267
 268 \e$B$$$/$D$+$N!"%f!<%6!<$,8+$k$3$H$,$G$-$kJQ?t$,$"$j!"$=$l$i$9$Y$F\e(B
 269 \e$B$O\e(B @code{sieve} \e$B%0%k!<%W$G%+%9%?%^%$%:$9$k$3$H$,$G$-$^$9\e(B (@kbd{M-x
 270 customize-group RET sieve RET}):
 271
 272 @table @code
 273 @item sieve-manage-default-user
 274 @vindex sieve-manage-default-user
 275 \e$B%G%#%U%)%k%H$N%f!<%6!<L>$r@_Dj$7$^$9!#\e(B
 276
 277 @item sieve-manage-default-port
 278 @vindex sieve-manage-default-port
 279 \e$B;EMM$9$k%G%#%U%)%k%H$N%]!<%H$r@_Dj$7$^$9!#Ds0F$5$l$F$$$k%]!<%HHV9f\e(B
 280 \e$B$O\e(B @code{2000} \e$B$G$9!#\e(B
 281
 282 @item sieve-manage-log
 283 @vindex sieve-manage-log
 284 \e$BHs\e(B-@code{nil} \e$B$@$C$?$i!"$d$j<h$j$7$?%W%m%H%3%k$N7k2L$,5-O?$5$l$k%P%C%U%!!<\e(B
 285 \e$BL>$NJ8;zNs$G$J$1$l$P$J$j$^$;$s\e(B (\e$B%G%P%C%0$9$k$H$-$K;H$$$^$9\e(B)\e$B!#\e(B
 286 @end table
 287
 288 API \e$B$N4X?t$K$O0J2<$N$b$N$,$"$j$^$9\e(B:
 289
 290 @table @code
 291 @item sieve-manage-open
 292 @findex sieve-manage-open
 293 \e$B!V\e(BSieve-\e$B4IM}!W%5!<%P!<$K@\B3$7!"B>$N$9$Y$F$N\e(B API \e$B$G;H$&%P%C%U%!!<$rJV$7\e(B
 294 \e$B$^$9!#\e(B
 295
 296 @item sieve-manage-opened
 297 @findex sieve-manage-opened
 298 \e$B%5!<%P!<$H@\B3$7$F$$$k$+H]$+$r8!::$7$^$9!#\e(B
 299
 300 @item sieve-manage-close
 301 @findex sieve-manage-close
 302 \e$B%5!<%P!<$H$N@\B3$rJD$8$^$9!#\e(B
 303
 304 @item sieve-manage-authenticate
 305 @findex sieve-manage-authenticate
 306 \e$B%5!<%P!<$rG'>Z$7$^$9!#\e(B
 307
 308 @item sieve-manage-capability
 309 @findex sieve-manage-capability
 310 \e$B%5!<%P!<$,%5%]!<%H$7$F$$$k5!G=$N%j%9%H$rJV$7$^$9!#\e(B
 311
 312 @item sieve-manage-listscripts
 313 @findex sieve-manage-listscripts
 314 \e$B%5!<%P!<$K$"$k%9%/%j%W%H$rNs5s$7$^$9!#\e(B
 315
 316 @item sieve-manage-havespace
 317 @findex sieve-manage-havespace
 318 \e$BM?$($i$l$?%5%$%:$N%9%/%j%W%H$N$?$a$N6u$-$,$"$l$P!"Hs\e(B-@code{nil} \e$B$rJV$7$^\e(B
 319 \e$B$9!#\e(B
 320
 321 @item sieve-manage-getscript
 322 @findex sieve-manage-getscript
 323 \e$B%5!<%P!<$+$i%9%/%j%W%H$r%@%&%s%m!<%I$7$^$9!#\e(B
 324
 325 @item sieve-manage-putscript
 326 @findex sieve-manage-putscript
 327 \e$B%5!<%P!<$K%9%/%j%W%H$r%"%C%W%m!<%I$7$^$9!#\e(B
 328
 329 @item sieve-manage-setactive
 330 @findex sieve-manage-setactive
 331 \e$B%5!<%P!<$K$"$k$I$N%9%/%j%W%H$,3h$-$F$$$k$O$:$G$"$k$+$r<($7$^$9!#\e(B
 332 @end table
 333
 334 @node Standards
 335 @chapter \e$BI8=`\e(B
 336
 337 Emacs Sieve \e$B%Q%C%1!<%8$O!">/$J$$$1$l$I$bA}Bg$9$k$3$H$,K>$^$l$k\e(B RFC \e$B72$*\e(B
 338 \e$B$h$SAp9FJ8=q$N!"$9$Y$F$^$?$O0lItJ,$r<BAu$7$^$9!#$3$N>O$G$O4XO"$9$k$b$N$r\e(B
 339 \e$BNs5s$7$^$9!#$=$l$i$O$9$Y$F\e(B @uref{http://quimby.gnus.org/notes/} \e$B$+$iF~<j\e(B
 340 \e$B$9$k$3$H$,$G$-$^$9!#\e(B
 341
 342 @table @dfn
 343 @item RFC3028
 344 Sieve: \e$B%a!<%k_I2a8@8l\e(B
 345
 346 @item draft-martin-managesieve-03
 347 Sieve \e$B%9%/%j%W%H$r1s3V4IM}$9$k$?$a$N%W%m%H%3%k\e(B
 348 @end table
 349
 350 @node GNU Free Documentation License
 351 @chapter GNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q\e(B
 352
 353 \e$BLuCm\e(B: @uref{http://www.opensource.jp/fdl/fdl.ja.html.euc-jp,
 354 \e$BHs8x<0$JF|K\8lLu\e(B} \e$B$,$"$j$^$9!#\e(B
 355
 356 @include doclicense.texi
 357
 358 @node Index
 359 @unnumbered Index
 360 @printindex cp
 361
 362 @summarycontents
 363 @contents
 364 @bye
 365
 366 @c Local Variables:
 367 @c coding: iso-2022-7bit
 368 @c fill-column: 72
 369 @c mode: texinfo
 370 @c use-kuten-for-period: t
 371 @c use-touten-for-comma: t
 372 @c End: