From 1f1c2ba2c92a364a1fb9d093e7b6c97ad097856d Mon Sep 17 00:00:00 2001 From: yamaoka Date: Thu, 8 Feb 2001 02:14:40 +0000 Subject: [PATCH] Synch with Oort Gnus; translating info is a hard work! --- texi/ChangeLog | 5 +++++ texi/gnus-ja.texi | 43 ++++++++++++++++++++++++++++++------------- texi/gnus.texi | 49 +++++++++++++++++++++++++++++++++---------------- 3 files changed, 68 insertions(+), 29 deletions(-) diff --git a/texi/ChangeLog b/texi/ChangeLog index 44b85c1..f552ab8 100644 --- a/texi/ChangeLog +++ b/texi/ChangeLog @@ -1,5 +1,10 @@ 2001-02-07 Kai Gro,A_(Bjohann + * gnus.texi (Mail Source Specifiers, IMAP, Agent and IMAP): + Improve IMAP discussion. + +2001-02-07 Kai Gro,A_(Bjohann + * message.texi (Message Headers): `message-generate-headers-first'. 2001-02-06 19:00:00 ShengHuo ZHU diff --git a/texi/gnus-ja.texi b/texi/gnus-ja.texi index 020d77d..ddd1d3f 100644 --- a/texi/gnus-ja.texi +++ b/texi/gnus-ja.texi @@ -10942,7 +10942,7 @@ Maildir $B%a!<%k%=!<%9$NNc$r$U$?$D(B: IMAP $B%5!<%P!<$+$i%a!<%k$re$G%a!<%k$rFI$`%W%m%H%3%k$H$7$F07$$$?$/$J$$$H$-$O!"(B gnus $B$G$O(B POP $B%5!<%P!<$HF1MM$K07$&$3$H$,$G$-!"M?$($i$l$?(B IMAP $B%a!<%k%\%C(B -$B%/%9$+$i5-;v$r\$7$/$O(B @xref{IMAP} $B$r;2>H$7$F2<$5$$!#(B $B%-!<%o!<%I(B: @@ -13307,6 +13307,23 @@ IMAP $B$O%a!<%k(B ($B$b$7$/$O!"%K%e!<%9!"$b$7$/$O(B ...) $B$rFI$`$?$a$N%M%C $B$O%K%e!<%9%5!<%P!<$X$N@\B3$HHs>o$K;w$F$$$F!"$=$N%5!<%P!<$N%M%C%H%o!<%/%"(B $B%I%l%9$r;XDj$9$k$@$1$K$J$C$F$$$^$9!#(B +@sc{imap} $B$K$OFs$D$NFCH$7$F2<$5$$!#(B + +@sc{imap} $B$r%a!<%k$rCyB"$9$k%W%m%H%3%k$H$7$F;H$$$?$$$H$-$O!"(B +gnus-secondary-select-methods $B$K(B nnimap $B$rEPO?$7$F2<$5$$!#$3$l$K$h$C(B +$B$F(B gnus $B$O(B @sc{imap} $B%5!<%P!<$KCyB"$5$l$F$$$k%a!<%k$rA`:n$9$k$h$&$K$J$j(B +$B$^$9!#$3$l$,$3$3$G@bL@$9$k;H$$J}$G$9!#(B + $B$$$/$D$+$N(B @sc{imap} $B%5!<%P!<$r(B @code{~/.gnus} $B$G@_Dj$9$k$H!"$?$V$s$3$N(B $B$h$&$J$b$N$K$J$k$G$7$g$&(B: @@ -13408,7 +13425,7 @@ IMAP $B$O%a!<%k(B ($B$b$7$/$O!"%K%e!<%9!"$b$7$/$O(B ...) $B$rFI$`$?$a$N%M%C @dfn{ssl:} SSL $B$r;H$$$^$9!#(BOpenSSL (@samp{openssl} $B%W%m%0%i(B $B%`(B) $B$+(B SSLeay (@samp{s_client}) $B$,I,MW$G$9!#(B @item -@dfn{shell:} $B%7%'%kL?Na$r;H$C$F(B IMAP $B@\B3$r3+;O$7$^$9!#(B +@dfn{shell:} $B%7%'%kL?Na$r;H$C$F(B @sc{imap} $B@\B3$r3+;O$7$^$9!#(B @item @dfn{network:} $B@8$N!"(BTCP/IP $B$N%M%C%H%o!<%/@\B3$G$9!#(B @end itemize @@ -13429,7 +13446,7 @@ nnimap $B$O$=$l$b%5%]!<%H$7$^$9!#$7$+$7!"(BSSLeay $B$N:G?7HG$G$"$k(B 0.9.x  @vindex imap-shell-program @vindex imap-shell-host -IMAP $B@\B3$K(B @code{shell} $B%9%H%j!<%`$r;H$&>l9g!"JQ(B +@sc{imap} $B@\B3$K(B @code{shell} $B%9%H%j!<%`$r;H$&>l9g!"JQ(B $B?t(B @code{imap-shell-program} $B$O2?$N%W%m%0%i%`$r8F$V$+$r;XDj$7$^$9!#(B @item nnimap-authenticator @@ -14501,14 +14518,14 @@ $ emacs -batch -l ~/.gnus.el -f gnus-agent-batch-fetch @subsection $B%(!<%8%'%s%H$r(B IMAP $B$G;H$&J}K!(B $B%(!<%8%'%s%H$O(B nnimap $B$r4^$`(B gnus $B$N$I$s$J%P%C%/%(%s%I$G$bF0:n$7$^$9!#$7(B -$B$+$7(B NNTP $B$H(B IMAP $B$K$O$$$/$D$+$N35G0$N0c$$$,$"$k$N$G!"$3$N9`$G$O(B gnus $B%(!<(B -$B%8%'%s%H$r(B IMAP $B$N(B @dfn{unplugged} $B$J%b!<%I$N%/%i%$%"%s%H$H$7$F1_3j$K;H(B -$B$($k$h$&$K$9$k$?$a$N!"$$$/$D$+$N>pJs$rDs6!$7$^$9!#(B +$B$+$7(B @sc{nntp} $B$H(B @sc{imap} $B$K$O$$$/$D$+$N35G0$N0c$$$,$"$k$N$G!"$3$N9`$G(B +$B$O(B gnus $B%(!<%8%'%s%H$r(B @sc{imap} $B$N(B @dfn{unplugged} $B$J%b!<%I$N%/%i%$%"%s(B +$B%H$H$7$F1_3j$K;H$($k$h$&$K$9$k$?$a$N!"$$$/$D$+$N>pJs$rDs6!$7$^$9!#(B $B?4$KN1$a$F$*$/:G=i$N$3$H$O!"A4$F$N%U%i%0(B (read, ticked $B$J$I(B) $B$O(B nntp $B$N(B -$B>l9g$K$*$1$k(B @code{.newsrc} $B$G$O$J$/$F(B IMAP $B%5!<%P!<$KJ];}$5$l$k$H$$$&$3(B -$B$H$G$9!#$7$?$,$C$F!"(Bgnus $B$O(B @dfn{unplugged} $B$N$H$-$N%U%i%0$NJQ2=$r3P$($F(B -$B$*$$$F!":F$S@\B3$7$?$H$-$K$=$l$i$N%U%i%0$rF14|$5$;$kI,MW$,$"$j$^$9!#(B +$B>l9g$K$*$1$k(B @code{.newsrc} $B$G$O$J$/$F(B @sc{imap} $B%5!<%P!<$KJ];}$5$l$k$H(B +$B$$$&$3$H$G$9!#$7$?$,$C$F!"(Bgnus $B$O(B @dfn{unplugged} $B$N$H$-$N%U%i%0$NJQ2=$r(B +$B3P$($F$*$$$F!":F$S@\B3$7$?$H$-$K$=$l$i$N%U%i%0$rF14|$5$;$kI,MW$,$"$j$^$9!#(B gnus $B$O%(!<%8%'%s%H$N85$G(B nnimap $B%0%k!<%W$rFI$`$H$-!"%G%#%U%)%k%H$G%U%i(B $B%0$NJQ2=$K@d$($:Cm0U$7$F$$$^$9!#$"$J$?$,:F$S@\B3$7$?$H$-!"%G%#%U%)%k%H(B @@ -14529,9 +14546,9 @@ gnus $B$O%(!<%8%'%s%H$N85$G(B nnimap $B%0%k!<%W$rFI$`$H$-!"%G%#%U%)%k%H$G%U%i $B%-!<$K3d$jEv$F$i$l$?(B @code{gnus-agent-synchronize-flags} $B%3%^%s%I$r;H$$(B $B$^$9!#(B -$B$"$J$?$,!"(B@dfn{unplugged} $B$N$H$-$N(B IMAP $B%/%i%$%"%s%H$K4|BT$9$k$G$"$m$&$$(B -$B$/$D$+$N5!G=$O!"8=:_$N%(!<%8%'%s%H$K$O@9$j9~$^$l$F$$$^$;$s!#$=$l$i$O0J2<(B -$B$NDL$j$G$9!#(B +$B$"$J$?$,!"(B@dfn{unplugged} $B$N$H$-$N(B @sc{imap} $B%/%i%$%"%s%H$K4|BT$9$k$G$"(B +$B$m$&$$$/$D$+$N5!G=$O!"8=:_$N%(!<%8%'%s%H$K$O@9$j9~$^$l$F$$$^$;$s!#$=$l$i(B +$B$O0J2<$NDL$j$G$9!#(B @itemize @bullet @@ -18244,7 +18261,7 @@ Gnus $B$O!"%9%3%"IU$1!"%9%l%C%I$N7A@.!"%9%l%C%IHf3S$J$I$r9T$&$H$-$K!"(B $BDL>o(B @samp{:} $B$r;H$C$F$$$k(B) $B$r$a$A$c$a$A$c$K$7$F$7$^$&$+$b$7$l$J$$!"$$$/(B $B$D$+$N(B @strong{$BK\Ev$K(B} $B;H$($J$$%0%k!<%WL>$rJa$^$($^$9!#(B -IMAP $B%f!<%6$O%0%k!<%WL>$K(B @samp{/} $B$r;H$$$?$$$H;W$&$G$7$g$&$1$l$I!#(B +@sc{imap} $B%f!<%6$O%0%k!<%WL>$K(B @samp{/} $B$r;H$$$?$$$H;W$&$G$7$g$&$1$l$I!#(B @end table diff --git a/texi/gnus.texi b/texi/gnus.texi index 9934ad8..ecb969b 100644 --- a/texi/gnus.texi +++ b/texi/gnus.texi @@ -11426,10 +11426,11 @@ Two example maildir mail sources: @end lisp @item imap -Get mail from a @sc{imap} server. If you don't want to use @sc{imap} as -intended, as a network mail reading protocol (ie with nnimap), for some -reason or other, Gnus let you treat it similar to a POP server and -fetches articles from a given @sc{imap} mailbox. +Get mail from a @sc{imap} server. If you don't want to use @sc{imap} +as intended, as a network mail reading protocol (ie with nnimap), for +some reason or other, Gnus let you treat it similar to a POP server +and fetches articles from a given @sc{imap} mailbox. @xref{IMAP}, for +more information. Keywords: @@ -13824,9 +13825,25 @@ So, to use this, simply say something like: @cindex @sc{imap} @sc{imap} is a network protocol for reading mail (or news, or ...), -think of it as a modernized @sc{nntp}. Connecting to a @sc{imap} server -is much similar to connecting to a news server, you just specify the -network address of the server. +think of it as a modernized @sc{nntp}. Connecting to a @sc{imap} +server is much similar to connecting to a news server, you just +specify the network address of the server. + +@sc{imap} has two properties. First, @sc{imap} can do everything that +POP can, it can hence be viewed as POP++. Secondly, @sc{imap} is a +mail storage protocol, similar to @sc{nntp} being a news storage +protocol. (@sc{imap} offers more features than @sc{nntp} because news +is more or less read-only whereas mail is read-write.) + +If you want to use @sc{imap} as POP++, use an imap entry in +mail-sources. With this, Gnus will fetch mails from the @sc{imap} +server and store them on the local disk. This is not the usage +described in this section. @xref{Mail Sources}. + +If you want to use @sc{imap} as a mail storage protocol, use an nnimap +entry in gnus-secondary-select-methods. With this, Gnus will +manipulate mails stored on the @sc{imap} server. This is the kind of +usage explained in this section. A server configuration in @code{~/.gnus} with a few @sc{imap} servers might look something like this: @@ -13928,7 +13945,7 @@ SSL). Require the external library @samp{starttls.el} and program @dfn{ssl:} Connect through SSL. Require OpenSSL (the program @samp{openssl}) or SSLeay (@samp{s_client}). @item -@dfn{shell:} Use a shell command to start IMAP connection. +@dfn{shell:} Use a shell command to start @sc{imap} connection. @item @dfn{network:} Plain, TCP/IP network connection. @end itemize @@ -13950,7 +13967,7 @@ to OpenSSL/SSLeay. @vindex imap-shell-program @vindex imap-shell-host -For IMAP connections using the @code{shell} stream, the variable +For @sc{imap} connections using the @code{shell} stream, the variable @code{imap-shell-program} specify what program to call. @item nnimap-authenticator @@ -15063,13 +15080,13 @@ unread, ticked and dormant articles will be kept indefinitely. @node Agent and IMAP @subsection Agent and IMAP -The Agent work with any Gnus backend, including nnimap. However, since -there are some conceptual differences between NNTP and IMAP, this -section (should) provide you with some information to make Gnus Agent -work smoother as a IMAP Disconnected Mode client. +The Agent work with any Gnus backend, including nnimap. However, +since there are some conceptual differences between @sc{nntp} and +@sc{imap}, this section (should) provide you with some information to +make Gnus Agent work smoother as a @sc{imap} Disconnected Mode client. The first thing to keep in mind is that all flags (read, ticked, etc) -are kept on the IMAP server, rather than in @code{.newsrc} as is the +are kept on the @sc{imap} server, rather than in @code{.newsrc} as is the case for nntp. Thus Gnus need to remember flag changes when disconnected, and synchronize these flags when you plug back in. @@ -15092,7 +15109,7 @@ re-connect, this can be done manually with the in the group buffer by default. Some things are currently not implemented in the Agent that you'd might -expect from a disconnected IMAP client, including: +expect from a disconnected @sc{imap} client, including: @itemize @bullet @@ -18835,7 +18852,7 @@ names who could possibly mess up Gnus internally (like allowing @samp{:} in a group name, which is normally used to delimit method and group). -IMAP users might want to allow @samp{/} in group names though. +@sc{imap} users might want to allow @samp{/} in group names though. @end table -- 1.7.10.4