@c %**end of header
@documentlanguage en
@documentencoding us-ascii
-@set VERSION 2.3.0
+@include version.texi
@synindex pg cp
@finalout
@c permissions text appears in an Info file before the first node.
@ifinfo
-This file documents Wanderlust,
-Yet another message interface on Emacsen.
+This file documents Wanderlust, Yet another message interface on
+Emacsen.
-Copyright @copyright{} 1998, 1999, 2000 @w{Yuuichi Teranishi},
-@w{Fujikazu Okunishi}, @w{Masahiro Murata},
-@w{Kenichi Okada}, @w{Kaoru Takahashi},
-@w{Bun Mizuhara} and @w{Masayuki Osada}.
+Copyright @copyright{} 1998, 1999, 2000, 2001 @w{Yuuichi Teranishi},
+@w{Fujikazu Okunishi}, @w{Masahiro Murata}, @w{Kenichi Okada},
+@w{Kaoru Takahashi}, @w{Bun Mizuhara} and @w{Masayuki Osada}.
This edition is for Wanderlust version @value{VERSION}.
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
@ignore
Permission is granted to process this file through TeX and print the
-results, provided the printed document carries copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
+results, provided the printed document carries copying permission notice
+identical to this one except for the removal of this paragraph (this
+paragraph not being relevant to the printed manual).
@end ignore
Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the entire
-resulting derived work is distributed under the terms of a permission
-notice identical to this one.
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1998, 1999, 2000 @w{Yuuichi Teranishi},
-@w{Fujikazu Okunishi}, @w{Masahiro Murata},
-@w{Kenichi Okada}, @w{Kaoru Takahashi},
-@w{Bun Mizuhara} and @w{Masayuki Osada}.
+Copyright @copyright{} 1998, 1999, 2000, 2001 @w{Yuuichi Teranishi},
+@w{Fujikazu Okunishi}, @w{Masahiro Murata}, @w{Kenichi Okada},
+@w{Kaoru Takahashi}, @w{Bun Mizuhara} and @w{Masayuki Osada}.
This manual is for Wanderlust version @value{VERSION}.
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the entire
-resulting derived work is distributed under the terms of a permission
-notice identical to this one.
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.
Wanderlust:
@itemize @bullet
-@item UW imapd 4.1--4.7, 4.7a, 4.7b, 4.7c
-@item Cyrus imapd 1.4, 1.5.19, 1.6.22, 2.0.5
+@item UW imapd 4.1--4.7, 4.7a, 4.7b, 4.7c, 2000 or later
+@item Cyrus imapd 1.4, 1.5.19, 1.6.22--1.6.24, 2.0.5 or later
+@item Courier-IMAP 1.3.2 or later
@item AIR MAIL (AIRC imapd release 2.00)
@item Express Mail
@item Microsoft Exchange Server 5.5
-@item Sun Internet Mail Server 4.0
+@item Sun Internet Mail Server 3.5, 3.5.alpha, 4.0
@end itemize
-@c LDAP connectivity with following LDAPd are confirmed to work with
-@c Wanderlust:
+LDAP connectivity with following LDAPd are confirmed to work with
+Wanderlust:
+
+@itemize @bullet
+@item OpenLDAP 2.0.6 or later
+@end itemize
@node Start Me Up, Folders, Introduction, Top
SEMI or tm must be installed to make Wanderlust work correctly.
-SEMI does not run on Emacs19.28 or earlier
+SEMI does not run on Emacs 19.28 or earlier
@footnote{SEMI runs on Emacs 19.34. @*
@uref{http://www.jpl.org/elips/INSTALL-SEMI-ja.html} describes how to.},
so you must install tm, the predecessor of SEMI. (tm version 8.7 or later
@end group
@end example
-You have to install APEL, FLIM and SEMI in this order.
-Generally @samp{make install} will do the job.
-(In XEmacs 21, @samp{make install-package}.)
+You have to install APEL, FLIM and SEMI in this order. Generally,
+@samp{make install} will do the job. (In XEmacs 21, @samp{make
+install-package}.)
Recommended combination of APEL, FLIM and SEMI are following:
@itemize @minus
-@item APEL 10.2, FLIM 1.13.2 and SEMI 1.13.7
+@item APEL 10.3, FLIM 1.14.2 and SEMI 1.14.3
@end itemize
You can also use many other FLIM/SEMI variants. Combination of the
-latest versions should work. For example, following combination is
+latest versions should work. For example, the following combination are
confirmed to work.
@itemize @minus
@item APEL 10.2, SLIM 1.14.3, EMY 1.13.9
@end itemize
-@c You have to re-install Wanderlust
-@c if you upgraded APEL, FLIM, SEMI or tm.
+You have to re-install Wanderlust if you upgraded APEL, FLIM, SEMI or
+tm.
+
@node Download, Install, MIME Modules, Start Me Up
@section Download and Extract the Package
http://www.ring.gr.jp/archives/text/elisp/wl/
ftp://ftp.ring.gr.jp/pub/text/elisp/wl/
ftp://opaopa.org/pub/mirror/elisp/wl/
+@c ftp://roguelife.org/pub/tsumura/wl/
@end group
@end example
SSL (Secure Socket Layer) can be used for
SMTP, IMAP, NNTP and POP connections in Wanderlust.
-There are two ways to use SSL. One is to start SSL negotiation just after
-the connection establishment (generic way).
-The other one is to start SSL negotiation by invoking STARTTLS command in
-the each session.
+There are two ways to use SSL. One is to start SSL negotiation just
+after the connection establishment (generic way). The other one is to
+start SSL negotiation by invoking STARTTLS command in the each session.
-To use the formar SSL (generic SSL), you must install @file{ssl.el} in
+To use the formal SSL (generic SSL), you must install @file{ssl.el} in
the @file{utils} directory. OpenSSL command @command{openssl} is also
-required to use @file{ssl.el}. You must set PATH to the directory that
-OpenSSL commands are installed.
+required to use @file{ssl.el}. You must set @env{PATH} to the directory
+that OpenSSL commands are installed.
To use the latter SSL(STARTTLS), you must install starttls package in
addition to above.
and SEMI to environmental variable @env{EMACSLOADPATH}, or define
@code{load-path} in @file{WL-CFG} in extracted directory.
-If you want to use BBDB, then the necessary modules are byte-compiled and
-installed when BBDB directory is added to @code{load-path}.
+If you want to use BBDB, then the necessary modules are byte-compiled
+and installed when BBDB directory is added to @code{load-path}.
@xref{BBDB}.
@subsection @file{WL-CFG}
(autoload 'wl "wl" "Wanderlust" t)
(autoload 'wl-draft "wl-draft" "Write draft with Wanderlust." t)
-;; @r{Directory where icons are placed (XEmacs or Emacs 21). Default value
-;; is @code{nil}.}
+;; @r{Directory where icons are placed (XEmacs or Emacs 21).}
+;; @r{Default: @code{nil}.}
;; @r{(This is not required if Wanderlust is installed as XEmacs package)}
(setq wl-icon-dir "~/work/wl/etc")
;; @r{SMTP server for mail posting. Default: @code{nil}}
-(setq wl-smtp-posting-server "your.smtp.server.com")
+(setq wl-smtp-posting-server "your.smtp.example.com")
;; @r{NNTP server for news posting. Default: @code{nil}}
-(setq wl-nntp-posting-server "your.nntp.server.com")
+(setq wl-nntp-posting-server "your.nntp.example.com")
@end group
@end lisp
# @r{Format of each line:}
# @var{email-address} "@var{nickname} "@var{realname}"
#
-teranisi@@gohome.org "Yuuichi" "Yuuichi Teranishi"
-foo@@bar.gohome.org "Mr. Foo" "John Foo"
-bar@@foo.gohome.org "Mr. Bar" "Michael Bar"
+teranisi@@gohome.org "YT" "Yuuichi Teranishi"
+foo@@example.com "Mr. Foo" "John Foo"
+bar@@example.org "Mr. Bar" "Michael Bar"
@end group
@end example
If you use LDAP, you have to set @code{wl-ldap-server},
@code{wl-ldap-port} and @code{wl-ldap-base} properly. If your emacs does
not have LDAP feature as built-in feature (Currently only XEmacs can
-have built-in LDAP feature), you have to set command exec PATH to the
-program @command{ldapsearch}.
+have built-in LDAP feature), you have to set command exec @env{PATH} to
+the program @command{ldapsearch}.
@node Folder Definition, Start Wanderlust, Mail Addresses, Start Me Up
@section Folder Definition
You can skip this section because it is possible to add/edit the
subscribe folders from the buffer for list of folders.
+@xref{Folder Manager}.
Define the folders you want to subscribe in file @file{~/.folders}. The
contents written in @file{~/.folders} become the folders which you
%inbox "Inbox"
+trash "Trash"
+draft "Drafts"
-%#mh/Backup@@my.imap.server.com "Sent"
+%#mh/Backup@@my.imap.example.com "Sent"
# Folder Group
Emacsen@{
%#mh/spool/wl "Wanderlust ML"
%#mh/spool/elips "ELIPS ML"
- %#mh/spool/tm-ja "tm Japanese ML"
+ %#mh/spool/apel-ja "APEL Japanese ML"
%#mh/spool/xemacs-beta "XEmacs beta"
- -fj.news.reader.gnus@@other.nntp.server.com "Gnus Net news"
+ -fj.news.reader.gnus@@other.nntp.example.com "Gnus Net news"
*-fj.editor.xemacs,-fj.editor.mule,-fj.editor.emacs "fj's Emacsen"
@}
#
You can specify @code{login} (encoded password transmission),
@code{cram-md5} (CRAM-MD5 authentication), @code{digest-md5} (DIGEST-MD5
-authentication) or @code{plain} (or @code{nil}, plain password
+authentication) or @code{clear} (or @code{nil}, plain password
transmission) as @var{authenticate-type}. (To use CRAM-MD5 or
-DIGEST-MD5 authentication, you must install @file{utils/sasl} package.)
+DIGEST-MD5 authentication, you must install @file{utils/sasl} package if FLIM version is earlier than 1.14.0. If FLIM version is 1.14.0 or later, you need not install @file{utils/sasl})
default:
For example, you can specify a folder as @samp{foo%imap@@gateway} even
if you have to go through a firewall.
-SSL (Secure Socket Layer) connection will be used if a folder name
-ends with @samp{!}. Or, if the value of @code{elmo-default-imap4-ssl} is non-nil,
-SSL will be the default connection.
-If a folder name ends with @samp{!!}, STARTTLS connection will be established.
-If the value of @code{elmo-default-imap4-ssl} is 'starttls,
+@lisp
+;; Example: imap4.exaple.org as main IMAP server
+(setq elmo-default-imap4-server "imap4.example.org")
+@end lisp
+
+SSL (Secure Socket Layer) connection will be used if a folder name ends
+with @samp{!}. Or, if the value of @code{elmo-default-imap4-stream-type}
+is @code{ssl}, SSL will be the default connection. If a folder name
+ends with @samp{!!}, STARTTLS connection will be established. If the
+value of @code{elmo-default-imap4-stream-type} is @code{starttls},
STARTTLS will be the default connection.
+@lisp
+;; Example: Use SSL connection
+(setq elmo-default-imap4-stream-type 'ssl)
+@end lisp
+
If you specify @code{login}, @code{cram-md5} or @code{digest-md5} as
authentication method, the password is sent in encoded form. But, if
your server is unable to receive an encoded password, authentication
-will fall back to @code{plain} (that is, sending password in raw format)
+will fall back to @code{clear} (that is, sending password in raw format)
after confirmation to user. If @code{elmo-imap4-force-login} is non-nil,
-authentication will fall back to @code{plain} without confirmation
+authentication will fall back to @code{clear} without confirmation
(default value is @code{nil}).
+@lisp
+;; Example: password in raw format
+(setq elmo-default-imap4-authenticate-type 'clear)
+@end lisp
+
Example:
@example
%#mh/inbox -> IMAP mailbox "#mh/inbox"
%inbox:hoge -> IMAP mailbox "inbox" of user "hoge".
-%inbox:hoge/login@@server1
+%inbox:hoge/clear@@server1
-> server1's IMAP mailbox "inbox"
of user "hoge", with plain password authentication
- ('plain).
+ ('clear).
@end group
@end example
@end example
AUTHINFO is used as authentication method if the @var{username} is non-nil.
-SSL will be default method if @code{elmo-default-nntp-ssl} is non-nil even
+SSL will be default method if @code{elmo-default-nntp-stream-type} is non-nil even
if the folder name doesn't end with @samp{!}.
If a folder name ends with @samp{!!}, STARTTLS connection will be established.
-if the value of @code{elmo-default-nntp-ssl} is @code{starttls},
+if the value of @code{elmo-default-nntp-stream-type} is @code{starttls},
STARTTLS will be the default connection.
Example:
@example
@group
--fj.rec.tv -> Newsgroup `fj.rec.tv'.
--fj.rec.tv@@newsserver -> Newsgroup `fj.rec.tv' on newsserver.
+-fj.rec.tv -> Newsgroup @samp{fj.rec.tv}.
+-fj.rec.tv@@newsserver -> Newsgroup @samp{fj.rec.tv} on @samp{newsserver}.
@end group
@end example
@end group
@end example
-To use apop as an @var{authenticate-type}, @file{md5.el} is needed
-(XEmacs doesn't need @file{md5.el}).
-@file{md5.el} is included in @file{utils/sasl/lisp/} or Emacs/W3 package:
-
-@example
-http://www.cs.indiana.edu/elisp/w3/docs.html
-@end example
-
-or LCD archive (GPL2).
+To use APOP as an @var{authenticate-type}, @file{md5.el} is needed
+(XEmacs doesn't need @file{md5.el}). @file{md5.el} is included in
+@file{utils/sasl/lisp/} or Emacs/W3 package
+(@uref{http://www.cs.indiana.edu/elisp/w3/docs.html}) or LCD archive
+(GPL2).
-If the last character of the folder name is @samp{!}, Wanderlust connects to
-the POP server via SSL (Secure Socket Layer). If you set non-nil
-value to @code{elmo-default-pop-ssl}, you don't have to put @samp{!} in the
-end of the folder name to use SSL.
-If a folder name ends with @samp{!!}, STARTTLS connection will be established.
-if the value of @code{elmo-default-pop-ssl} is @code{starttls},
-STARTTLS will be the default connection.
+If the last character of the folder name is @samp{!}, Wanderlust
+connects to the POP server via SSL (Secure Socket Layer). If you set
+non-nil value to @code{elmo-default-pop3-stream-type}, you don't have to put
+@samp{!} in the end of the folder name to use SSL. If a folder name ends
+with @samp{!!}, STARTTLS connection will be established. if the value
+of @code{elmo-default-pop3-stream-type} is @code{starttls}, STARTTLS will be the
+default connection.
@node Multi Folder, Filter Folder, POP Folder, Folders
@section Multi Folder
@end example
After @samp{*} character, specify multiple folders you want to collect
-separated by ',' like
+separated by @samp{,} like
@samp{@var{folder-1},@var{folder-2},@dots{},@var{folder-N}}.
Example:
|&username@@popserver|+inbox
@end example
+@noindent
and access to it, messages are downloaded automatically from
-&username@@popserver to @samp{+inbox}.
+@samp{&username@@popserver} to @samp{+inbox}.
Example:
the message is removed. If you append messages to this folder, the
message will have @samp{$} mark.
+(Can't remove important mark @samp{$} on IMAP server from @samp{'mark}
+folder. If you want IMAP folder's message remove from @samp{'mark}
+folder, remove important mark at IMAP Folder.)
+
You can access to the cached messages fetched via network by accessing
to the folders named @samp{'cache/00} - @samp{'cache/1F}. 00 - 1F are
the name of the subdirectories of the cache directory
@item W
@kindex W (Folder)
-@findex wl-folder-write-current-newsgroup
-If the current cursor point is on the NNTP folder,
-create a new draft message which already has newsgroups field.
-(@code{wl-folder-write-current-newsgroup})
+@findex wl-folder-write-current-folder
+If the current cursor point is on the NNTP folder, create a new draft
+message which already has @samp{Newsgroups:} field. If the current
+cursor point is on the folder for mailing list (refile destination),
+create a new draft message which already has @samp{To:} field with
+guessed mailing list adderss (If @code{wl-subscribed-mailing-list} is
+valid list).
+(@code{wl-folder-write-current-folder})
@item C-c C-o
@kindex C-c C-o (Folder)
Moreover, if @code{wl-fldmgr-cut} or @code{wl-fldmgr-cut-region} is
executed in the access group, they have a same effect with
@code{wl-fldmgr-unsubscribe} and @code{wl-fldmgr-unsubscribe-region}.
-The difference is that cut(-region) commands deletes folders from the
-current buffer.
+The difference is that cut commands deletes folders from the current
+buffer.
@subsubsection Operations in the Access Group
@menu
* Usage of Summary Mode:: TIPS.
-* Thread Oparations:: Thread oparations.
+* Thread Operations:: Thread operations.
* Cache:: File cache, Buffer cache, and Prefetch.
* Auto Refile:: Auto refile settings.
* Sticky Summary:: Summary make sticky.
@end menu
-@node Usage of Summary Mode, Thread Oparations, Summary, Summary
+@node Usage of Summary Mode, Thread Operations, Summary, Summary
@section Usage (Tips)
@subsection Summary Content
To operate multipart, you have to enter to the message buffer.
@xref{Message}.
+@subsection Pack the Message Numbers
+You can pack the message numbers in Summary by
+@kbd{M-x wl-summary-pack-number}. Note that only MH Folder,
+News Spool Folder and Maildir Folder are supported folder types.
+
-@node Thread Oparations, Cache, Usage of Summary Mode, Summary
+@node Thread Operations, Cache, Usage of Summary Mode, Summary
@section Thread Operations
For example, the following line indicates one thread (a context of a topic).
If you type @kbd{/} key once again, the thread is closed.
With prefix argument, @kbd{/} opens all children threads.
+If you type @kbd{[}, opens all threads in summary. @kbd{]} closes all
+threads.
+
Commands with the key binding that begins with @kbd{t} executes commands
on the messages in the thread.
+@xref{Key Bindings of Summary}.
+
+@subsection reconstruct thread by hand
+
+You can reconstruct the thread manually. In Summary, @kbd{M-w}
+(@code{wl-summary-save-current-message}) at the corresponding message,
+and @kbd{C-y} (@code{wl-summary-yank-saved-message}) at the new parent
+message then you have the reconstructed thread.
-@node Cache, Auto Refile, Thread Oparations, Summary
+@node Cache, Auto Refile, Thread Operations, Summary
@section Cache
@subsection Cache File
@findex wl-summary-down
Move cursor to the downward message which is unread or marked
as @samp{$}.
+In the offline mode, cursor is not moved to the messages which are not cached
+yet.
+If there are messages which have target mark @samp{*} in the summary,
+cursor is moved to the downward message which have a target mark.
+This behavior is changed according to the value of @code{wl-summary-move-order}.
(@code{wl-summary-down})
@item P
@findex wl-summary-up
Move cursor to the upward message which is unread or marked
as @samp{$}.
+In the offline mode, cursor is not moved to the messages which are not cached
+yet.
+If there are messages which have target mark @samp{*} in the summary,
+cursor is moved to the downward message which have a target mark.
+This behavior is changed according to the value of @code{wl-summary-move-order}.
(@code{wl-summary-up})
@item w
@item W
@kindex W (Summary)
-@findex wl-summary-write-current-newsgroup
-Prepare a new draft. If the current folder is netnews folder,
-@samp{Newsgroups:} field is completed.
-(@code{wl-summary-write-current-newsgroup})
+@findex wl-summary-write-current-folder
+Prepare a new draft. If the current folder is NNTP folder,
+@samp{Newsgroups:} field is completed. If the current folder is mailing
+list folder (refile destination), guess @samp{To:} field and completed
+(If @code{wl-subscribed-mailing-list} is valid list)
+(@code{wl-summary-write-current-folder})
@item H
@kindex H (Summary)
moved to one after another. If prefix argument is specified, load draft
folder's message to the draft buffer and jump to it.
(@code{wl-jump-to-draft-buffer})
+
+@item M-w
+@kindex M-w (Summary)
+@findex wl-summary-save-current-message
+Save the message at the current cursor point.
+(@code{wl-summary-save-current-message})
+
+@item C-y
+@kindex C-y (Summary)
+@findex wl-summary-yank-saved-message
+Regard the message at the current cursor point as
+parent, connect the message saved by
+@code{wl-summary-save-current-message}
+to the thread.
+(@code{wl-summary-yank-saved-message})
@end table
@code{wl-summary-jump-to-msg-by-message-id-via-nntp} and search message
from the NNTP server @code{elmo-default-nntp-server}. The value of
@code{elmo-default-nntp-user}, @code{elmo-default-nntp-port},
-@code{elmo-default-nntp-ssl} are used.
+@code{elmo-default-nntp-stream-type} are used.
If @code{confirm}, server name can be specified. You can specify NNTP
folder format like @samp{-:username@@servername:119!}.
Initial setting is @code{'(1 . 4)}. It is a cons cell and the ratio of
its car and cdr value corresponds to the ratio of Summary and Message
windows.
+@item wl-message-ignored-field-list
+@vindex wl-message-ignored-field-list
+(SEMI only) Initial setting is nil.
+All fields that match this list will be hidden in message buffer.
+Each elements are regexp of field-name.
+If nil, the value of mime-view-ignored-field-list is used.
+@item wl-message-visible-field-list
+@vindex wl-message-visible-field-list
+(SEMI only) Initial setting is nil.
+All fields that match this list will be hidden in message buffer.
+Each elements are regexp of field-name. This value precedes
+wl-message-ignored-field-list.
+If nil, the value of mime-view-visible-field-list is used.
+@item wl-message-sort-field-list
+@vindex wl-message-sort-field-list
+(SEMI only) Initial setting is
+'("Return-Path" "Received" "^To" "^Cc" "Newsgroups" "Subject" "^From").
+Header fields in message buffer are orderd by this value.
+Each elements are regexp of field-name.
@end table
-
@node Draft, Disconnected Operations, Message, Top
@chapter Draft Buffer
@lisp
@group
(setq wl-draft-config-alist
- '(((string-match "aaa.ne.jp$" (system-name))
+ '(((string-match "aaa.example.com$" (system-name))
;; @r{applied if the expression is non-nil}
(wl-smtp-posting-server . "mailserver-B")
(wl-nntp-posting-server . "newsserver-B")
;; @r{settings of temporary variables}
)
- ("^To: .*user@@aaa.bbb.com"
+ ("^To: .*user@@aaa.bbb.example.com"
;; @r{applied if it matches the header of the draft buffer}
("Organization" . (format "Go %s" my-webpage)))
;; @r{you can write elisp expressions here (eval only)}
@example
@group
-'(("@var{regexp of the header}" or elisp expression
- ("@var{Field}" . value(elisp expression))
- (@var{variable} . value(elisp expression))
- (@var{sub-function} . value(elisp expression))
+'(("@var{regexp of the header}" or @var{elisp expression}
+ ("@var{Field}" . value(@var{elisp expression}))
+ (@var{variable} . value(@var{elisp expression}))
+ (@var{sub-function} . value(@var{elisp expression}))
@var{function}
@dots{})
- ("@var{regexp of the header}" or elisp expression
- ("@var{Field}" . value(elisp expression))
+ ("@var{regexp of the header}" or @var{elisp expression}
+ ("@var{Field}" . value(@var{elisp expression}))
@dots{}))
@end group
@end example
'top: Inserts the specified string at the top of the body.
'top-file: Inserts the specified file at the top of the body.
'body: Replaces the body with the specified string.
- Specifying nil deletes the entire body string.
+ Specifying @code{nil} deletes the entire body string.
'body-file: Replaces the body with the content of the specified file.
'bottom: Inserts the specified string at the bottom of the body.
'bottom-file: Inserts the specified file at the top of the body.
easily find how to write the functions.
At the first of each item, @var{a regular expression of the header} or
-an elisp expression should be specified. In the case of an elisp
+an @var{elisp expression} should be specified. In the case of an elisp
expression, the item is applied when the expression is evaluated
non-nil.
@code{wl-draft-send-and-exit} or @code{wl-draft-send} is invoked.
Therefore, if you want to apply @code{wl-draft-config-alist} again after
aborting transmission, execute @kbd{C-c C-e}
-(@code{wl-draft-config-exec}).
+(@code{wl-draft-config-exec}) explicitly.
+
+If you don't want to apply @code{wl-draft-config-alist} when
+@code{wl-draft-send-and-exit} or @code{wl-draft-send} is invoked,
+do the following:
+
+@lisp
+(remove-hook 'wl-draft-send-hook 'wl-draft-config-exec)
+@end lisp
If you want to apply @code{wl-draft-config-alist} when a draft buffer is
prepared, do the following:
(add-hook 'wl-mail-setup-hook 'wl-draft-config-exec)
@end lisp
+If you want to apply @code{wl-draft-config-alist} when you re-edit a mail
+from summary mode by typing @kbd{E}(@code{wl-summary-reedit}), do the
+following:
+
+@lisp
+(add-hook 'wl-draft-reedit-hook 'wl-draft-config-exec)
+@end lisp
+
@subsection Inserting Templates
@cindex Template
@cindex Apply Template
(body . "Hello.\n"))
("report"
(template . "default") ;; @r{(a)}
- ("To" . "jousi@@kaisha.jp")
+ ("To" . "boss@@example.com")
("Subject" . "Report")
(body-file . "~/work/report.txt")
)
The POP port number for POP-before-SMTP authentication.
If unset, @code{elmo-default-pop3-port} is used.
-@item wl-pop-before-smtp-ssl
+@item wl-pop-before-smtp-stream-type
If non-nil, POP connection is established using SSL. If
@code{starttls}, STARTTLS (RFC2595) connection will be established. If
-unset, @code{elmo-default-pop3-ssl} is used.
+unset, @code{elmo-default-pop3-stream-type} is used.
@end table
If variables for POP-before-SMTP (@code{wl-pop-before-smtp-*}) are
automatically re-filed, the destination folder will be leaned in
connection with the address.
+Example:
+
+@lisp
+@group
+(setq wl-subscribed-mailing-list
+ '("wl@@lists.airs.net"
+ "apel-ja@@m17n.org"
+ "emacs-mime-ja@@m17n.org"))
+@end group
+@end lisp
+
@item wl-insert-mail-followup-to
@vindex wl-insert-mail-followup-to
The initial setting is @code{nil}. If non-nil, @samp{Mail-Followup-To:}
@vindex wl-message-id-domain
The initial setting is @code{nil}. If non-nil, this value is used as a
domain part of the @samp{Message-ID:}. If your terminal does not have
-global IP, set unique string to this value (e.x. your e-mail address).
+global IP address, set unique string to this value (e.x. your e-mail
+address).
@item wl-message-id-domain
@vindex wl-message-id-domain
@item wl-draft-use-cache
@vindex wl-draft-use-cache
-The initial setting is @code{t}.
-If non-nil, cache the message which is sent.
+The initial setting is @code{nil}. If the value is non-nil and
+@code{wl-insert-message-id} is non-nil, cache the message which is sent.
@item wl-auto-flush-queue
@vindex wl-auto-flush-queue
(with confirmation by @code{y-or-n-p}). If you want to transmit it
manually, press @kbd{F} in the folder mode.
+@item wl-ignored-forwarded-headers
+@vindex wl-ignored-forwarded-headers
+Initial setting is @samp{\\(received\\|return-path\\|x-uidl\\)}.
+All headers that match this regexp will be deleted when forwarding a message.
+
+@item wl-ignored-resent-headers
+Initial setting is @samp{\\(return-receipt\\|[bdf]cc\\)}.
+All headers that match this regexp will be deleted when resending a message.
+
@item wl-draft-always-delete-myself
@vindex wl-draft-always-delete-myself
If non-nil, always removes your own address from @samp{To:} and
@samp{Cc:} when you are replying to the mail addressed to you.
+@item wl-draft-delete-myself-from-bcc-fcc
+@vindex wl-draft-delete-myself-from-bcc-fcc
+If any of @code{wl-subscribed-mailing-list} are contained in @samp{To:}
+or @samp{Cc:} field, do not insert @samp{Bcc:} or @samp{FCC:} field.
+
@item wl-smtp-posting-server
@vindex wl-smtp-posting-server
The initial setting is @code{nil}.
This is the port number of the NNTP server used for news submission.
If @code{nil}, @code{elmo-default-nntp-server} is used.
-@item wl-nntp-posting-ssl
-@vindex wl-nntp-posting-ssl
+@item wl-nntp-posting-stream-type
+@vindex wl-nntp-posting-stream-type
The initial setting is @code{nil}.
-If @code{nil}, @code{elmo-default-nntp-ssl} is evaluated. If non-nil,
+If @code{nil}, @code{elmo-default-nntp-stream-type} is evaluated. If non-nil,
SSL is used for news submission. If @code{starttls}, STARTTLS (RFC2595)
connection will be established.
This is the POP port number for POP-before-SMTP. If it is @code{nil},
@code{elmo-default-pop3-port} is used.
-@item wl-pop-before-smtp-ssl
-@vindex wl-pop-before-smtp-ssl
+@item wl-pop-before-smtp-stream-type
+@vindex wl-pop-before-smtp-stream-type
The initial setting is @code{nil}.
This flag controls the use of SSL for POP-before-SMTP. If it is
-@code{nil}, @code{elmo-default-pop3-ssl} is used. If @code{starttls},
+@code{nil}, @code{elmo-default-pop3-stream-type} is used. If @code{starttls},
STARTTLS (RFC2595) connection will be established.
@item wl-draft-queue-save-variables
(it is written even if the transmission fails).
But transmission by @file{im-wl.el} is not written in the @file{sendlog}
-and left to the logging function of imput.
+and left to the logging function of @command{imput}.
@item wl-draft-sendlog-max-size
@vindex wl-ldap-base
The initial setting is @samp{c=US}.
LDAP search starting point (base) for address completion.
+
+@item wl-draft-remove-group-list-contents
+@vindex wl-draft-remove-group-list-contents
+The initial setting is @code{t}.
+If non-nil, remove the group-lists' members in the recipients when
+sending the message (group-list means the description such as
+@samp{Group: foo@@gohome.org, bar@@gohome.org;} in the recipients).
@end table
@node Disconnected Operations, Expire and Archive, Draft, Top
@menu
* Off-line State:: Wanderlust has on-line and off-line states.
-* Enable Operations:: Enable Disconeected Oparations.
+* Enable Operations:: Enable Disconeected Operations.
* Plugged Mode:: Switching On-line/Off-line per Server/Port.
* Off-line State settings:: Invoking Wanderlust in the Off-line State.
* Variables of Plugged Mode:: Customize Plugged Mode.
@node Enable Operations, Plugged Mode, Off-line State, Disconnected Operations
-@section Enable Disconeected Oparations
+@section Enable Disconeected Operations
Even in the off-line state, provided that relevant messages are cached,
and the variable @code{elmo-enable-disconnected-operation} (described
-later) is non-nil, you can following oparations:
+later) is non-nil, you can following operations:
@xref{Plugged Mode}, @xref{Off-line State settings}.
@menu
@item @code{remove}
deletes the messages instantly.
+@item @code{hide}
+hide the messages from summary (messages are not deleted).
+
@item @code{trash}
moves the messages to @code{wl-trash-folder}.
* mu-cite:: mu-cite.el
* x-face-mule:: x-face-mule.el
* dired-dd:: dired-dd.el
+* MHC:: MHC
@end menu
Place @file{util/im-wl.el} on the @code{load-path} and do the following
settings.
-If imput is on the @code{exec-path} at the installation, @file{im-wl.el}
-is byte-compiled and installed.
-@xref{Install}.
+If @command{imput} is on the @code{exec-path} at the installation,
+@file{im-wl.el} is byte-compiled and installed. @xref{Install}.
@lisp
@group
@group
(setq wl-highlight-x-face-func
(function
- (lambda (beg end)
- (x-face-mule:x-face-decode-message-header))))
+ (lambda (&optional beg end)
+ (x-face-mule:x-face-decode-message-header))))
+(require 'x-face-mule)
@end group
@end lisp
@group
(setq wl-highlight-x-face-func
(function
- (lambda (beg end)
- (x-face-mule-x-face-decode-message-header))))
+ (lambda (&optional beg end)
+ (x-face-mule-x-face-decode-message-header))))
(require 'x-face-mule)
@end group
@end lisp
@code{wl-auto-insert-x-face} is non-nil).
-@node dired-dd, , x-face-mule, Living with other packages
+@node dired-dd, MHC, x-face-mule, Living with other packages
@subsection dired-dd(Dired-DragDrop)
@pindex Dired-DragDrop
@pindex Dired-DD
@end group
@end lisp
+@node MHC, , dired-dd, Living with other packages
+@subsection mhc.el
+@pindex MHC
+
+Message Harmonized Calendaring system
+(@uref{http://www.quickhack.net/mhc/})
+
+By using MHC, you can make a calendar from the messages.
+
+For mhc-0.25:
+
+@lisp
+@group
+(setq mhc-mailer-package 'wl)
+(autoload 'mhc-mode "mhc" nil t)
+(add-hook 'wl-summary-mode-hook 'mhc-mode)
+(add-hook 'wl-folder-mode-hook 'mhc-mode)
+@end group
+@end lisp
+
+For mhc-current:
+
+@lisp
+@group
+(autoload 'mhc-wl-setup "mhc-wl")
+(add-hook 'wl-init-hook 'mhc-wl-setup)
+@end group
+@end lisp
@node Highlights, Biff, Living with other packages, Customization
@section Highlights
@item wl-summary-partial-highlight-above-lines
@vindex wl-summary-partial-highlight-above-lines
-The initial setting is 30.
-If there are more lines of messages than
+The initial setting is 30. If there are more lines of messages than
@code{wl-summary-highlight-partial-threshold} in the summary, messages
after the point that is the same number of lines as this value above the
-cursor line are highlighted partially.
-(If this value is nil, the last same number of lines as the value of
+cursor line are highlighted partially. (If this value is @code{nil},
+the last same number of lines as the value of
@code{wl-summary-highlight-partial-threshold} are highlighted.)
@item wl-highlight-body-too
Bodies matching to this regular expression are highlighted by the face
specified by @code{wl-highlight-message-headers}.
+@item wl-highlight-max-header-size
+@vindex wl-highlight-max-header-size
+The initial setting is @code{nil}. If a header size is larger than this
+value, it will not be highlighted. If @code{nil}, always highlighted
+(ignore header size).
+
@item wl-highlight-max-message-size
@vindex wl-highlight-max-message-size
The initial setting is 10000.
The face for headers of quoted messages.
@item wl-highlight-message-cited-text-*
-The face for texts of quoted messages.
-The last @samp{*} is a single figure so that 10 different colors can be used
-according to citation levels.
+The face for texts of quoted messages. The last @samp{*} is a
+@var{single figure} so that 10 different colors can be used according to
+citation levels.
@item wl-highlight-message-signature
-The face for signatures of messages.
-The initial settings are khaki for light background colors, and
-DarkSlateBlue for dark background colors.
+The face for signatures of messages. The initial settings are
+@samp{khaki} for light background colors, and @samp{DarkSlateBlue} for
+dark background colors.
@item wl-highlight-header-separator-face
The face for header separators of draft messages.
@item wl-highlight-folder-opened-face
The face for open groups in the folder mode.
-It is meaningful when @code{wl-highlight-group-folder-by-numbers} is
-@code{nil} or a number.
+It is meaningful when @code{wl-highlight-folder-by-numbers} is
+@code{nil} or a @var{number}.
@item wl-highlight-folder-closed-face
The face for close groups in the folder mode.
-It is meaningful when @code{wl-highlight-group-folder-by-numbers} is
-@code{nil} or a number.
+It is meaningful when @code{wl-highlight-folder-by-numbers} is
+@code{nil} or a @var{number}.
@item wl-highlight-folder-path-face
The face for the path to the currently selected folder in the folder
@vindex wl-biff-check-interval
The initial setting is 40 (in seconds).
Check mail arrival in this period.
+
+@item wl-biff-notify-hook
+@vindex wl-biff-notify-hook
+The initial setting is @code{nil}.
+This is a hook run at the arrival of the new mail.
+To beep, set as:
+@lisp
+(setq wl-biff-notify-hook '(beep))
+@end lisp
@end table
@node Draft for Reply, Thread Format, Advanced Settings, Advanced Settings
@subsection Draft for Replay
+@vindex wl-draft-reply-with-argument-list
+@vindex wl-draft-reply-without-argument-list
+@vindex wl-draft-reply-myself-with-argument-list
+@vindex wl-draft-reply-myself-without-argument-list
If you want, when you replying to articles in mailing lists, the address
in Reply-To field of the original message to be prepared to To field of
@end lisp
@noindent
-(Only if there are both of @samp{X-ML-Name} and @samp{Reply-To} fields in the
-original message, @samp{Reply-To} field in the original is copied to @samp{To:}
-field.)
+(Only if there are both of @samp{X-ML-Name:} and @samp{Reply-To:} fields
+in the original message, @samp{Reply-To:} field in the original is
+copied to @samp{To:} field.)
Moreover, the behavior of @kbd{a} with prefix argument can
be directed by @code{wl-draft-reply-with-argument-list} as well.
+Note: To set the behavior when you reply to the message written by yourself, use
+@code{wl-draft-reply-myself-without-argument-list} and
+@code{wl-draft-reply-myself-with-argument-list}
+instead of them.
+
@node Thread Format, User-Agent Field, Draft for Reply, Advanced Settings
@subsection Appearance of Threads
If you are eccentric enough to elaborate @samp{X-Mailer:} or
@samp{User-Agent:} fields, define a function that generate appropriate
-strings as you like, and set it to
+strings as you like, and set it to variable
@code{wl-generate-mailer-string-func}.
If you do not want verbose @samp{User-Agent:} field, do the following:
@lisp
@group
+(setq mime-edit-insert-user-agent-field nil)
(setq wl-generate-mailer-string-func
(function
(lambda ()
@item wl-folder-sync-range-alist
@vindex wl-folder-sync-range-alist
-The initial setting is the list shown below:
+The initial setting is the alist shown below:
@lisp
@group
@end group
@end lisp
+@noindent
This is an associative list of regular expressions of folder names and
update range of the summary. Update range is one of the @samp{all},
@samp{update}, @samp{rescan}, @samp{rescan-noscore}, @samp{first} and
@item wl-folder-mime-charset-alist
@vindex wl-folder-mime-charset-alist
-The initial setting is the list shown below:
+The initial setting is the alist shown below:
@lisp
@group
@item wl-delete-folder-alist
@vindex wl-delete-folder-alist
-The initial setting is the list shown below:
+The initial setting is the alist shown below:
@lisp
@group
one of the following in the place of destination:
@example
-'remove or 'null : deletes the messages instantly.
-string : moves the messages to the specific folder.
-'trash or others : moves the messages to `wl-trash-folder'.
+@code{remove} or @code{null} : deletes the messages instantly.
+string : moves the messages to the specific folder.
+@code{trash} or others : moves the messages to @code{wl-trash-folder}.
@end example
@item wl-refile-policy-alist
@example
# guide
@end example
-Please send bug reports or patches to the mailing list.
-You can post to the mailing list even though you are not a member of it.
+Please send bug reports or patches to the mailing list. You can post to
+the mailing list even though you are not a member of it.
If you send a bug report, please attach Backtrace with it.
-@footnote{@uref{http://www.jpl.org/elips/BUGS-ja.html} describes how to in Japanese.}
+@footnote{@uref{http://www.jpl.org/elips/BUGS-ja.html} describes how to
+in Japanese.}
I would like to express my thanks to the members of the mailing list for
valuable advice and many pieces of code they contributed.
7/11 killed message feature.
7/18 Use UIDL in POP3.
9/12 biff feature with Satata-san & Yamaoka-san.
+ 10/17 expire-hide by Okada-san.
+ 11/08 Released 2.4.0 stable.
@end example
See @file{ChangeLog} for details.
projects / elisp / wanderlust.git / blobdiff