\e$B$kI,MW$O$"$j$^$;$s!#4{DjCM$O\e(B @code{nil} \e$B$G$9!#\e(B
@end table
-@c TRANSLATEME!
@node Maildir
@subsubsection Maildir
@cindex nnmaildir
@cindex maildir
-@code{nnmaildir} stores mail in the maildir format, with each maildir
-corresponding to a group in Gnus. This format is documented here:
-@uref{http://cr.yp.to/proto/maildir.html} and here:
-@uref{http://www.qmail.org/man/man5/maildir.html}. nnmaildir also
-stores extra information in the @file{.nnmaildir/} directory within a
-maildir.
-
-Maildir format was designed to allow concurrent deliveries and
-reading, without needing locks. With other backends, you would have
-your mail delivered to a spool of some kind, and then you would
-configure Gnus to split mail from that spool into your groups. You
-can still do that with nnmaildir, but the more common configuration is
-to have your mail delivered directly to the maildirs that appear as
-group in Gnus.
-
-nnmaildir is designed to be perfectly reliable: @kbd{C-g} will never
-corrupt its data in memory, and @code{SIGKILL} will never corrupt its
-data in the filesystem.
+@code{nnmaildir} \e$B$O\e(B Gnus \e$B$N%0%k!<%W$KBP1~$7$?3F!9\e(B
+\e$B$N\e(B maildir \e$B$K\e(B maildir \e$B%U%)!<%^%C%H$G%a!<%k$r3JG<$7$^$9!#$3$N%U%)!<%^%C\e(B
+\e$B%H$O\e(B @uref{http://cr.yp.to/proto/maildir.html} \e$B$*$h\e(B
+\e$B$S\e(B @uref{http://www.qmail.org/man/man5/maildir.html} \e$B$GJ8=q2=$5$l$F$$$^\e(B
+\e$B$9!#$^$?\e(B nnmaildir \e$B$O\e(B maildir \e$B$NCf$N\e(B @file{.nnmaildir/} \e$B%G%#%l%/%H%j$KFC\e(B
+\e$BJL$J>pJs$r3JG<$7$^$9!#\e(B
+
+Maildir \e$B%U%)!<%^%C%H$O%m%C%/$rI,MW$H$7$J$$F1;~G[Aw$H9VFI$r2DG=$K$9$k$?$a\e(B
+\e$B$K@_7W$5$l$^$7$?!#B>$N%P%C%/%(%s%I$G$O!"%a!<%k$r2?$i$+$N%9%W!<%k$KEO$7$F\e(B
+\e$B$=$N%9%W!<%k$+$i%0%k!<%W$KJ,3d$9$k$?$a$K\e(B Gnus \e$B$r@_Dj$7$J$1$l$P$J$i$J$$$G\e(B
+\e$B$7$g$&!#$=$l$O:#$^$GDL$j\e(B nnmaildir \e$B$G9T$J$&$3$H$,$G$-$^$9$,!"$b$C$H0lHL\e(B
+\e$BE*$J@_Dj$O\e(B Gnus \e$B$N%0%k!<%W$H$7$F8=$o$l$k\e(B maildir \e$B$K%a!<%k$rD>@\G[Aw$9$k\e(B
+\e$B$3$H$G$9!#\e(B
+
+nnmaildir \e$B$O40A4$K?.Mj$G$-$k$3$H$rL\;X$7$F$$$^$9\e(B: @kbd{C-g} \e$B$O%a%b%j!<Cf\e(B
+\e$B$N%G!<%?$r2u$7$^$;$s$7!"\e(B@code{SIGKILL} \e$B$,%U%!%$%k$NCf$N%G!<%?$r2u$9$3$H\e(B
+\e$B$O$"$j$^$;$s!#\e(B
-nnmaildir stores article marks and NOV data in each maildir. So you
-can copy a whole maildir from one Gnus setup to another, and you will
-keep your marks.
+nnmaildir \e$B$O5-;v$N0u$H\e(B NOV \e$B%G!<%?$r$=$l$>$l$N\e(B maildir \e$B$K3JG<$7$^$9!#$=$l\e(B
+\e$B$K$h$C$F!"$"$k\e(B Gnus \e$B$N4D6-$+$iJL$N>l=j$K\e(B maildir \e$BA4BN$r%3%T!<$9$k$3$H$,\e(B
+\e$B$G$-!"0u$OJ]B8$5$l$^$9!#\e(B
-Virtual server settings:
+\e$B2>A[%5!<%P!<$N@_Dj\e(B:
@table @code
@item directory
-For each of your nnmaildir servers (it's very unlikely that you'd need
-more than one), you need to create a directory and populate it with
-symlinks to maildirs (and nothing else; do not choose a directory
-already used for other purposes). You could also put maildirs
-themselves (instead of symlinks to them) directly in the server
-directory, but that would break @code{nnmaildir-request-delete-group},
-so you wouldn't be able to delete those groups from within Gnus. (You
-could still delete them from your shell with @code{rm -r foo}.) Each
-maildir will be represented in Gnus as a newsgroup on that server; the
-filename of the symlink will be the name of the group. Any filenames
-in the directory starting with `.' are ignored. The directory is
-scanned when you first start Gnus, and each time you type @kbd{g} in
-the group buffer; if any maildirs have been removed or added,
-nnmaildir notices at these times.
-
-The value of the @code{directory} parameter should be a Lisp form
-which is processed by @code{eval} and @code{expand-file-name} to get
-the path of the directory for this server. The form is @code{eval}ed
-only when the server is opened; the resulting string is used until the
-server is closed. (If you don't know about forms and @code{eval},
-don't worry - a simple string will work.) This parameter is not
-optional; you must specify it. I don't recommend using @file{~/Mail}
-or a subdirectory of it; several other parts of Gnus use that
-directory by default for various things, and may get confused if
-nnmaildir uses it too. @file{~/.nnmaildir} is a typical value.
+\e$B$=$l$>$l$N\e(B nnmaildir \e$B%5!<%P!<\e(B (\e$B0l$D$r1[$($k%5!<%P!<$,I,MW$@$H$O$H$F$b;W\e(B
+\e$B$($^$;$s$,\e(B) \e$B$KBP$7$F!"%G%#%l%/%H%j$r:n$C$F\e(B maildir \e$B$X$N%7%s%\%j%C%/%j%s\e(B
+\e$B%/$rD%$kI,MW$,$"$j$^$9\e(B (\e$BB>$NL\E*$N$?$a$K$9$G$K;H$o$l$F$$$k%G%#%l%/%H%j$r\e(B
+\e$BA*$s$G$O$$$1$^$;$s\e(B)\e$B!#%5!<%P!<$N%G%#%l%/%H%j$KD>@\\e(B (\e$B%7%s%\%j%C%/%j%s%/$N\e(B
+\e$BBe$o$j$K\e(B) nnmaildir \e$B$rCV$/$3$H$b$G$-$k$N$G$9$,!"$=$l\e(B
+\e$B$O\e(B @code{nnmaildir-request-delete-group} \e$B$rGKC>$5$;!"\e(BGnus \e$B$G$=$l$i$N%0%k!<\e(B
+\e$B%W$r>C$9$3$H$,$G$-$J$/$J$C$F$7$^$$$^$9\e(B (\e$B$=$l$i$r\e(B shell \e$B$+$i\e(B @code{rm -r
+foo} \e$B$G>C$9$3$H$O$G$-$^$9\e(B)\e$B!#$=$l$>$l$N\e(B maildir \e$B$O!"$=$N%5!<%P!<$N%K%e!<\e(B
+\e$B%9%0%k!<%W$H$7$F\e(B Gnus \e$B$K8=$l!"%7%s%\%j%C%/%j%s%/$N%U%!%$%kL>$,$=$N%0%k!<\e(B
+\e$B%W$NL>A0$K$J$j$^$9!#%G%#%l%/%H%j$K$"$k\e(B `.' \e$B$G;O$^$k$I$s$J%U%!%$%kL>$bL5\e(B
+\e$B;k$5$l$^$9!#%G%#%l%/%H%j$O:G=i$K\e(B Gnus \e$B$r5/F0$7$?$H$-$H%0%k!<%W%P%C%U%!\e(B
+\e$B$G\e(B @kbd{g} \e$B$r%?%$%W$7$?$H$-$O$$$D$G$bAv::$5$l!"$I$l$+$N\e(B maildir \e$B$,:o=|$^\e(B
+\e$B$?$ODI2C$5$l$?$H$-$KDLCN$7$^$9!#\e(B
+
+@code{directory} \e$B%Q%i%a!<%?$NCM$O\e(B Lisp \e$B<0$G$J$1$l$P$J$j$^$;$s!#\e(B
+@code{eval} \e$B$G=hM}$5$l$?8e$G!"\e(B@code{expand-file-name} \e$B$K$h$C$F$3$N%5!<%P!<\e(B
+\e$B$N$?$a$N%G%#%l%/%H%j$N%Q%9$r3MF@$7$^$9!#$=$N7k2LF@$i$l$?J8;zNs$,!"%5!<%P!<\e(B
+\e$B$,JD$8$i$l$k$^$G;H$o$l$^$9\e(B (\e$B$b$7!"<0$d\e(B @code{eval} \e$B$rCN$i$J$/$G$b?4G[$4\e(B
+\e$BL5MQ\e(B; \e$BC1$J$kJ8;zNs$GF0:n$7$^$9\e(B)\e$B!#$3$N%Q%i%a!<%?$OG$0U$G$O$J$/!"@_Dj$7$J\e(B
+\e$B$1$l$P$J$j$^$;$s!#\e(B@file{~/Mail} \e$B$d%5%V%G%#%l%/%H%j$r;H$&$3$H$O?d>)$G$-$^\e(B
+\e$B$;$s!#$$$/$D$+$N\e(B Gnus \e$B$NB>$NItJ,$,$=$l$r%G%#%U%)%k%H$G$$$m$s$J$b$N$K;H$&\e(B
+\e$B$N$G!"\e(Bnnmaildir \e$B$G$b$=$l$r;H$&$H:.Mp$9$k$+$b$7$l$^$;$s!#\e(B
+@file{~/.nnmaildir} \e$B$,0lHLE*$JCM$G$9!#\e(B
@item create-directory
-This should be a Lisp form which is processed by @code{eval} and
-@code{expand-file-name} to get the name of the directory where new
-maildirs are created. The form is @code{eval}ed only when the server
-is opened; the resulting string is used until the server is closed.
-This parameter is optional, but if you do not supply it, you cannot
-create new groups from within Gnus. (You could still create them from
-your shell with @code{mkdir -m 0700 foo foo/tmp foo/new foo/cur}.) A
-relative path is interpreted as relative to the @code{directory} path.
-@code{create-directory} and @code{directory} must be different;
-otherwise, group creation and deletion will break. (If you don't need
-those features, you can omit @code{create-directory} entirely.)
+\e$B$3$l$O\e(B Lisp \e$B<0$G$J$1$l$P$J$j$^$;$s!#\e(B@code{eval} \e$B$G=hM}$5$l$?8e$G!"\e(B
+@code{expand-file-name} \e$B$K$h$C$F?7$7$$\e(B maildir \e$B$,@8@.$5$l$k%G%#%l%/%H%j\e(B
+\e$B$NL>A0$r3MF@$7$^$9!#<0$O%5!<%P!<$,3+DL$7$?$H$-$@$1I>2A$5$l!"$=$N7k2LF@$i\e(B
+\e$B$l$?J8;zNs$,!"%5!<%P!<$,JD$8$i$l$k$^$G;H$o$l$^$9!#$3$N%Q%i%a!<%?$OG$0U$G\e(B
+\e$B$9$,!"$=$l$rM?$($J$$$H\e(B Gnus \e$B$G?7$7$$%0%k!<%W$r:n$k$3$H$,$G$-$^$;$s\e(B (\e$B$=$l\e(B
+\e$B$i$r\e(B shell \e$B$+$i\e(B @code{mkdir -m 0700 foo foo/tmp foo/new foo/cur} \e$B$G:n$k\e(B
+\e$B$3$H$O$G$-$^$9\e(B)\e$B!#AjBPE*$J%Q%9$O\e(B @code{directory} \e$B%Q%9$X$NAjBPCM$G$"$k$b\e(B
+
\e$B$N$H2r<a$5$l$^$9!#
\e(B@code{create-directory}
\e$B$H
\e(B @code{directory}
\e$B$O0c$C$F$$
\e(B
+\e$B$J$1$l$P$J$j$^$;$s!#$5$b$J$$$H@8@.$H>C5n$,GKC>$7$F$7$^$$$^$9\e(B (\e$B$=$l$i$N5!\e(B
+\e$BG=$,MW$i$J$$$N$G$"$l$P!"\e(B@code{create-directory} \e$B$r40`z$K>JN,$7$F$b9=$$$^\e(B
+\e$B$;$s\e(B)\e$B!#\e(B
@item directory-files
-This should be a function with the same interface as
-@code{directory-files} (such as @code{directory-files} itself). It is
-used to scan the server's @code{directory} for maildirs. This
-parameter is optional; the default is
-@code{nnheader-directory-files-safe} if
-@code{nnheader-directory-files-is-safe} is @code{nil}, and
-@code{directory-files} otherwise.
-(@code{nnheader-directory-files-is-safe} is checked only once when the
-server is opened; if you want to check it each time the directory is
-scanned, you'll have to provide your own function that does that.)
+\e$B$3$l$O\e(B @code{directory-files} \e$B$HF1$8%$%s%?!<%U%'!<%9$N4X\e(B
+\e$B?t\e(B (\e$B$^$?$O\e(B @code{directory-files} \e$B$=$N$b$N\e(B) \e$B$G$J$1$l$P$J$j$^$;$s!#$3$l\e(B
+\e$B$O\e(B maildir \e$BMQ$N%5!<%P!<$N\e(B @code{directory} \e$B$rAv::$9$k$?$a$K;H$o$l$^$9!#\e(B
+\e$B$3$N%Q%i%a!<%?$OG$0U$G$9!#%G%#%U%)%k%HCM$O!"\e(B
+@code{nnheader-directory-files-is-safe} \e$B$,\e(B @code{nil} \e$B$@$C$?\e(B
+\e$B$i\e(B @code{nnheader-directory-files-safe} \e$B$G!"$=$l0J30$N>l9g\e(B
+\e$B$O\e(B @code{directory-files} \e$B$G\e(B
+\e$B$9\e(B (@code{nnheader-directory-files-is-safe} \e$B$O%5!<%P!<$,3+DL$7$?$H$-$K0l\e(B
+\e$B2s$@$18!::$5$l$^$9$,!"%G%#%l%/%H%j$,Av::$5$l$k$H$-$KKh2s%A%'%C%/$5$;$?$$\e(B
+\e$B$N$J$i$P!"$=$l$r9T$J$&4X?t$r$"$J$?$,<+A0$GMQ0U$9$kI,MW$,$"$j$^$9\e(B)\e$B!#\e(B
@item get-new-mail
-If non-@code{nil}, then after scanning for new mail in the group
-maildirs themselves as usual, this server will also incorporate mail
-the conventional Gnus way, from @code{mail-sources} according to
-@code{nnmail-split-methods} or @code{nnmail-split-fancy}. The default
-value is @code{nil}.
-
-Do @emph{not} use the same maildir both in @code{mail-sources} and as
-an nnmaildir group. The results might happen to be useful, but that
-would be by chance, not by design, and the results might be different
-in the future. If your split rules create new groups, remember to
-supply a @code{create-directory} server parameter.
+\e$BHs\e(B-@code{nil} \e$B$K$7$F$*$/$H!"$$$D$b$NDL$j$K%0%k!<%W$N\e(B maildir \e$B<+BN$K$*$$\e(B
+\e$B$F?7Ce%a!<%k$rAv::$7$?8e$G!"$3$N%5!<%P!<\e(B
+\e$B$O\e(B @code{nnmail-split-methods} \e$B$+\e(B @code{nnmail-split-fancy} \e$B$K$h\e(B
+\e$B$k\e(B @code{mail-sources} \e$B$+$i!"=>Mh$N\e(B Gnus \e$B$NJ}K!$G%a!<%k$r<h$j9~$_$^$9!#\e(B
+\e$B%G%#%U%)%k%HCM$O\e(B @code{nil} \e$B$G$9!#\e(B
+
+@code{mail-sources} \e$B$H\e(B nnmaildir \e$B%0%k!<%W$NN>J}$GF1$8\e(B maildir \e$B$r;H$C$F\e(B
+\e$B$O\e(B @emph{\e$B$$$1$^$;$s\e(B}\e$B!#$=$N7k2L$O1?NI$/M-1W$K$J$k$+$b$7$l$^$;$s$,!"$=$s$J\e(B
+\e$B0U?^$G$O@_7W$5$l$F$$$^$;$s!#>-Mh$O0c$&7k2L$r$b$?$i$92DG=@-$,$"$j$^$9!#$"\e(B
+\e$B$J$?$NJ,3d5,B'$,?7$7$$%0%k!<%W$r:n$k$h$&$K$J$C$F$$$k>l9g$O!"\e(B
+@code{create-directory} \e$B%5!<%P!<%Q%i%a!<%?$rM?$($k$3$H$rK:$l$J$$$G2<$5$$!#\e(B
@end table
-@subsubsection Group parameters
-
-nnmaildir uses several group parameters. It's safe to ignore all
-this; the default behavior for nnmaildir is the same as the default
-behavior for other mail backends: articles are deleted after one week,
-etc. Except for the expiry parameters, all this functionality is
-unique to nnmaildir, so you can ignore it if you're just trying to
-duplicate the behavior you already have with another backend.
-
-If the value of any of these parameters is a vector, the first element
-is evaluated as a Lisp form and the result is used, rather than the
-original value. If the value is not a vector, the value itself is
-evaluated as a Lisp form. (This is why these parameters use names
-different from those of other, similar parameters supported by other
-backends: they have different, though similar, meanings.) (For
-numbers, strings, @code{nil}, and @code{t}, you can ignore the
-@code{eval} business again; for other values, remember to use an extra
-quote and wrap the value in a vector when appropriate.)
+@subsubsection \e$B%0%k!<%W%Q%i%a!<%?\e(B
+
+nnmaildir \e$B$O$$$/$D$+$N%0%k!<%W%Q%i%a!<%?$r;H$$$^$9!#$3$l$i$N$9$Y$F$rL5;k\e(B
+\e$B$7$F$b0BA4$G$9!#%G%#%U%)%k%H$N\e(B nnmaildir \e$B$NF0:n$O!"B>$N%a!<%k%P%C%/%(%s\e(B
+\e$B%I$N%G%#%U%)%k%H\e(B (\e$B5-;v$,0l=54V8e$K>C5n$5$l$k!"$J$I\e(B) \e$B$HF1$8$G$9!#4|8B@Z$l\e(B
+\e$B>C5n$N%Q%i%a!<%?$r=|$$$F!"$3$N5!G=$O$9$Y$F\e(B nnmaildir \e$B$KFCM-$G$9!#$7$?$,$C\e(B
+\e$B$F!"JL$N%P%C%/%(%s%I$G$9$G$K9T$C$F$$$kF0:n$rC1$KF'=1$5$;$h$&$H$$$&$N$G$"\e(B
+\e$B$l$P!"$3$l$rL5;k$9$k$3$H$,$G$-$^$9!#\e(B
+
+\e$B$3$l$i$N%Q%i%a!<%?$N$&$A$N$I$l$G$b!"$=$NCM$,%Y%/%H%k$G$"$k>l9g$O!"%*%j%8\e(B
+\e$B%J%k$NCM$KBe$o$C$F!"Bh0l$NMWAG$,\e(B Lisp \e$B<0$H$7$FI>2A$5$l$?7k2L$,;H$o$l$^$9!#\e(B
+\e$BCM$,%Y%/%H%k$G$J$$>l9g$O!"$=$NCM$=$N$b$N$,\e(B Lisp \e$B<0$H$7$FI>2A$5$l$^$9!#\e(B
+(\e$B$=$N$?$a!"$3$l$i$N%Q%i%a!<%?$OB>$H$O0c$&L>A0!"0c$&$1$l$I$b;w$?0UL#$r;}\e(B
+\e$B$DB>$N%P%C%/%(%s%I$G%5%]!<%H$5$l$F$$$kF1MM$N%Q%i%a!<%?!"$r;H$$$^$9!#\e(B)
+(\e$B?t!"J8;zNs!"\e(B@code{nil}\e$B!"$*$h$S\e(B @code{t} \e$B$K$D$$$F$O!"\e(B@code{eval} \e$B$N4XM?\e(B
+\e$B$r:F$SL5;k$9$k$3$H$,$G$-$^$9!#B>$NCM$K$D$$$F!"$=$l$,E,@Z$J>l9g$K$O!"M>J,\e(B
+\e$B$J%/%*!<%H$r;H$$!"$+$D%Y%/%H%k$GCM$rJq$`$3$H$rK:$l$J$$$G2<$5$$!#\e(B)
@table @code
@item expire-age
-An integer specifying the minimum age, in seconds, of an article before
-it will be expired, or the symbol @code{never} to specify that
-articles should never be expired. If this parameter is not set,
-nnmaildir falls back to the usual
-@code{nnmail-expiry-wait}(@code{-function}) variables (overridable by
-the @code{expiry-wait}(@code{-function}) group parameters. If you
-wanted a value of 3 days, you could use something like @code{[(* 3 24
-60 60)]}; nnmaildir will evaluate the form and use the result. An
-article's age is measured starting from the article file's
-modification time. Normally, this is the same as the article's
-delivery time, but editing an article makes it younger. Moving an
-article (other than via expiry) may also make an article younger.
+\e$B5-;v$,>C5n$5$l$k$^$G$N<wL?$NIC?t$r@0?t$G!"$^$?$O%7%s%\%k\e(B @code{never} \e$B$G\e(B
+\e$B5-;v$,4|8B@Z$l>C5n$5$l$F$O$J$i$J$$$3$H$r;XDj$7$^$9!#$3$N%Q%i%a!<%?$,@_Dj\e(B
+\e$B$5$l$F$$$J$$$H!"$$$D$b$N\e(B @code{nnmail-expiry-wait}(@code{-function}) \e$BJQ\e(B
+\e$B?t\e(B (@code{expiry-wait}(@code{-function}) \e$B%0%k!<%W%Q%i%a!<%?$G>e=q$-$5$l\e(B
+\e$B$k\e(B) \e$B$r:G8e$N$h$j$I$3$m$K$7$^$9!#\e(B3\e$BF|$NCM$,M_$7$$$J$i$P!"\e(B@code{[(* 3 24 60
+60)]} \e$B$N$h$&$J$b$N$r;H$C$F2<$5$$!#\e(Bnnmaildir \e$B$O<0$rI>2A$7$F!"$=$N7k2L$r;H\e(B
+\e$B$$$^$9!#5-;v$N<wL?$O5-;v%U%!%$%k$NJQ99;~9o$r4pE@$K7WB,$5$l$^$9!#DL>o$3$l\e(B
+\e$B$O5-;v$,G[Aw$5$l$?;~9o$HF1$8$G$9$,!"5-;v$NJT=8$O$=$l$r<c$/$7$^$9!#\e(B(\e$B4|8B\e(B
+\e$B@Z$l>C5n0J30$N\e(B) \e$B5-;v$N0\F0$b$^$?!"5-;v$r<c$/$7$F$7$^$&$G$7$g$&!#\e(B
@item expire-group
-If this is set to a string (a full Gnus group name, like
-@code{"backend+server.address.string:group.name"}), and if it is not
-the name of the same group that the parameter belongs to, then
-articles will be moved to the specified group during expiry before
-being deleted. @emph{If this is set to an nnmaildir group, the
-article will be just as old in the destination group as it was in the
-source group.} So be careful with @code{expire-age} in the destination
-group.
+\e$B$3$l$,J8;zNs\e(B (@code{"backend+server.address.string:group.name"} \e$B$N$h$&$J\e(B
+\e$B40A4$J\e(B Gnus \e$B$N%0%k!<%WL>\e(B) \e$B$G!"$+$D$=$N%Q%i%a!<%?$,F1$8L>A0$N%0%k!<%W$KB0\e(B
+\e$B$5$J$$>l9g!"4|8B@Z$l>C5n$,9T$J$o$l$k:]$K!"5-;v$O>C5n$5$l$kA0$K;XDj$5$l$?\e(B
+\e$B%0%k!<%W$K0\F0$5$;$i$l$^$9!#\e(B@emph{\e$B$3$l$,\e(B nnmaildir \e$B%0%k!<%W$K@_Dj$5$l$k\e(B
+\e$B$H!"0\F0@h$N%0%k!<%W$K$*$$$F!"5-;v$,85$N%0%k!<%W$K$"$C$?$H$-$H$A$g$&$IF1\e(B
+\e$B$8$@$18E$/$J$j$^$9!#\e(B} \e$B$7$?$,$C$F!"0\F0@h$N%0%k!<%W$K$*$1\e(B
+\e$B$k\e(B @code{expire-age} \e$B$K$OCm0U$7$F2<$5$$!#\e(B
@item read-only
-If this is set to @code{t}, nnmaildir will treat the articles in this
-maildir as read-only. This means: articles are not renamed from
-@file{new/} into @file{cur/}; articles are only found in @file{new/},
-not @file{cur/}; articles are never deleted; articles cannot be
-edited. @file{new/} is expected to be a symlink to the @file{new/}
-directory of another maildir - e.g., a system-wide mailbox containing
-a mailing list of common interest. Everything in the maildir outside
-@file{new/} is @emph{not} treated as read-only, so for a shared
-mailbox, you do still need to set up your own maildir (or have write
-permission to the shared mailbox); your maildir just won't contain
-extra copies of the articles.
+\e$B$3$l$,\e(B @code{t} \e$B$K@_Dj$5$l$F$$$k$H!"\e(Bnnmaildir \e$B$O$=$N5-;v$r$3$N%0%k!<%W$G\e(B
+\e$BFI$_=P$7@lMQ$H$7$F07$$$^$9!#$3$N0UL#$O!"5-;v$O\e(B @file{new/} \e$B$+\e(B
+\e$B$i\e(B @file{cur/} \e$B$K2~L>$5$l$J$$!"5-;v$O\e(B @file{cur/} \e$B$G$O$J\e(B
+\e$B$/\e(B @file{new/} \e$B$G$N$_8+$D$+$k!"5-;v$O>C5n$5$l$J$$!"5-;v$OJT=8$G$-$J$$!"\e(B
+\e$B$H$$$&$3$H$G$9!#\e(B@file{new/} \e$B$OB>$N\e(B maildir \e$B$N\e(B @file{new/} \e$B%G%#%l%/%H%j!"\e(B
+\e$BNc$($P$_$s$J$,6=L#$,$"$k%a!<%j%s%0%j%9%H$r4^$s$G$$$k%7%9%F%`$G6&DL$N%a!<\e(B
+\e$B%k%\%C%/%9!"$X$N%7%s%\%j%C%/%j%s%/$G$"$k$HA[Dj$5$l$^$9!#\e(B@file{new/} \e$B0J30\e(B
+\e$B$N\e(B maildir \e$B$K$"$k$9$Y$F$N$b$N$O!"FI$_=P$7@lMQ$H$7$F07$o$l\e(B @emph{\e$B$^$;$s\e(B}\e$B!#\e(B
+\e$B$7$?$,$C$F6&M-$N%a!<%k%\%C%/%9$KBP$7$F$O!"$"$J$?<+?H$N\e(B maildir \e$B$r@_Dj$9\e(B
+\e$B$k\e(B (\e$B$^$?$O\e(B \e$B6&M-$N%a!<%k%\%C%/%9$K=q$-9~$_8"8B$r;}$D\e(B) \e$BI,MW$,0MA3$H$7$F$"\e(B
+\e$B$j$^$9!#$"$J$?$N\e(B maildir \e$B$O5-;v$NM>J,$J%3%T!<$r$^$C$?$/4^$^$J$$$G$7$g$&!#\e(B
@item directory-files
-A function with the same interface as @code{directory-files}. It is
-used to scan the directories in the maildir corresponding to this
-group to find articles. The default is the function specified by the
-server's @code{directory-files} parameter.
+@code{directory-files} \e$B$HF1$8%$%s%?!<%U%'!<%9$N4X?t$G$9!#5-;v$r8+$D$1$k\e(B
+\e$B$?$a$K!"$3$N%0%k!<%W$KBP1~$9$k\e(B maildir \e$B$N%G%#%l%/%H%j$rAv::$9$k$?$a$K;H\e(B
+\e$B$o$l$^$9!#%G%#%U%)%k%H$O%5!<%P!<$N\e(B @code{directory-files} \e$B%Q%i%a!<%?$G@_\e(B
+\e$BDj$5$l$F$$$k4X?t$G$9!#\e(B
@item always-marks
-A list of mark symbols, such as
-@code{['(read expire)]}. Whenever Gnus asks nnmaildir for
-article marks, nnmaildir will say that all articles have these
-marks, regardless of whether the marks stored in the filesystem
-say so. This is a proof-of-concept feature that will probably be
-removed eventually; it ought to be done in Gnus proper, or
-abandoned if it's not worthwhile.
+@code{['(read expire)]} \e$B$N$h$&$J0u%7%s%\%k$N%j%9%H$G$9!#\e(BGnus \e$B$,5-;v$N0u\e(B
+\e$B$r\e(B nnmaildir \e$B$K?R$M$k$H$-$O$$$D$G$b!"%U%!%$%k%7%9%F%`$K3JG<$5$l$F$$$k0u\e(B
+\e$B$,2?$G$"$k$+$H$OL54X78$K!"\e(Bnnmaildir \e$B$O$9$Y$F$N5-;v$,$3$l$i$N0u$r;}$C$F$$\e(B
+\e$B$k$HEz$($^$9!#$3$l$O9=A[$r;n$9$?$a$N5!G=$G!"$*$=$i$/7k6I$O:o=|$5$l$k$G$7$g\e(B
+\e$B$&!#$=$l$O\e(B Gnus \e$BK\BN$G9T$o$l$k$+!"$"$k$$$OM-1W$G$J$1$l$PJ|4~$5$l$k$Y$-$G\e(B
+\e$B$9!#\e(B
@item never-marks
-A list of mark symbols, such as @code{['(tick expire)]}. Whenever
-Gnus asks nnmaildir for article marks, nnmaildir will say that no
-articles have these marks, regardless of whether the marks stored in
-the filesystem say so. @code{never-marks} overrides
-@code{always-marks}. This is a proof-of-concept feature that will
-probably be removed eventually; it ought to be done in Gnus proper, or
-abandoned if it's not worthwhile.
+@code{['(tick expire)]} \e$B$N$h$&$J0u%7%s%\%k$N%j%9%H$G$9!#\e(BGnus \e$B$,5-;v$N0u\e(B
+\e$B$r\e(B nnmaildir \e$B$K?R$M$k$H$-$O$$$D$G$b!"%U%!%$%k%7%9%F%`$K3JG<$5$l$F$$$k0u\e(B
+\e$B$,2?$G$"$k$+$H$OL54X78$K!"\e(Bnnmaildir \e$B$O$3$l$i$N0u$r;}$C$F$$$k5-;v$OL5$$$H\e(B
+\e$BEz$($^$9!#\e(B@code{never-marks} \e$B$O\e(B @code{always-marks} \e$B$r>e=q$-$7$^$9!#$3$l\e(B
+\e$B$O9=A[$r;n$9$?$a$N5!G=$G!"$*$=$i$/7k6I$O:o=|$5$l$k$G$7$g$&!#$=$l$O\e(B Gnus
+\e$BK\BN$G9T$o$l$k$+!"$"$k$$$OM-1W$G$J$1$l$PJ|4~$5$l$k$Y$-$G$9!#\e(B
@item nov-cache-size
-An integer specifying the size of the NOV memory cache. To speed
-things up, nnmaildir keeps NOV data in memory for a limited number of
-articles in each group. (This is probably not worthwhile, and will
-probably be removed in the future.) This parameter's value is noticed
-only the first time a group is seen after the server is opened - i.e.,
-when you first start Gnus, typically. The NOV cache is never resized
-until the server is closed and reopened. The default is an estimate
-of the number of articles that would be displayed in the summary
-buffer: a count of articles that are either marked with @code{tick} or
-not marked with @code{read}, plus a little extra.
+NOV \e$B%a%b%j!<%-%c%C%7%e$N%5%$%:$r;XDj$9$k@0?t$G$9!#%9%T!<%I%"%C%W$N$?$a$K!"\e(B
+nnmaildir \e$B$O$=$l$>$l$N%0%k!<%W$N8BDj$5$l$??t$N5-;v$KBP$7$F!"%a%b%j!<>e\e(B
+\e$B$K\e(B NOV \e$B%G!<%?$rJ];}$7$^$9!#\e(B(\e$B$3$l$O$?$V$sM-MQ$G$O$J$/!">-Mh$O$*$=$i$/:o=|\e(B
+\e$B$5$l$k$G$7$g$&\e(B)\e$B!#$3$N%Q%i%a!<%?$NCM$O!"%5!<%P!<$,3+DL$7$?8e$G:G=i$K%0%k!<\e(B
+\e$B%W$,8+$i$l$?$H$-!"$9$J$o$A0lHL$K$O:G=i$K\e(B Gnus \e$B$r5/F0$7$?$H$-!"$@$1CmL\$5\e(B
+\e$B$l$^$9!#%5!<%P!<$,JD$8$i$l$F:F$S3+DL$5$l$k$^$G$O!"\e(BNOV \e$B%-%c%C%7%e$N%5%$%:\e(B
+\e$B$OJQ99$5$l$^$;$s!#%G%#%U%)%k%H$O35N,%P%C%U%!$KI=<($5$l$k5-;v$N?t$N8+@Q\e(B
+\e$B$j\e(B (@code{tick} \e$B0u$,$"$C$F\e(B @code{read} \e$B$,L5$$5-;v$N?t$K>/!9$NM>J,$r2C$(\e(B
+\e$B$?$b$N\e(B) \e$B$G$9!#\e(B
@end table
-@subsubsection Article identification
-Articles are stored in the @file{cur/} subdirectory of each maildir.
-Each article file is named like @code{uniq:info}, where @code{uniq}
-contains no colons. nnmaildir ignores, but preserves, the
-@code{:info} part. (Other maildir readers typically use this part of
-the filename to store marks.) The @code{uniq} part uniquely
-identifies the article, and is used in various places in the
-@file{.nnmaildir/} subdirectory of the maildir to store information
-about the corresponding article. The full pathname of an article is
-available in the variable @code{nnmaildir-article-file-name} after you
-request the article in the summary buffer.
-
-@subsubsection NOV data
-An article identified by @code{uniq} has its NOV data (used to
-generate lines in the summary buffer) stored in
-@code{.nnmaildir/nov/uniq}. There is no
-@code{nnmaildir-generate-nov-databases} function. (There isn't much
-need for it - an article's NOV data is updated automatically when the
-article or @code{nnmail-extra-headers} has changed.) You can force
-nnmaildir to regenerate the NOV data for a single article simply by
-deleting the corresponding NOV file, but @emph{beware}: this will also
-cause nnmaildir to assign a new article number for this article, which
-may cause trouble with @code{seen} marks, the Agent, and the cache.
-
-@subsubsection Article marks
-An article identified by @code{uniq} is considered to have the mark
-@code{flag} when the file @file{.nnmaildir/marks/flag/uniq} exists.
-When Gnus asks nnmaildir for a group's marks, nnmaildir looks for such
-files and reports the set of marks it finds. When Gnus asks nnmaildir
-to store a new set of marks, nnmaildir creates and deletes the
-corresponding files as needed. (Actually, rather than create a new
-file for each mark, it just creates hard links to
-@file{.nnmaildir/markfile}, to save inodes.)
-
-You can invent new marks by creating a new directory in
-@file{.nnmaildir/marks/}. You can tar up a maildir and remove it from
-your server, untar it later, and keep your marks. You can add and
-remove marks yourself by creating and deleting mark files. If you do
-this while Gnus is running and your nnmaildir server is open, it's
-best to exit all summary buffers for nnmaildir groups and type @kbd{s}
-in the group buffer first, and to type @kbd{g} or @kbd{M-g} in the
-group buffer afterwards. Otherwise, Gnus might not pick up the
-changes, and might undo them.
+@subsubsection \e$B5-;v$N<1JL\e(B
+\e$B5-;v$O$=$l$>$l$N\e(B maildir \e$B$N\e(B @file{cur/} \e$B%G%#%l%/%H%j$K3JG<$5$l$^$9!#3F!9\e(B
+\e$B$N5-;v$K$O\e(B @code{uniq:info} \e$B$N$h$&$JL>A0$,IU$1$i$l$^$9!#$3$3\e(B
+\e$B$G\e(B @code{uniq} \e$B$O%3%m%s$r4^$_$^$;$s!#\e(Bnnmaildir \e$B$O\e(B @code{:info} \e$B$NItJ,$r\e(B
+\e$BJ];}$7$^$9$,L5;k$7$^$9!#\e(B(\e$BB>$N\e(B maildir \e$B%j!<%@!<$O0lHL$K0u$r3JG<$9$k$?$a$K\e(B
+\e$B$3$NItJ,$r;H$$$^$9!#\e(B) @code{uniq} \e$B$NItJ,$O5-;v$r%f%K!<%/$K<1JL$7!"\e(B
+maildir \e$B$N\e(B @file{.nnmaildir/} \e$B%5%V%G%#%l%/%H%j$N?'!9$J>l=j$K5-;v$K4XO"$7\e(B
+\e$B$?>pJs$r3JG<$9$k$?$a$K;H$o$l$^$9!#35N,%P%C%U%!$G5-;v$rMW5a$7$?8e$G!"5-;v\e(B
+\e$B$N40A4$J%Q%9L>$,\e(B @code{nnmaildir-article-file-name} \e$BJQ?t$+$iF@$i$l$^$9!#\e(B
+
+@subsubsection NOV \e$B%G!<%?\e(B
+@code{uniq} \e$B$K$h$C$F<1JL$5$l$k5-;v$O!"$=$N\e(B NOV \e$B%G!<%?\e(B (\e$B35N,%P%C%U%!$N9T\e(B
+\e$B$r@8@.$9$k$?$a$K;H$o$l$k\e(B) \e$B$r\e(B @code{.nnmaildir/nov/uniq} \e$B$K3JG<$7$^$9!#\e(B
+@code{nnmaildir-generate-nov-databases} \e$B4X?t$O$"$j$^$;$s!#\e(B(\e$B$=$NI,MW$O$"\e(B
+\e$B$^$j$"$j$^$;$s!#5-;v$N\e(B NOV \e$B%G!<%?$O5-;v$+\e(B @code{nnmail-extra-headers} \e$B$,\e(B
+\e$BJQ2=$7$?$H$-$K<+F0E*$K99?7$5$l$^$9!#\e(B) \e$BBP1~$9$k\e(B NOV \e$B%U%!%$%k$r$?$@>C$9$3\e(B
+\e$B$H$K$h$C$FC10l$N5-;v$N\e(B NOV \e$B%G!<%?$N@8@.$r\e(B nnmaildir \e$B$K6/@)$9$k$3$H$O$G$-\e(B
+\e$B$^$9!#$7$+$7\e(B @emph{\e$B$4MQ?4\e(B}\e$B!#$3$l$O\e(B nnmaildir \e$B$,$3$N5-;v$K?7$7$$5-;vHV9f\e(B
+\e$B$r3d$j?6$i$;!"\e(B@code{seen} \e$B0u!"%(!<%8%'%s%H!"$*$h$S%-%c%C%7%e$K$H$C$FLLE]\e(B
+\e$B$J$3$H$K$J$j$^$9!#\e(B
+
+@subsubsection \e$B5-;v$N0u\e(B
+@file{.nnmaildir/marks/flag/uniq} \e$B%U%!%$%k$,$"$k>l9g$K!"\e(B@code{uniq} \e$B$K$h$C\e(B
+\e$B$F<1JL$5$l$k5-;v$O!"\e(B@code{flag} \e$B0u$r;}$D$b$N$H9M$($i$l$^$9!#\e(B
+Gnus \e$B$,\e(B nnmaildir \e$B$K%0%k!<%W$N0u$r?R$M$k$H!"\e(Bnnmaildir \e$B$O$=$N$h$&$J%U%!%$\e(B
+\e$B%k$rC5$7$F!"8+$D$1$?0u$N%;%C%H$rJs9p$7$^$9!#\e(BGnus \e$B$,\e(B nnmaildir \e$B$K0u$N%;%C\e(B
+\e$B%H$N3JG<$rMW5a$9$k$H!"\e(Bnnmaildir \e$B$OI,MW$JBP1~$9$k%U%!%$%k$r@8@.$7!"$^$?$O\e(B
+\e$B>C5n$7$^$9!#\e(B(\e$B<B:]$O!"$=$l$>$l$N0u$N$?$a$K?7$7$$%U%!%$%k$r:n$k$N$G$O$J$/!"\e(B
+i\e$B%N!<%I\e(B \e$B$r@aLs$9$k$?$a$KC1$K\e(B @file{.nnmaildir/markfile} \e$B$X$N%O!<%I%j%s%/\e(B
+\e$B$rD%$j$^$9!#\e(B)
+
+@file{.nnmaildir/marks/} \e$B$K?7$7$$%G%#%l%/%H%j$r:n$k$3$H$K$h$C$F!"?7$7$$\e(B
+\e$B0u$rAOB$$9$k$3$H$,$G$-$^$9!#0u$rJ];}$7$D$D\e(B maildir \e$B$r\e(B tar \e$B$G$^$H$a$F%5!<\e(B
+\e$B%P!<$+$i$=$l$r:o=|$7!"8e$G\e(B tar \e$B$r$[$I$/$3$H$,$G$-$^$9!#0u%U%!%$%k$r:n@.\e(B
+\e$B$^$?$O>C5n$9$k$3$H$K$h$C$F!"$"$J$?<+?H$,0u$rDI2C$^$?$O:o=|$9$k$3$H$,$G$-\e(B
+\e$B$^$9!#\e(BGnus \e$B$,F0:n$7$F$$$F\e(B nnmaildir \e$B%5!<%P!<$,3+DL$7$F$$$k$H$-$K$3$l$r9T\e(B
+\e$B$J$&>l9g$O!":G=i$K$9$Y$F$N\e(B nnmaildir \e$B%0%k!<%W$N35N,%P%C%U%!$+$iB`=P$7$F\e(B
+\e$B%0%k!<%W%P%C%U%!$G\e(B @kbd{s} \e$B$r%?%$%W$7!"$=$N8e%0%k!<%W%P%C%U%!\e(B
+\e$B$G\e(B @kbd{g} \e$B$+\e(B @kbd{M-g} \e$B$r%?%$%W$9$k$N$,:GNI$G$9!#$=$&$7$J$$$H\e(B Gnus \e$B$OJQ\e(B
+\e$B99$rB*$($F$/$l$:$K!"$=$l$i$r85$KLa$7$F$7$^$&$+$b$7$l$^$;$s!#\e(B
@node Mail Folders
@subsubsection \e$B%a!<%k%U%)%k%@!<\e(B
projects / elisp / gnus.git- / commitdiff