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, 2009
  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 @summarycontents
  61 @contents
  62
  63 @node Top
  64 @top Sieve Support for Emacs
  65
  66 \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
  67 \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
  68 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
  69
  70 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
  71 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
  72 \e$B$J$$$N$G!"\e(BRFC 3028 \e$B$O<j85$KCV$$$F$*$$$F$/$@$5$$!#\e(B
  73
  74 \e$BLuCm\e(B: Sieve == \e$BdA\e(B (\e$B$U$k$$\e(B)
  75
  76 @ifnottex
  77 @insertcopying
  78 @end ifnottex
  79
  80 @menu
  81 * Installation::          \e$B$3$N%Q%C%1!<%8$r;H$&$?$a$N=`Hw\e(B
  82 * Sieve Mode::            Sieve \e$B%9%/%j%W%H$NJT=8\e(B
  83 * Managing Sieve::        \e$B1s3V%5!<%P!<>e$N\e(B Sieve \e$B%9%/%j%W%H$r4IM}$9$k\e(B
  84 * Examples ::             Sieve \e$B%3!<%I$NJRNZ\e(B
  85 * 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
  86 * Standards::             \e$B;H$o$l$F$$$k\e(B RFC \e$B$H:n6HJ8=q$N35N,\e(B
  87 * GNU Free Documentation License:: \e$B$3$NJ8=q$NMxMQ5vBz7@Ls=q\e(B
  88 * Index::                 \e$B4X?t$*$h$SJQ?t$N:w0z\e(B
  89 @end menu
  90
  91 @node Installation
  92 @chapter \e$B%$%s%9%H!<%k\e(B
  93 @cindex Install
  94 @cindex Setup
  95
  96 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
  97 \e$B$J$C$F$$$k$O$:$G$9!#\e(B
  98
  99 \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
 100 \e$B$N%3%^%s%I$r\e(B @code{~/.emacs} \e$B%U%!%$%k$K=q$-9~$s$G$/$@$5$$\e(B:
 101
 102 @lisp
 103 (autoload 'sieve-mode "sieve-mode")
 104 @end lisp
 105 @lisp
 106 (setq auto-mode-alist (cons '("\\.s\\(v\\|iv\\|ieve\\)\\'" . sieve-mode)
 107                             auto-mode-alist))
 108 @end lisp
 109
 110 @node Sieve Mode
 111 @chapter Sieve \e$B%b!<%I\e(B
 112
 113 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
 114 \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
 115 \e$BDs6!$7$^$9!#\e(B
 116
 117 \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
 118 \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
 119
 120 @vindex sieve-mode-map
 121 @vindex sieve-mode-syntax-table
 122 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
 123 \e$B$b;w$F$$$^$9!#%$%s%G%s%H$r%+%9%?%^%$%:$9$kJQ?t$,$"$k$N$HF1MM$K!"%-!<%^%C\e(B
 124 \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
 125 Sieve \e$B%b!<%I$O@lMQ$NN,8lI=\e(B (@code{sieve-mode-abbrev-table}) \e$B$H9=J8%F!<%V\e(B
 126 \e$B%k\e(B (@code{sieve-mode-syntax-table}) \e$B$r;}$C$F$$$^$9!#\e(B
 127
 128 \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
 129 \e$B$k$?$a$N%-!<@_Dj$b$"$j$^$9!#\e(B@xref{Managing Sieve}.
 130
 131 @table @kbd
 132 @item C-c RET
 133 @kindex C-c RET
 134 @findex sieve-manage
 135 @cindex manage remote sieve script
 136 \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
 137 \e$B@\B3$7$^$9!#\e(B
 138
 139 @item C-c C-l
 140 @kindex C-c C-l
 141 @findex sieve-upload
 142 @cindex upload sieve script
 143 \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
 144 @end table
 145
 146 @node Managing Sieve
 147 @chapter Sieve \e$B$N4IM}\e(B
 148
 149 \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
 150 \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
 151 \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
 152 \e$BF~NO$r5a$a$^$9!#\e(B
 153
 154 \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
 155 \e$B$N$,I=<($5$l$^$9\e(B:
 156
 157 @example
 158 Server  : mailserver:2000
 159
 160 2 scripts on server, press RET on a script name edits it, or
 161 press RET on <new script> to create a new script.
 162         <new script>
 163  ACTIVE .sieve
 164         template.siv
 165 @end example
 166
 167 \e$B%9%/%j%W%H$N0l$D$,6/D4I=<($5$l!"I8=`$N%]%$%s%H0\F0%3%^%s%I\e(B (@kbd{<up>},
 168 @kbd{<down>} \e$B$J$I\e(B) \e$B$G%j%9%HFb$r0\F0$9$k$3$H$,$G$-$^$9!#\e(B
 169
 170 \e$B0J2<$N%3%^%s%I$,!V\e(BSieve-\e$B4IM}!W%P%C%U%!!<$GMxMQ2DG=$G$9\e(B:
 171
 172 @table @kbd
 173 @item m
 174 @kindex m
 175 @findex sieve-activate
 176 \e$B8=:_$N6/D4I=<($5$l$?%9%/%j%W%H$r3h@-2=$7$^$9!#\e(B
 177
 178 @item u
 179 @kindex u
 180 @findex sieve-deactivate
 181 \e$B8=:_$N6/D4I=<($5$l$?%9%/%j%W%H$rIT3h@-2=$7$^$9!#\e(B
 182
 183 @item C-M-?
 184 @kindex C-M-?
 185 @findex sieve-deactivate-all
 186 \e$B$9$Y$F$N%9%/%j%W%H$rIT3h@-2=$7$^$9!#\e(B
 187
 188 @item r
 189 @kindex r
 190 @findex sieve-remove
 191 \e$B8=:_$N6/D4I=<($5$l$?%9%/%j%W%H$r<h$j=|$-$^$9!#\e(B
 192
 193 @item RET
 194 @item mouse-2
 195 @item f
 196 @kindex RET
 197 @kindex mouse-2
 198 @kindex f
 199 @findex sieve-edit-script
 200 \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
 201 \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
 202 \e$B$^$9!#\e(B
 203
 204 @item o
 205 @kindex o
 206 @findex sieve-edit-script-other-window
 207 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
 208 \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
 209
 210 @item q
 211 @kindex q
 212 @findex sieve-bury-buffer
 213 \e$B@\B3$r@Z$i$:$K!V\e(BSieve-\e$B4IM}!W%P%C%U%!!<$r1#$7$^$9!#\e(B
 214
 215 @item ?
 216 @item h
 217 @kindex ?
 218 @kindex h
 219 @findex sieve-help
 220 \e$B%_%K%P%C%U%!!<$K%X%k%W$rI=<($7$^$9!#\e(B
 221 @end table
 222
 223 @node Examples
 224 @chapter \e$BNc\e(B
 225
 226 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
 227 \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
 228 \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
 229 \e$B$/$@$5$$!#\e(B
 230
 231 \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
 232 \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
 233 \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
 234 \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
 235
 236 @example
 237 require "fileinto";
 238
 239 if address "sender" "owner-w3-beta@@xemacs.org" @{
 240         fileinto "INBOX.w3-beta";
 241 @}
 242 @end example
 243
 244 \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
 245 \e$B%X%C%@!<$KFHFC$N<1JL;R$,$"$j$^$9!#0J2<$N%9%/%j%W%H$O40A4$G$O$J$/!"$9$G\e(B
 246 \e$B$K\e(B @code{fileinto} \e$B$,FI$_9~$^$l$F$$$k$3$H$r2>Dj$7$F$$$^$9!#\e(B
 247
 248 @example
 249 if header :contains "Delivered-To" "auc-tex@@sunsite.dk" @{
 250         fileinto "INBOX.auc-tex";
 251 @}
 252 @end example
 253
 254 \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
 255 @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
 256 \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
 257 \e$B$^$9!#\e(B
 258
 259 @example
 260 if address ["to", "cc"] "kerberos@@mit.edu" @{
 261         fileinto "INBOX.kerberos";
 262 @}
 263 @end example
 264
 265 @node Manage Sieve API
 266 @chapter \e$B!V\e(BSieve-\e$B4IM}!W$N\e(B API
 267
 268 @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
 269 \e$B%P!<$HOC$9$?$a$N!"Dc3,AX$N4X?t72$,$"$j$^$9!#\e(B
 270
 271 \e$B$$$/$D$+$N!"%f!<%6!<$,8+$k$3$H$,$G$-$kJQ?t$,$"$j!"$=$l$i$9$Y$F\e(B
 272 \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
 273 customize-group RET sieve RET}):
 274
 275 @table @code
 276 @item sieve-manage-default-user
 277 @vindex sieve-manage-default-user
 278 \e$B%G%#%U%)%k%H$N%f!<%6!<L>$r@_Dj$7$^$9!#\e(B
 279
 280 @item sieve-manage-default-port
 281 @vindex sieve-manage-default-port
 282 \e$B;EMM$9$k%G%#%U%)%k%H$N%]!<%H$r@_Dj$7$^$9!#Ds0F$5$l$F$$$k%]!<%HHV9f\e(B
 283 \e$B$O\e(B @code{2000} \e$B$G$9!#\e(B
 284
 285 @item sieve-manage-log
 286 @vindex sieve-manage-log
 287 \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
 288 \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
 289 @end table
 290
 291 API \e$B$N4X?t$K$O0J2<$N$b$N$,$"$j$^$9\e(B:
 292
 293 @table @code
 294 @item sieve-manage-open
 295 @findex sieve-manage-open
 296 \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
 297 \e$B$^$9!#\e(B
 298
 299 @item sieve-manage-opened
 300 @findex sieve-manage-opened
 301 \e$B%5!<%P!<$H@\B3$7$F$$$k$+H]$+$r8!::$7$^$9!#\e(B
 302
 303 @item sieve-manage-close
 304 @findex sieve-manage-close
 305 \e$B%5!<%P!<$H$N@\B3$rJD$8$^$9!#\e(B
 306
 307 @item sieve-manage-authenticate
 308 @findex sieve-manage-authenticate
 309 \e$B%5!<%P!<$rG'>Z$7$^$9!#\e(B
 310
 311 @item sieve-manage-capability
 312 @findex sieve-manage-capability
 313 \e$B%5!<%P!<$,%5%]!<%H$7$F$$$k5!G=$N%j%9%H$rJV$7$^$9!#\e(B
 314
 315 @item sieve-manage-listscripts
 316 @findex sieve-manage-listscripts
 317 \e$B%5!<%P!<$K$"$k%9%/%j%W%H$rNs5s$7$^$9!#\e(B
 318
 319 @item sieve-manage-havespace
 320 @findex sieve-manage-havespace
 321 \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
 322 \e$B$9!#\e(B
 323
 324 @item sieve-manage-getscript
 325 @findex sieve-manage-getscript
 326 \e$B%5!<%P!<$+$i%9%/%j%W%H$r%@%&%s%m!<%I$7$^$9!#\e(B
 327
 328 @item sieve-manage-putscript
 329 @findex sieve-manage-putscript
 330 \e$B%5!<%P!<$K%9%/%j%W%H$r%"%C%W%m!<%I$7$^$9!#\e(B
 331
 332 @item sieve-manage-setactive
 333 @findex sieve-manage-setactive
 334 \e$B%5!<%P!<$K$"$k$I$N%9%/%j%W%H$,3h$-$F$$$k$O$:$G$"$k$+$r<($7$^$9!#\e(B
 335 @end table
 336
 337 @node Standards
 338 @chapter \e$BI8=`\e(B
 339
 340 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
 341 \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
 342 \e$BNs5s$7$^$9!#$=$l$i$O$9$Y$F\e(B @uref{http://quimby.gnus.org/notes/} \e$B$+$iF~<j\e(B
 343 \e$B$9$k$3$H$,$G$-$^$9!#\e(B
 344
 345 @table @dfn
 346 @item RFC3028
 347 Sieve: \e$B%a!<%k_I2a8@8l\e(B
 348
 349 @item draft-martin-managesieve-03
 350 Sieve \e$B%9%/%j%W%H$r1s3V4IM}$9$k$?$a$N%W%m%H%3%k\e(B
 351 @end table
 352
 353 @node GNU Free Documentation License
 354 @chapter GNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q\e(B
 355
 356 \e$BLuCm\e(B: @uref{http://www.opensource.jp/fdl/fdl.ja.html.euc-jp,
 357 \e$BHs8x<0$JF|K\8lLu\e(B} \e$B$,$"$j$^$9!#\e(B
 358
 359 @include doclicense.texi
 360
 361 @node Index
 362 @unnumbered Index
 363 @printindex cp
 364
 365 @bye
 366
 367 @c Local Variables:
 368 @c coding: iso-2022-7bit
 369 @c fill-column: 72
 370 @c mode: texinfo
 371 @c use-kuten-for-period: t
 372 @c use-touten-for-comma: t
 373 @c End: