diff options
author | Eric Abrahamsen <eric@ericabrahamsen.net> | 2020-12-02 15:52:25 -0800 |
---|---|---|
committer | Eric Abrahamsen <eric@ericabrahamsen.net> | 2020-12-03 10:19:27 -0800 |
commit | cff2f895c2e55161486a8011288171daae9ecccc (patch) | |
tree | 1a2f25721badd0048c4a34a5257e7dc1dd7b14a0 /doc/misc/gnus.texi | |
parent | 6ecec6096697729491ba141e7650ad69de5f034e (diff) | |
download | emacs-cff2f895c2e55161486a8011288171daae9ecccc.tar.gz |
Restore nnimap-split-download-body as a customization option
* lisp/gnus/nnimap.el (nnimap-split-download-body): And add an
obsolete alias for `nnimap-split-download-body-default'.
(nnimap-fetch-inbox): Check the value of the option, not the variable.
* doc/misc/gnus.texi (Client-Side IMAP Splitting): Move the primary
documentation of this option to this section.
Diffstat (limited to 'doc/misc/gnus.texi')
-rw-r--r-- | doc/misc/gnus.texi | 16 |
1 files changed, 9 insertions, 7 deletions
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 81ce13945c1..4aa07ce3887 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -14521,6 +14521,14 @@ The default is @samp{(%Deleted %Seen)}. @end table +@vindex nnimap-split-download-body +By default, the nnimap back end only retrieves the message headers; +the option @code{nnimap-split-download-body} (which is a regular +customization option, not a server variable) tells it to retrieve the +message bodies as well. We don't set this by default because it will +slow @acronym{IMAP} down, and that is not an appropriate decision to +make on behalf of the user. + Here's a complete example @code{nnimap} backend with a client-side ``fancy'' splitting method: @@ -24622,13 +24630,7 @@ the value @samp{spam} means @samp{nnimap+your-server:spam}. The value Note for IMAP users: if you use the @code{spam-check-bogofilter}, @code{spam-check-ifile}, and @code{spam-check-stat} spam back ends, you should also set the variable @code{nnimap-split-download-body} to -@code{t}. These spam back ends are most useful when they can ``scan'' -the full message body. By default, the nnimap back end only retrieves -the message headers; @code{nnimap-split-download-body} tells it to -retrieve the message bodies as well. We don't set this by default -because it will slow @acronym{IMAP} down, and that is not an -appropriate decision to make on behalf of the user. @xref{Client-Side -IMAP Splitting}. +@code{t}. @xref{Client-Side IMAP Splitting}. You have to specify one or more spam back ends for @code{spam-split} to use, by setting the @code{spam-use-*} variables. @xref{Spam Back |