This file documents Wanderlust, Yet another message interface on
Emacsen.
-Copyright @copyright{} 1998, 1999, 2000, 2001 @w{Yuuichi Teranishi},
+Copyright @copyright{} 1998, 1999, 2000, 2001, 2002 @w{Yuuichi Teranishi},
@w{Fujikazu Okunishi}, @w{Masahiro Murata}, @w{Kenichi Okada},
@w{Kaoru Takahashi}, @w{Bun Mizuhara} and @w{Masayuki Osada},
@w{Katsumi Yamaoka}, @w{Hiroya Murata} and @w{Yoichi Nakayama}.
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1998, 1999, 2000, 2001 @w{Yuuichi Teranishi},
+Copyright @copyright{} 1998, 1999, 2000, 2001, 2002 @w{Yuuichi Teranishi},
@w{Fujikazu Okunishi}, @w{Masahiro Murata}, @w{Kenichi Okada},
@w{Kaoru Takahashi}, @w{Bun Mizuhara}, @w{Masayuki Osada},
@w{Katsumi Yamaoka}, @w{Hiroya Murata} and @w{Yoichi Nakayama}.
* Scoring:: Score of the messages
* Address Book:: Management of Address Book
* Customization:: Customizing Wanderlust
+* Terminology:: Terminologies
* Mailing List:: Wanderlust mailing list
* Addition:: Additional Information
* Index:: Key index
@section Environment
-Wanderlust is supposed to run on following Emacsen:
+We confirm Wanderlust works on following Emacsen:
@itemize @bullet
@item Mule 2.3 based on Emacs 19.34
@pindex FLIM
@pindex SEMI
-SEMI must be installed to make Wanderlust work correctly.
+You must install SEMI beforehand to use Wanderlust.
-SEMI can be downloaded from these sites:
+SEMI can be downloaded from following site:
@example
@group
You can read manual at the following URL:
@example
-http://www.gohome.org/wl/doc/wl-euc_toc.html
+http://www.gohome.org/wl/doc/wl_toc.html
@end example
@node Minimal Settings, Folder Definition, Install, Start Me Up
(require 'mime-setup)
;; @r{autoload configuration}
-;; @r{(These are not required if Wanderlust is installed as XEmacs package)}
+;; @r{(Not required if you have installed Wanderlust as XEmacs package)}
(autoload 'wl "wl" "Wanderlust" t)
+(autoload 'wl-other-frame "wl" "Wanderlust on new frame." t)
(autoload 'wl-draft "wl-draft" "Write draft with Wanderlust." t)
;; @r{Directory where icons are placed.}
;; @r{Default: the peculiar value to the running version of Emacs.}
-;; @r{(This is not required if the default value has been set properly)}
+;; @r{(Not required if the default value points properly)}
(setq wl-icon-directory "~/work/wl/etc")
;; @r{SMTP server for mail posting. Default: @code{nil}}
This chapter describes the folder types which Wanderlust is able to handle.
-Wanderlust uses ELMO as it's interface, so every folder types supported
-by ELMO is usable in Wanderlust.
+Wanderlust uses ELMO as it's interface, so you can use every folder types
+supported by ELMO.
As of version @value{VERSION}, 11 types of folders are predefined. These are
IMAP, NNTP, LocalDir(MH), Maildir, News Spool, Archive, POP, Multi, Filter,
$bsd/freebsd;lha -> @file{~/Mail/bsd/freebsd/elmo-archive.lzh}
$/foo@@server:~/bar;zoo -> @file{~/bar/elmo-archive.zoo} on ftp server
$d:/msend.tar.gz;tgz;spool -> @file{d:/msend.tar.gz}
+$ml;zip/ -> Access group consists of archive folders
+ under @file{~/Mail/ml}
@end group
@end example
@example
@group
-@samp{&} [@var{username}][[@samp{/} @var{authenticate-type}][@samp{@@} @var{hostname}][@samp{:} @var{port}]][@samp{!}]
+@samp{&} [@var{username}][[@samp{/} @var{authenticate-type}][@samp{:} @var{numbering-method}][@samp{@@} @var{hostname}][@samp{:} @var{port}]][@samp{!}]
@end group
@end example
@samp{user} (plain password transmission) or @samp{apop} (APOP authentication)
as @var{authenticate-type}.
+You can specify @samp{uidl} (use UIDL command for message numbering) or
+@samp{list} (use LIST command for message numbering) as @samp{numbering-method}.
+
default:
@example
@var{username} -> The value of @code{elmo-pop3-default-user}.
@code{(user-login-name)}.
@var{authenticate-type} -> The value of @code{elmo-pop3-default-authenticate-type}.
Initial setting is @samp{user}.
+@var{numbering-method} -> Follow the value of @code{elmo-pop3-default-use-uidl}.
+ If t, use UIDL for numbering. Initial setting is t.
@var{hostname} -> The value of @code{elmo-pop3-default-server}.
Initial setting is @samp{localhost}.
@var{port} -> The value of @code{elmo-pop3-default-port}.
@end group
@end example
+@subsection Variables About Shimbun Folder
+
+@table @code
+@item elmo-shimbun-update-overview-folder-list
+@vindex elmo-shimbun-update-overview-folder-list
+The initial setting is @code{nil}. You can specify a list of regular
+expressions of shimbun folder names. The overview of matched shimbun
+folder is updated when messages are fetched.
+You should @kbd{s rescan} after fetching to update summary.
+@end table
+
@node Namazu Folder, Multi Folder, Shimbun Folder, Folders
@section Namazu Folder
@end group
@end example
-Tips
+@subsection TIPS
+
+@subsubsection Enter space to separate keywords
If you want to use space in folder entry, @kbd{C-q @key{SPC}} will help you.
+@subsubsection Alias name for index
+
+You can define an alias name for index.
+
+Example:
+
+@example
+(setq elmo-nmz-index-alias-alist
+ '(("cache" . "~/.elmo/cache")
+ ("docs" . "~/documents")))
+@end example
+
+Above definition defines two index aliases.
+You can specify
+
+@example
+[wanderlust]cache
+@end example
+
+to execute a namazu search with keyword @samp{wanderlust} using a index in the
+directory @file{~/.elmo/cache}.
+
+@subsubsection Multiple indices
+
+You can specify a list for @code{elmo-nmz-default-index-path} and
+@code{elmo-nmz-index-alias-alist}.
+When list is specified, all index contained in the list is used as the
+namazu indices.
+
+Example:
+
+@example
+(setq elmo-nmz-index-alias-alist
+ '(("all" . ("~/.elmo/cache" "~/documents"))
+ ("cache" . "~/.elmo/cache")))
+@end example
+
+Using above alias setting, you can specify
+
+@example
+[wanderlust]all
+@end example
+
+to execute a namazu search with keyword @samp{wanderlust} using indices in the
+directory @file{~/.elmo/cache} and @file{~/documents}.
@node Multi Folder, Filter Folder, Namazu Folder, Folders
@section Multi Folder
@end example
@noindent
-and access it, messages are downloaded automatically from
-@samp{&username@@popserver} to @samp{+inbox}.
+and access it, Wanderlust downloads messages from
+@samp{&username@@popserver} to @samp{+inbox} automatically.
On the other hand, if you put @samp{|:} instead of second @samp{|},
then messages are copied to the destination folder (not deleted from
-source-folder). At the next time you access that folder, only new
-messages will be copied.
+source-folder). At the next time you access that folder, copies new
+messages only.
@example
@samp{|} @var{source-folder} @samp{|:} @var{destination-folder}
folder as follows:
@example
-|&username@@popserver|+inbox
+|&username@@popserver|:+inbox
@end example
where messages will be kept on the server.
@kindex @key{RET} (Folder)
@findex wl-folder-jump-to-current-entity
Enter to the summary mode of the folder at the current cursor point.
+With prefix argument, enter the sticky summary.
If the cursor is on the top of folder group line,
the folder group is opened or closed.
When the cursor is on the access group and this command is called
Empty trash.
(@code{wl-folder-empty-trash})
+@item F
+@kindex F (Folder)
+@findex wl-folder-flush-queue
+Flush queue.
+(@code{wl-folder-flush-queue})
+
+@item V
+@kindex V (Folder)
+@findex wl-folder-virtual
+Move to the virtual folder with the condition specified.
+(@code{wl-folder-virtual})
+
+@item ?
+@kindex ? (Folder)
+@findex wl-folder-pick
+Search the folders with the condition specified.
+(@code{wl-folder-pick})
+
@item o
@kindex o (Folder)
@findex wl-folder-open-all-unread-folder
@lisp
@group
-("-" "-alt")
+("^-$" "^-alt$")
@end group
@end lisp
@noindent
-A list of access groups which creates children folder list hierarchically.
+A list of regular expressions for access groups which creates children
+folder list hierarchically.
For example, if you specify
@code{wl-folder-hierarchy-access-folders} like following,
@lisp
@group
(setq wl-folder-hierarchy-access-folders
- '("-" "-alt" "-japan" "-comp" "-comp.unix"))
+ '("^-$" "^-alt$" "^-japan$" "^-comp$" "^-comp.unix$"))
@end group
@end lisp
@noindent
-such access group hierarchy is obtained.
+you obtain the access group hierarchy as follows.
@example
@group
(after you create folder group by typing @kbd{m g}),
firstly open it, then execute append command in the next line.
If it is closed, folder is appended on the same level with
-the above folder group. It is difficult to explain by words so try it.
+the folder group above. It is difficult to explain by words so try it.
In other words, appended position depends on the
-above folder group's open/close status.
+open/close status of the upper one.
@subsubsection Charset of the Folders File.
If non-nil, negative value is displayed when the message is deleted. If
@code{sync}, folder is synchronized when the message is deleted. If
@code{nil}, message deletion is ignored.
+
+@item wl-fldmgr-add-complete-with-current-folder-list
+@vindex wl-fldmgr-add-complete-with-current-folder-list
+The initial setting is @code{nil}.
+Non-nil means call @code{elmo-folder-list-subfolders} and get completion
+candidate for @code{wl-fldmgr-add}.
@end table
@subsection Miscellanea
key (if already exists, the mark is deleted). It is convenient to put
this mark on the messages to remember (If you want to remember to write
a reply for the message, for example) because this mark remains after
-you exited Emacs. Messages with the @samp{$} mark remains in the folder
-even the message itself is deleted in the actual folder.
+you exited Emacs. Messages with the @samp{$} mark can be reviewed in the
+@samp{'mark} folder even the message itself is deleted in the actual folder.
@item None
If the message is read and cached (or local message),there are no
cache. Messages with the marks other than these, you can read them in
the offline status even they are in the IMAP folder or netnews folder.
+Among messages with persistent marks, ones with marks specified by
+@code{wl-summary-expire-reserve-marks} are excluded from the expiration
+(as a function of wanderlust) explained later. @xref{Expire and Archive}.
+
@subsection How To Read
Basically, you can read messages only typing space key again and again.
@vindex wl-message-buffer-prefetch-folder-list
The initial setting is @code{nil}.
A list of regexp of folders to enable message prefetching.
+
+@item wl-message-buffer-prefetch-depth
+@vindex wl-message-buffer-prefetch-depth
+The initial setting is 3. The number of messages for automatical prefetch.
+
+@item wl-message-buffer-prefetch-idle-time
+@vindex wl-message-buffer-prefetch-idle-time
+The initial setting is 0.2 (in seconds). The period of automatical prefetch.
+
+@item wl-message-buffer-prefetch-threshold
+@vindex wl-message-buffer-prefetch-threshold
+The initial setting is 30000 (bytes). If prefetching message has larger
+size than this value, Wanderlust does not prefetch automatically.
+If @code{wl-message-buffer-prefetch-threshold} is @code{nil},
+the message is not checked for the size.
+
+@item wl-auto-prefetch-first
+@vindex wl-auto-prefetch-first
+The initial setting is @code{nil}.
+If non-nil, first message is automatically prefetched to the buffer
+when you enter the folder.
@end table
case, If the field value of the rule and the current rule is matched,
then the current rule is fired (i.e. AND condition).
-In @var{target} part, you can refer matched substring of @var{regexp}.
-To refer substring, specify following in @var{target}:
+You can refer matched substring of @var{regexp} to specify @var{target} part.
+To refer substring, use following keys:
@table @samp
@item \&
("^Wanderlust" . "+wl")
("^Elisp" . "+elisp"))
(("To" "Cc")
- ("\\([a-z]+\\)@@gohome.org" . "+\\1"))
+ ("\\([a-z]+\\)@@gohome\\.org" . "+\\1"))
("From"
- ("me@@gohome.org" . ("To" ("you@@gohome.org" .
+ ("me@@gohome\\.org" . ("To" ("you@@gohome\\.org" .
"+from-me-to-you"))))))
@end group
@end lisp
The buffer of the `sticky summary' does not killed by typing @kbd{q}.
-Sticky buffer is created by entering the summary by typing @kbd{C-u g}
-or type @kbd{M-s} (@code{wl-summary-stick}) on the normal summary.
+By entering the summary by typing @kbd{Shift RET} in Folder mode or
+@kbd{G} in some suummary sticky summary buffer is created.
+Also typing @kbd{M-s} (@code{wl-summary-stick}) on the normal summary
+makes current one sticky.
The buffer name of the sticky summary becomes like
@samp{Summary:@var{folder-name}}.
-
You can visit the sticky summary at any time by @kbd{C-x b}
-(@code{switch-to-buffer}). To exit sticky summary, type @kbd{C-u
-q}. Other operations in the sticky summary are same as normal summary.
+(@code{switch-to-buffer}), or you can go round summary buffers by
+@kbd{C-c C-n} (@code{wl-summary-previous-buffer}) and @kbd{C-c C-p}
+(@code{wl-summary-next-buffer}) in summary mode.
+
+In sticky summary, the summary buffer is preserved after @kbd{g} or
+@kbd{q}. To delete sticky summary, type @kbd{C-u q} to exit or move to
+another summary by @kbd{C-u g}. Other operations in the sticky summary
+are same as normal summary.
@code{wl-summary-always-sticky-folder-list} specifies the folders that
are automatically stuck.
@example
@group
all ...Discard current summary and update all message.
+all-visible ...Discard current summary and update all visible message.
update ...Update the difference between summary and the folder itself.
rescan ...Rescan the msgdb and display again.
rescan-noscore ...Rescan the msgdb and display again (without scoring).
+cache-status ...Sync the all marks with the real status of cache.
first, last ...Move to the filter folder(partial filter).
@end group
@end example
if the specified condition is satisfied.
(@code{wl-summary-target-mark-pick})
+@item m #
+@kindex m # (Summary)
+@findex wl-summary-target-mark-print
+Print out all messages which have target mark @samp{*}.
+(@code{wl-summary-target-mark-print})
+
+@item m |
+@kindex m | (Summary)
+@findex wl-summary-target-mark-pipe
+Pipe content of each message with target mark @samp{*} to some specified
+external process.
+(@code{wl-summary-target-mark-pipe})
+
@item M-t
@kindex M-t (Summary)
@findex wl-toggle-plugged
@code{wl-summary-save-current-message}
to the thread.
(@code{wl-summary-yank-saved-message})
+
+@item C-x C-s
+@kindex C-x C-s (Summary)
+@findex wl-summary-save-status
+Save the current summary.
+(@code{wl-summary-save-status})
@end table
@item wl-auto-select-first
@vindex wl-auto-select-first
The initial setting is @code{nil}.
-If non-nil, first message is automatically displayed.
+If non-nil, first message is automatically displayed when you enter
+the folder.
@item wl-auto-select-next
@vindex wl-auto-select-next
At Summary mode, pressing @kbd{w} and the like creates a new draft
buffer. You can edit and send mail and news articles in this buffer.
+By pressing @kbd{W}, Wanderlust guess addressees and prepare draft buffer
+with those if possible.
+
@section Tips
Basically it is Emacs-standard mail mode.
@lisp
@group
(setq wl-draft-config-alist
- '(((string-match "aaa.example.com$" (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.example.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)}
expression can be specified as is. If the car part is a header field
and the cdr part is @code{nil}, the field will be deleted.
+If you want to use name of parent folder, you can refer the buffer local
+variable @code{wl-draft-parent-folder}.
+
See the next example as well:
@lisp
(setq wl-template-alist
'(("default"
("From" . wl-from)
- ("Organization" . "~/.wl sample")
+ ("Organization" . "Example Co.Ltd.")
(body . "Hello.\n"))
("report"
(template . "default") ;; @r{(a)}
Enter Address Manager.
@xref{Address Manager}.
(@code{wl-addrmgr})
+
+@item C-c C-d
+@kindex C-c C-d (Draft)
+@findex wl-draft-elide-region
+Elide the text between point and mark (@code{wl-draft-elide-region}).
+The text is killed and replaced with the contents of the variable
+@code{wl-draft-elide-ellipsis}. The default value is to use an ellipsis
+(@samp{[...]}).
@end table
@section Customizable Variables
The initial setting is @code{t}. If non-nil, @samp{Message-ID:} field
is automatically inserted on the transmission.
+@item wl-message-id-use-wl-from
+@vindex wl-message-id-use-wl-from
+The initial setting is @code{nil}. If non-nil, the value of
+@code{wl-from} will be used as the domain part of @samp{Message-ID:}.
+
@item wl-local-domain
@vindex wl-local-domain
The initial setting is @code{nil}. If @code{nil}, the return value of
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
-The initial setting is @code{nil}. If @code{nil}, the return value of
-the function @code{system-name} will be used as the domain part of
-@samp{Message-ID:}. If @code{system-name} does not return FQDN
-(i.e. the full name of the host, like @samp{smtp.gohome.org}), you
-@strong{must} set this variable to the string of the full name of the
-host. Otherwise, you might be beaten up on the Net News.
+@item wl-unique-id-suffix
+@vindex wl-unique-id-suffix
+The initial setting is @samp{.wl}. You can specify the string in generated
+Message-ID which appear just before @samp{@@}.
@item wl-draft-config-alist
@vindex wl-draft-config-alist
@subsection Creation of Folders (IMAP4)
You can create IMAP folders off-line. The creation of folders are
-reflected in the servers when Wanderlust becomes on-line. At that time,
-if folders failed to be created on the servers for any reasons, messages
-re-filed to such folders are appended to the folder @samp{+lost+found}.
+reflected in the servers when Wanderlust becomes on-line. If the creation
+of those folders fails at that time for some reasons, messages
+to be re-filed into those are appended to the folder @samp{+lost+found}
+instead.
@node Marking, Pre-fetching Reservations, Creation of Folders, Enable Operations
@code{wl-summary-expire-reserve-marks}, be careful in writing your own
function.
-These are three standard functions; they moves messages to an archive
+These are four standard functions; three of them move messages to an archive
folder in the specified way. This means old messages can be compressed
and saved in a file, being deleted from the original folder.
+The last one divides messages to some MH folders.
@table @code
@item wl-expire-archive-number1
@code{$folder-199812;zip}. The name of the archiving folders except the
date part are determined in the same way as
@code{wl-expire-archive-number1}.
-@end table
+
You can set the first argument to these three standard functions to non-nil
in @code{wl-expire-alist} so as to retain message numbers in the folder.
If you omit the argument, consecutive numbers from 1 are assigned for
each archiving folder.
+
+@item wl-expire-localdir-date
+divedes messages depending on its date (year and month) to MH folders
+e.g. to @samp{+ml/wl/1999_11/}, @samp{+ml/wl/1999_12/}.
+@end table
@end table
@subsection Treatment for Important or Unread Messages
@end lisp
If paths to the score files are omitted, the directory specified in the
-variable @code{wl-score-files-dir} is assumed.
+variable @code{wl-score-files-directory} is assumed.
No matter what you write in @code{wl-score-folder-alist}, the default
score file @code{wl-score-default-file} (@file{all.SCORE}) is always
The initial setting is t.
If non-nil, scoring is enabled.
-@item wl-score-files-dir
-@vindex wl-score-files-dir
+@item wl-score-files-directory
+@vindex wl-score-files-directory
The initial setting is @file{~/.elmo/}.
The default directory for score files.
@end table
-@node Customization, Mailing List, Address Book, Top
+@node Customization, Terminology, Address Book, Top
@chapter Customizing Wanderlust
@cindex Customization
@menu
* imput:: imput (im-wl.el)
-* BBDB:: BBDB
+* BBDB:: The Insidious Big Brother Database
+* LSDB:: The Lovely Sister Database
* supercite:: supercite.el
* mu-cite:: mu-cite.el
* X-Face:: x-face,bitmap-mule
@end lisp
-@node BBDB, supercite, imput, Living with other packages
+@node BBDB, LSDB, imput, Living with other packages
@subsection bbdb.el
@pindex BBDB
(setq bbdb-use-pop-up t)
;; @r{auto collection}
(setq bbdb/mail-auto-create-p t)
+;; @r{exceptional folders against auto collection}
+(setq bbdb-wl-ignore-folder-regexp "^@@")
(setq signature-use-bbdb t)
(setq bbdb-north-american-phone-numbers-p nil)
;; @r{shows the name of bbdb in the summary} :-)
in draft buffer.
-@node supercite, mu-cite, BBDB, Living with other packages
+@node LSDB, supercite, BBDB, Living with other packages
+@subsection lsdb.el
+@pindex LSDB
+
+The following is an example of settings:
+
+@lisp
+@group
+(require 'lsdb)
+(lsdb-wl-insinuate)
+(add-hook 'wl-draft-mode-hook
+ (lambda ()
+ (define-key wl-draft-mode-map "\M-\t" 'lsdb-complete-name)))
+@end group
+@end lisp
+
+In this example, bind @kbd{M-@key{TAB}} to @code{lsdb-complete-name}
+(complete address with LSDB).
+
+
+@node supercite, mu-cite, LSDB, Living with other packages
@subsection sc.el(supercite), sc-register.el
@pindex sc
@pindex supercite
@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
-the reply draft by simply pressing @kbd{a} in the summary mode, try the
-following settings:
+If you type @kbd{a} in the Summary Buffer, a draft for reply is prepared.
+The addressee for the draft is decided by following rules.
+
+For example, you can set as follows:
@lisp
@group
@end group
@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.)
+Where each element of the list @code{wl-draft-reply-without-argument-list}
+is in the form
+
+@example
+(key . (to-list cc-list newsgroup-list))
+@end example
+
+and if the field designated by @samp{key} exist in the parent message,
+parent's field values designated by @samp{to-list} are copied to @samp{To:}
+in the draft. Similarly, parent's fields designated by @samp{cc-list} and
+@samp{newsgroup-list} are copied to @samp{Cc:} and @samp{Newsgroups:} in
+the draft respectively.
+
+Examples:
+
+@lisp
+("Mail-Followup-To" . (("Mail-Followup-To") nil ("Newsgroups")))
+@end lisp
+
+Match if the parent has @samp{Mail-Followup-To} field.
+The components of parent's @samp{Mail-Followup-To} and @samp{Newsgroups}
+fields are copied to @samp{To} and @samp{Newsgroups} in the draft
+respectively.
+
+@lisp
+(("X-ML-Name" "Reply-To") . (("Reply-To") nil nil))
+@end lisp
+
+Match if the parent has both @samp{X-ML-Name} and @samp{Reply-To} fields.
+Parent's @samp{Reply-To} is copied to @samp{To} in the draft.
+
+@lisp
+("From" . (("From") ("To" "Cc") ("Newsgroups")))
+@end lisp
+
+Copy parent's @samp{From} to @samp{To} in the draft, parent's @samp{To} and
+@samp{Cc} to @samp{Cc}, parent's @samp{Newsgroups} to @samp{Newsgroups}
+respectively.
+
+These are evaluated in order and first matched one is used.
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.
+By the way, you can use some function (will be evaluated in the parent
+message buffer) in the place of @samp{key} or @samp{to-list} etc.
+For example, if you only want to reply to mailing lists in
+@code{wl-subscribed-mailing-list} if the parent has some of them,
+set as follows:
+
+@lisp
+@group
+(defun wl-mailing-list-addresses ()
+ (let (list-addrs)
+ (dolist (to (mapcar
+ (lambda (addr)
+ (nth 1 (std11-extract-address-components addr)))
+ (wl-parse-addresses
+ (wl-concat-list
+ (elmo-multiple-fields-body-list (list "To" "Cc"))
+ ","))))
+ (when (elmo-string-matched-member to wl-subscribed-mailing-list t)
+ (setq list-addrs (cons to list-addrs))))
+ (nreverse list-addrs)))
+
+(setq wl-draft-reply-with-argument-list
+ '((wl-mailing-list-addresses . (wl-mailing-list-addresses nil nil))
+ ("Reply-To" . (("Reply-To") nil nil))
+ ("Mail-Reply-To" . (("Mail-Reply-To") nil nil))
+ ("From" . (("From") nil nil))))
+@end group
+@end lisp
+
+
+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
@lisp
@group
(setq wl-generate-mailer-string-function
- (function
- (lambda ()
- (concat "User-Agent: "
- (wl-generate-user-agent-string-1 nil)))))
+ 'wl-generate-user-agent-string-1)
@end group
@end lisp
@lisp
@group
-(setq mime-edit-insert-user-agent-field nil)
-(setq wl-generate-mailer-string-function
- (function
- (lambda ()
- (format "X-Mailer: %s" (product-string-1 'wl-version)))))
+(setq wl-generate-mailer-string-function nil)
+(setq wl-draft-additional-header-alist
+ (list
+ (cons 'X-Mailer (lambda () (product-string-1 'wl-version)))))
@end group
@end lisp
@item wl-auto-check-folder-name
@vindex wl-auto-check-folder-name
The initial setting is @code{nil}.
-If non-nil, the folder with the name of the value is checked for unread
-messages at the start.
+You can specify a folder or a group which is checked for unread message
+at the start. You can also specify a list of folders (groups) to be checked.
+If the value is @code{nil}, whole Desktop is checked at the start.
If it is @code{none}, no folders are checked.
-If it is a list, all folders in the list are checked at the start.
@item wl-auto-uncheck-folder-list
@vindex wl-auto-uncheck-folder-list
@end lisp
@noindent
-Folders with the name matching this variable are not checked for unread
-messages at the start, even if they are included in the groups in
-@code{wl-auto-check-folder-name}.
+You can set a list of regular expressions to specify folders
+which are not automatically checked even if they are included
+in some groups assigned by @code{wl-auto-check-folder-name}.
@item wl-auto-check-folder-list
@vindex wl-auto-check-folder-list
The initial setting is @code{nil}.
-Folders with the name matching this variable are always checked for
-unread messages at the start, if they are included in the groups in
-@code{wl-auto-check-folder-name}.
-This takes precedence over @code{wl-auto-uncheck-folder-list}.
+You can set a list of regular expressions to specify exceptions
+for @code{wl-auto-uncheck-folder-list}.
@item wl-no-save-folder-list
@vindex wl-no-save-folder-list
(Not yet written)
+@node Terminology, Mailing List, Customization, Top
+@chapter Terminology around Wanderlust
+@cindex Terminology
+
+Here we explain terminologies used in this manual.
+
+@table @samp
+@item folder
+A container in which messages are stored.
+
+@item group
+A set consists of some folders.
+
+@item access group
+A special group consists of automatically collected folders under
+some specified path.
+@xref{Folder Definition}.
+
+@item summary buffer
+A buffer for displaying list of messages in some folder.
-@node Mailing List, Addition, Customization, Top
+@item sticky summary
+Compared with ordinary summary buffer which will be destroyed after
+exiting from it, this type of summary will be remain even after exiting
+by @kbd{q} or @kbd{g}.
+@xref{Sticky Summary}.
+
+@item expire
+To delete or put into the archive expired messages.
+@xref{Expire}.
+
+@item score
+@xref{Scoring}.
+
+@item prefetch
+To cache messages beforehand in order to read messages after you will be
+disconnected from the server.
+@end table
+
+
+@node Mailing List, Addition, Terminology, Top
@chapter Wanderlust Mailing List
@cindex Bug report
@cindex Backtrace
+Topics related to Wanderlust are discussed in following mailing lists.
+The latest version is also announced there.
+
@display
Wanderlust Mailing List @t{<wl@@lists.airs.net>}
@end display
-Topics related to Wanderlust are discussed in the mailing list.
-The latest version is also announced there (in Japanese, sorry).
+In this list Japanese is mainly used for discussion. We also have a list
+for discussion in English:
+
+@display
+Wanderlust List in English @t{<wl-en@@lists.airs.net>}
+@end display
+(Messages posted to this list are also forwarded to the former one.)
A guide can be obtained automatically by sending mail to
-@t{wl-ctl@@lists.airs.net} with the body
+@t{wl-ctl@@lists.airs.net} (or to @t{wl-en-ctl@@lists.airs.net} for
+the English one) with the body
@example
# guide
@end example
-Please send bug reports or patches to the mailing list. You can post to
+
+Please send bug reports or patches to one of those lists. 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.
11/08 Released 2.4.0 stable.
2001 7/04 Released 2.6.0 stable.
8/21 wl-addrmgr by Kitamoto-san.
+ 12/27 Released 2.8.1 stable.
@end example
See @file{ChangeLog} for details.
projects / elisp / wanderlust.git / blobdiff