@pindex APEL
@pindex FLIM
@pindex SEMI
-@pindex tm
-SEMI or tm must be installed to make Wanderlust work correctly.
+SEMI must be installed to make Wanderlust work correctly.
-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
-is needed.)
-
-However, SEMI is recommended because of its wider functionality.
-
-Refer to the documents of each package for detailed installation procedure.
-
-SEMI and tm can be downloaded from these sites:
+SEMI can be downloaded from these sites:
@example
@group
SEMI: ftp://ftp.m17n.org/pub/mule/semi/
-tm: http://cvs.m17n.org/tomo/comp/emacsen/tm/tm-8/
@end group
@end example
@samp{make install} will do the job. (In XEmacs 21, @samp{make
install-package}.)
+Refer to the documents of each package for detailed installation
+procedure @footnote{If you want to use SEMI on Emacs 19.34. @*
+@uref{http://www.jpl.org/elips/INSTALL-SEMI-ja.html} (In Japanese)
+may help you.}.
+
+
Recommended combination of APEL, FLIM and SEMI are following:
@itemize @minus
-@item APEL 10.3, FLIM 1.14.2 and SEMI 1.14.3
+@item APEL 10.3, FLIM 1.14.3 and SEMI 1.14.3
@end itemize
You can also use many other FLIM/SEMI variants. Combination of the
@item APEL 10.2, SLIM 1.14.3, EMY 1.13.9
@end itemize
-You have to re-install Wanderlust if you upgraded APEL, FLIM, SEMI or
-tm.
+You have to re-install Wanderlust if you upgraded APEL, FLIM or SEMI.
@node Download, Install, MIME Modules, Start Me Up
@pindex OpenSSL
@pindex starttls
-SSL (Secure Socket Layer) can be used for
+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
directory that OpenSSL commands are installed.
To use the latter SSL(STARTTLS), you must install starttls package in
-addition to above.
+addition to above.
You can download starttls package from the following site.
@example
in @file{Makefile} as is. (That is, leave it as @samp{NONE})
If you are using an Emacs variant which does not merge specified directory
-to @code{load-path} (e.g. Mule 2.3 based on Emacs 19.28),
+to @code{load-path} (e.g. Mule 2.3 based on Emacs 19.28),
then you will see the error message:
@example
A directory to install WL modules.
This directory is relative directory from @code{LISPDIR}.
WL modules include @file{wl*.el}, @file{wl*.elc} files.
-@c Modules under the directory @file{util/} are also installed if
+@c Modules under the directory @file{util/} are also installed if
@c it detected as necessary.
@item ELMO_PREFIX
ELMO modules include @file{elmo*.el}, @file{elmo*.elc} files.
@c @file{utf7.el}, @file{utf7.elc} are also included in the ELMO.
@end table
-
+
@noindent
Default value of @code{WL_PREFIX} and @code{ELMO_PREFIX} are @file{wl}.
@lisp
@group
;; @r{The setting to use SEMI}
-(load "mime-setup")
+(require 'mime-setup)
;; @r{autoload configuration}
;; @r{(These are not required if Wanderlust is installed as XEmacs package)}
(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).}
-;; @r{Default: @code{nil}.}
-;; @r{(This is not required if Wanderlust is installed as XEmacs package)}
-(setq wl-icon-dir "~/work/wl/etc")
+;; @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)}
+(setq wl-icon-directory "~/work/wl/etc")
;; @r{SMTP server for mail posting. Default: @code{nil}}
(setq wl-smtp-posting-server "your.smtp.example.com")
(if you write it to @file{.emacs}, you'll get an error).
@xref{Highlights}.
-All above described settings except (load "mime-setup") and autoload
+All above described settings except @samp{(require 'mime-setup)} and autoload
configuration can be written in
@file{~/.wl}).
@findex compose-mail
If you write following setting in you @file{.emacs}, you can
-start Wanderlust draft mode by typing @kbd{C-x m} (@code{compose-mail}).
+start Wanderlust draft mode by typing @kbd{C-x m} (@code{compose-mail}).
This means it enables you to run Wanderlust as a default mail composer
of Emacsen.
The part surrounded by @samp{@var{group name}@{} and @samp{@}} will
become one folder group. One folder group is treated as a directory
-which can bed opened and closed in folder mode. It is convenient for
+which can be opened and closed in folder mode. It is convenient for
collecting some folders and putting them in order.
Please note that @samp{@var{group name}@{} and @samp{@}} occupies one
If you start Wanderlust with prefix argument like @kbd{C-u M-x wl}, you
can skip folder checking.
+Basically, you will handle messages in wanderlust while you come and go
+from/to each of the following buffers.
+
+@table @samp
+@item Folder Buffer
+You can see the list of folders. You can select some folder and go into the summary
+of it. You can subscribe new folder or edit subscription list.
+@item Summary Buffer
+You can see the list of messages in the folder. You can select message and view its
+contents, and reply to some message. You can delete ones or move ones to another
+folder.
+@item Message Buffer
+You can see the contents of the message. You can save part to disk or open in external
+programs.
+@item Draft Buffer
+You can edit message.
+@end table
+
+Details of each ones are explained later.
+
@node Folders, Folder, Start Me Up, Top
-@chapter Wanderlust's folders
+@chapter Wanderlust's folders
@cindex Folder Type
This chapter describes the folder types which Wanderlust is able to handle.
@example
@var{hostname} -> The value of @code{elmo-nntp-default-server}.
Initial setting is @samp{localhost}.
-@var{username} -> The value of @code{elmo-nntp-default-user}.
+@var{username} -> The value of @code{elmo-nntp-default-user}.
Initial setting is @code{nil}.
@var{port} -> The value of @code{elmo-nntp-default-port}.
Initial setting is 119.
@pindex Maildir
@pindex qmail
-A folder to access to Maildir format (1 file is 1 mail).
+A folder to access Maildir format (1 file is 1 mail).
Format:
Maildir contains @file{cur}, @file{new} and @file{tmp} subdirectories.
Messages are contained in the @file{cur} directory. All message files
in the @file{new} directory are moved to @file{cur} directory when you
-access to the folder. All message files contained in the @file{tmp}
+access the folder. All message files contained in the @file{tmp}
directory and not accessed for 36 hours are deleted.
This behavior conforms to the @uref{http://cr.yp.to/proto/maildir.html}.
(If re-search's performance is the problem, 19.3x or later may be okay.)
If many files are included in one archive,
-it takes long time to access to the archive folder because
+it takes long time to access the archive folder because
archiver starting overhead is increased (especially LHA).
150-200 messages in one archive is recommended.
-Of course, following is possible @t{:-)}
+Of course, following is possible @t{:-)}
(meanings of these variables are described later.)
@lisp
@item elmo-archive-default-type
@vindex elmo-archive-default-type
The initial setting is @code{zip}.
-Set archiver type by symbol.
+Set archiver type by symbol.
@item elmo-archive-@var{type}-method-alist
@vindex elmo-archive-TYPE-method-alist
@end example
@noindent
-In above actions,
+In above actions,
actions enclosed with braces are optional (They are used for better
performance).
@example
@group
-&hoge@@localhost -> access to localhost as user @samp{hoge}.
-&hoge@@popserver:109 -> access to the server "popserver" on port 109
+&hoge@@localhost -> access localhost as user @samp{hoge}.
+&hoge@@popserver:109 -> access the server "popserver" on port 109
as user @samp{hoge}.
@end group
@end example
@end group
@end example
-Admissible values of @var{module-name} and @var{folder-name} are
+Admissible values of @var{module-name} and @var{folder-name} are
described in @file{README.shimbun.ja} distributed with emacs-w3m.
Example:
@cindex Folder, Text Search
@pindex Namazu
@pindex nmz
+A folder to access messages found in namazu-index with some condition.
+It uses namazu (@uref{http://www.namazu.org/}) for search.
+
+Format:
+
+@example
+@group
+@samp{[} @var{search condition} @samp{]} [ @var{absolute path of namazu index} ]
+@end group
+@end example
+
+Default value of the path of namazu index can be assigned by @code{elmo-nmz-default-index-path}.
+
+Example:
+
+@example
+@group
+[wanderlust] -> search messages matched with
+ "wanderlust" from the default index
+[semi flim]~/Mail/semi -> search "semi flim" from the index
+ in the directory "~/Mail/semi"
+@end group
+@end example
+
+Tips
+
+If you want to use space in folder entry, @kbd{C-q @key{SPC}} will help you.
@node Multi Folder, Filter Folder, Namazu Folder, Folders
@cindex Folder, Multiple
@cindex Folder, Marge
-A folder to access to a folder which collects messages from
-multiple folders virtually.
+A folder to access virtual folder which collects messages from
+multiple folders.
Format:
@cindex Folder, Virtual
@cindex Folder, Conditional
-A folder to access to a folder which collects all messages that
-satisfy a condition virtually.
+A folder to access virtual folder which collects all messages that
+satisfy a condition.
Format:
/since:3daysago/+inbox -> messages arrived since 3 days ago in +inbox
are picked.
/before:yesterday/+inbox -> messages arrived before yesterday in +inbox
- are picked.
+ are picked.
@end group
@end example
@example
@group
/from:teranisi&!to:teranisi/+inbox
- -> In +inbox, messages are picked if the message's
- From: field includes "teranisi" and
+ -> In +inbox, messages are picked if the message's
+ From: field includes "teranisi" and
To: field doesn't include "teranisi".
-/tocc:"Yuuichi Teranishi"/+inbox
+/tocc:"Yuuichi Teranishi"/+inbox
-> In +inbox, messages are picked if the
- message's To: field or Cc: field includes
+ message's To: field or Cc: field includes
"Yuuichi Teranishi".
/(from:yt|from:teranisi)&subject:report/+inbox
@samp{|} @var{source-folder} @samp{|} @var{destination-folder}
@end example
-When you access to the pipe folder, messages are automatically transferred
+When you access the pipe folder, messages are automatically transferred
from @var{source-folder} to @var{destination-folder}.
It is convenient if you want to download messages to local disk via POP.
For example, if you specify following
@end example
@noindent
-and access to it, messages are downloaded automatically from
+and access it, messages are downloaded automatically from
@samp{&username@@popserver} to @samp{+inbox}.
Example:
@cindex Cache
@c @cindex Folder, Null
-A folder to access to internal messages of Wanderlust.
+A folder to access internal messages of Wanderlust.
Format:
@example
@group
'mark
-@r{or}
+'sendlog
'cache/00 - 1F
@end group
@end example
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
+
+A folder named @samp{'sendlog} is a virtual folder which collects
+cached messages which are recoded on @file{~/.elmo/sendlog}.
+It might be useful when you forgot to add cc for yourself.
+To use this, you should set @code{wl-draft-use-cache} to non-nil
+so that sent messages are cached.
+
+
+You can access cached messages fetched via network by accessing
+folders named @samp{'cache/00} - @samp{'cache/1F}. 00 - 1F are
the name of the subdirectories of the cache directory
(@file{~/.elmo/cache}).
To enter summary mode of the folder, type return (or space) key on
the folder line.
-If the variable @code{wl-stay-folder-window} has non-nil value,
+If the variable @code{wl-stay-folder-window} has non-nil value,
summary window appears on the right of the folder mode window.
@subsection Key bindings
@kindex @key{RET} (Folder)
@findex wl-folder-jump-to-current-entity
Enter to the summary mode of the folder at the current cursor point.
-If the cursor is on the top of folder group line,
+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
+When the cursor is on the access group and this command is called
with prefix argument, folder children list is updated to the newest one.
(Children list is updated recursively if the access folder has hierarchical
structure.)
@item s
@kindex s (Folder)
@findex wl-folder-check-current-entity
-Update new and unread number information of the folder at the current
+Update new and unread number information of the folder at the current
cursor point.
(@code{wl-folder-check-current-entity})
The initial setting is 20.
Folder mode's window width when @code{wl-stay-folder-window} is non-nil.
+@item wl-folder-use-frame
+@vindex wl-folder-use-frame
+The initial setting is @code{nil}.
+If non-nil, use new frame for the folder window.
+
@item wl-folder-many-unsync-threshold
@vindex wl-folder-many-unsync-threshold
The initial setting is 70.
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.
-In other words, appended position depends on the
+In other words, appended position depends on the
above folder group's open/close status.
@subsubsection Charset of the Folders File.
@subsubsection Sort Folders
-Sorting of the folders is executed by the function specified by
-@code{wl-fldmgr-sort-function}.
-The initial setting is @code{wl-fldmgr-sort-standard},
+Sorting of the folders is executed by the function specified by
+@code{wl-fldmgr-sort-function}.
+The initial setting is @code{wl-fldmgr-sort-standard},
which sorts alphabetically.
-Sorting affects only on the current folder group. It does not
+Sorting affects only on the current folder group. It does not
affect on the child groups.
@subsubsection Hiding Folders in the Access Group
children folders of the access group and they only sets the subscribe
status. In other words, insertion of the folder means subscribing,
deletion means unsubscribing.
-@footnote{In the current implementation,
+@footnote{In the current implementation,
it is faster to delete region than to unsubscribe region.}
To update the access group when children folders are inserted or deleted
-by other way (other than Wanderlust),
+by other way (other than Wanderlust),
open the access group by typing @kbd{C-u @key{RET}}.
@xref{Selecting Folder}.
@cindex Keybind, Folder Buffer
Key bindings on the folder mode related to folder editing are shown below.
-All bindings starts with @kbd{m}, and primary commands are binded to
+All bindings starts with @kbd{m}, and primary commands are binded to
one stroke key binding.
@table @kbd
@itemx m A
@kindex m A (Folder)
@findex wl-fldmgr-make-access-group
-Create an access group.
+Create an access group.
(@code{wl-fldmgr-make-access-group})
@item m d
@kindex r u (Folder)
@findex wl-fldmgr-unsubscribe-region
Set the visibility of the folders (subscribe/unsubscribe) in the
-specified region.
+specified region.
(@code{wl-fldmgr-unsubscribe-region})
@item l
@subsection Temporary Marks
@cindex Mark, Temporary
-There are four temporary marks,
+There are four temporary marks,
@samp{*}, @samp{D}, @samp{o} and @samp{O}.
Temporary marks indicates message operations.
@item O
The mark to refile.
You can put this mark by typing @kbd{O} key.
-The difference between this mark and refile mark is,
+The difference between this mark and refile mark is,
this mark does not delete the message while latter does.
@end table
@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,
+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.
@subsection Buffer Cache and Prefetching
-If the value of @code{elmo-use-buffer-cache} is non-nil, the messages
-that are read are kept in the cache buffer. It is called `buffer
-cache'. The number of cache buffer is specified by
-@code{elmo-buffer-cache-size}.
+The messages that are read are kept in the cache buffer. It is called
+`buffer cache'. The number of cache buffer is specified by
+@code{wl-message-buffer-cache-size}.
There are message prefetching mechanism in the Wanderlust that
-prefetches next message while you are reading. This function requires
-that the value of @code{elmo-use-buffer-cache} is non-nil.
+prefetches next message while you are reading.
You can control the message prefetching mechanism by these two
variables.
@table @code
-@item wl-cache-prefetch-folder-type-list
-@vindex wl-cache-prefetch-folder-type-list
-The initial setting is the list shown below:
-@lisp
-@group
-(nntp imap4)
-@end group
-@end lisp
-
-@noindent
-It specifies the folder types in which message prefetching is enabled.
-In the initial setting, multi folder that contains localdir and imap4
-prefetches only imap4 messages. This variable precedes the value of
-@code{wl-cache-prefetch-folder-list}.
-
-If you want to prefetch localdir and localnews also, following setting
-is needed.
+@item wl-message-buffer-prefetch-folder-type-list
+@vindex wl-message-buffer-prefetch-folder-type-list
+The initial setting is @code{t}. In this case, prefetch messages in all
+folders.
+If it is a list of folder types, it specifies the folder types in which
+message prefetching is enabled.
+Following is an example (prefetch messages in nntp and imap4 folders)
@lisp
@group
-(setq wl-cache-prefetch-folder-type-list
- '(nntp imap4 localdir localnews))
+(setq wl-message-buffer-prefetch-folder-type-list
+ '(nntp imap4))
@end group
@end lisp
-@item wl-cache-prefetch-folder-list
-@vindex wl-cache-prefetch-folder-list
+In this case, multi folder that contains localdir and imap4 prefetches
+only imap4 messages. This variable precedes the value of
+@code{wl-message-buffer-prefetch-folder-list}.
+
+@item wl-message-buffer-prefetch-folder-list
+@vindex wl-message-buffer-prefetch-folder-list
The initial setting is @code{nil}.
A list of regexp of folders to enable message prefetching.
@end table
(("To" "Cc")
("\\([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
matched messages by typing @kbd{C-o} (@code{wl-summary-auto-refile}).
Messages which have @code{wl-summary-auto-refile-skip-marks} is skipped
-auto refiling.
+auto refiling.
By default, @samp{N}, @samp{U} and @samp{!} is specified, so the messages
with these persistent marks are not automatically refiled.
It means Wanderlust does not execute auto refile on unread messages by
@cindex Summary, Sticky
@cindex Sticky Summary
-The buffer of the `sticky summary' does not killed by typing @kbd{q}.
+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.
@kindex . (Summary)
@findex wl-summary-redisplay
Redisplay a message at the current cursor point.
-If this command is called with prefix argument,
+If this command is called with prefix argument,
Redisplay message regardless of the message cache (message is re-loaded
-from source).
+from source).
(@code{wl-summary-redisplay})
@item <
@kindex n (Summary)
@findex wl-summary-next
Move cursor to the next message.
-If message is marked with a temporal mark in
+If message is marked with a temporal mark in
@code{wl-summary-skip-mark-list}, cursor is not moved to it.
In the offline mode, cursor is not moved to the messages which are not cached
yet.
@kindex p (Summary)
@findex wl-summary-prev
Move cursor to the previous message.
-If message is marked with a temporal mark in
+If message is marked with a temporal mark in
@code{wl-summary-skip-mark-list}, cursor is not moved to it.
In the offline mode, cursor is not moved to the messages which are not cached
yet.
@item B
@kindex B (Summary)
@findex wl-summary-burst
-If the message at current cursor point has
+If the message at current cursor point has
encapsulates multiple messages using MIME,
de-capsulate and extract them on the current folder.
(@code{wl-summary-burst})
@item I
@kindex I (Summary)
Update summary status and
-prefetch all messages which have marks included in the
+prefetch all messages which have marks included in the
@code{wl-summary-incorporate-marks}.
@findex wl-summary-incorporate
(@code{wl-summary-incorporate})
@findex wl-summary-toggle-thread
Toggle the threading.
Threading status is displayed on the modeline.
-@samp{@{S@}} means threading is off (Sequence) and
+@samp{@{S@}} means threading is off (Sequence) and
@samp{@{T@}} means threading is on (Thread).
(@code{wl-summary-toggle-thread})
@item t $
@kindex t $ (Summary)
@findex wl-thread-mark-as-important
-Put important mark @samp{$} on the messages which are the
+Put important mark @samp{$} on the messages which are the
descendant of the current thread.
If @samp{$} mark exists, it is deleted.
With prefix argument, it affects on the all messages in the thread tree.
@findex wl-thread-unmark
Unmark temporal mark on the messages which are the descendant of the
current thread. With prefix argument, it affects on the all messages in
-the thread tree.
+the thread tree.
(@code{wl-thread-unmark})
@item t y
@kindex m i (Summary)
@findex wl-summary-target-mark-prefetch
Prefetch all messages which have target mark @samp{*}.
+With prefix argument, prefetch all targets even if some of them are cached.
(@code{wl-summary-target-mark-prefetch})
@item m R
@item m ?
@kindex m ? (Summary)
@findex wl-summary-target-mark-pick
-Pick messages from the @samp{*} marked messages.
+Pick messages from the @samp{*} marked messages.
That is, @samp{*} marks on the messages are remained
if the specified condition is satisfied.
(@code{wl-summary-target-mark-pick})
@item wl-auto-select-next
@vindex wl-auto-select-next
-The initial setting is @code{nil}. If non-nil, jump to next summary
-automatically. If @code{unread}, jump to next unread folder's summary
-after confirmation. If @code{skip-no-unread}, unread folders are
-automatically skipped.
+The initial setting is @code{nil}. This controls behavior when there is
+no unread message in current summary.
+
+@example
+nil: asks whether you want to go back to folder mode
+'unread: asks whether you want to go to next unread folder
+ If the next one comes to be possessing no unread message
+ by treatment of cross-posted messages or Scoring, then
+ asks whether you want to go to next to next folder.
+'skip-no-unread: similar as unread
+ But does not ask before going to next to next folder.
+otherwise: asks whether you want to go to next unread folder
+@end example
+
+It might be useful to set @code{'skip-no-unread} for people who
+want to continue reading by just pressing and pressing space key.
@item wl-thread-insert-opened
@vindex wl-thread-insert-opened
@vindex wl-summary-weekday-name-lang
The initial setting is @samp{ja}. Specify language of the weekday.
@samp{en} displays English, @samp{fr} displays French, @samp{de}
-displays Deutsch.
+displays Deutsch. You should rescan summary view after changing this value.
@item wl-summary-fix-timezone
@vindex wl-summary-fix-timezone
-The initial setting is @code{nil}.
+The initial setting is @code{nil}.
Time zone of the date string in summary mode is adjusted using this value.
If @code{nil}, it is adjust to the default time zone information
(system's default time zone or environment variable @samp{TZ}).
A cons cell to specify the rate of summary and message window.
car:cdr corresponds summary:message.
-@item wl-summary-recenter
-@vindex wl-summary-recenter
-The initial setting is t.
-If non-nil, cursor point is moved to the center of the summary window.
-
-@item wl-summary-indent-length-limit
-@vindex wl-summary-indent-length-limit
-The initial setting is 46.
-Specify the limit of thread indent level.
-If nil, max indent level is unlimited.
-
@item wl-summary-no-from-message
@vindex wl-summary-no-from-message
The initial setting is @samp{nobody@@nowhere?}. A string which is
The initial setting is @samp{(WL:No Subject in original.)}. A string
which is displayed when there's no @samp{Subject:} field in the message.
-@item wl-summary-width
-@vindex wl-summary-width
-The initial setting is 80.
-Width of summary line. If @code{nil}, summary line's width is as is.
+@item wl-summary-use-frame
+@vindex wl-summary-use-frame
+The initial setting is @code{nil}.
+If non-nil, use new frame for the summary.
@item wl-use-folder-petname
@vindex wl-use-folder-petname
@kbd{P}, @kbd{n}, @kbd{N} toggles the direction of cursor move. If you
want to aware of reading direction, set this to @code{t}.
-@item wl-from-width
-@vindex wl-from-width
+@item wl-summary-width
+@vindex wl-summary-width
+The initial setting is 80.
+Width of summary line. If @code{nil}, summary line's width is as is.
+
+@item wl-summary-from-width
+@vindex wl-summary-from-width
The initial setting is 17.
Width of sender part of summary line.
+@item wl-summary-subject-length-limit
+@vindex wl-summary-subject-length-limit
+The initial setting is @code{nil}. Specify the limit for the length of
+subject parts in summary. @code{nil} means unlimited.
+
+@item wl-summary-indent-length-limit
+@vindex wl-summary-indent-length-limit
+The initial setting is 46.
+Specify the limit of thread indent level. @code{nil} means unlimited
+indent level.
+If you set this to @code{nil} you should set @code{wl-summary-width}
+to @code{nil}, too.
+
+@item wl-summary-recenter
+@vindex wl-summary-recenter
+The initial setting is t.
+If non-nil, cursor point is moved to the center of the summary window.
+
@item wl-summary-divide-thread-when-subject-changed
@vindex wl-summary-divide-thread-when-subject-changed
The initial setting is @code{nil}. If non-nil, thread is split if
buffer already exists, summary status is not automatically updated and
cursor position is saved.
-@item wl-summary-update-confirm-threshold
-@vindex wl-summary-update-confirm-threshold
+@item elmo-folder-update-threshold
+@vindex elmo-folder-update-threshold
The initial setting is 500. If updated message number is larger than
-this value, confirm whether drop them or not.
+this value, confirm whether drop them or not (in the case where the value
+of @code{elmo-folder-update-confirm} is non-nil).
+
+@item elmo-folder-update-confirm
+@vindex elmo-folder-update-confirm
+The initial setting is @code{t}. If the value is non-nil, do check with
+@code{elmo-folder-update-threshold}.
@item wl-summary-always-sticky-folder-list
@vindex wl-summary-always-sticky-folder-list
If a message is already marked as temporal marks in this list, the
message is skipped at cursor move.
-@item wl-fetch-confirm-threshold
-@vindex wl-fetch-confirm-threshold
+@item elmo-message-fetch-threshold
+@vindex elmo-message-fetch-threshold
The initial setting is 30000 (bytes). If displaying message has larger
size than this value, Wanderlust confirms whether fetch the message or
-not. If @code{nil}, the message is fetched without confirmation.
+not (in the case where the value of @code{elmo-message-fetch-confirm}
+is non-nil).
+
+@item elmo-message-fetch-confirm
+@vindex elmo-message-fetch-confirm
+The initial setting is @code{t}. If the value is non-nil, do check with
+@code{elmo-message-fetch-threshold}.
@item wl-prefetch-threshold
@vindex wl-prefetch-threshold
prefetch the message or not if the message has larger size than
@code{wl-prefetch-threshold}.
-@item wl-cache-fetch-threshold
-@vindex wl-cache-fetch-threshold
-The initial setting is 30000 (bytes). The messages which have larger
-size than @code{wl-fetch-confirm-threshold} are skipped buffer caching
-mechanism. If @code{nil}, any messages are prefetched by buffer caching
-mechanism.
-
@item elmo-imap4-use-cache
@vindex elmo-imap4-use-cache
The initial setting is @code{t}. If non-nil, messages read via IMAP4
The initial setting is @code{t}. If non-nil, messages read via POP3 are
cached.
+@item elmo-shimbun-use-cache
+@vindex elmo-shimbun-use-cache
+The initial setting is @code{t}. If non-nil, messages read in Shimbun
+folders are cached.
+
@item wl-folder-process-duplicates-alist
@vindex wl-folder-process-duplicates-alist
The initial setting is @code{nil}.
Message Buffers utilize MIME-View mode of SEMI. For operational
procedures and key bindings, refer to respective documents.
@xref{MIME-View, , ,mime-ui-en, a MIME user interface for GNU Emacs}.
+You can also see help by @kbd{?} in message buffer.
@kbd{p} at the top of a message or @kbd{n} at the bottom of a message
brings you back to Summary mode. @kbd{l} toggles display of Summary
'("Return-Path" "Received" "^To" "^Cc" "Newsgroups" "Subject" "^From").
Header fields in message buffer are ordered by this value.
Each elements are regexp of field-name.
+
+@item wl-message-truncate-lines
+@vindex wl-message-truncate-lines
+The initial value is the value of @code{default-truncate-lines}.
+If it is non-nil, truncate long lines in message buffer.
@end table
@node Draft, Disconnected Operations, Message, Top
Multi-part editing utilize MIME edit mode of SEMI. For procedures of
editing, refer to respective documents. @xref{MIME-Edit, , ,mime-ui-en,
a MIME user interface for GNU Emacs}.
+You can also see help by @kbd{C-c C-x ?} in draft buffer.
@subsection Dynamic Modification of Messages
@vindex wl-draft-config-alist
@example
'header: Inserts the specified string at the bottom of the header.
+'header-top: Inserts the specified string at the top of the header.
'header-file: Inserts the specified file at the bottom of the header.
'x-face: Inserts @samp{X-Face:} field with the content of the specified file.
'top: Inserts the specified string at the top of the body.
'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.
+'part-top: Inserts the specified string at the top of the current part.
+'part-bottom: Inserts the specified string at the bottom of the current part.
'template: Applies the specified template.
(refer to the next subsection)
@end example
Note that @code{wl-draft-config-alist} is applied only once when
@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
+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}) explicitly.
-If you don't want to apply @code{wl-draft-config-alist} when
+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:
(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
+If you want to apply @code{wl-draft-config-alist} when a draft buffer is
prepared, do the following:
@lisp
@kbd{n} and @kbd{p} seeing the buffer window.
Press the @key{RET} key and the template is actually applied to the draft
-buffer. If you press @kbd{q}, nothing is applied. In addition, you can
+buffer. If you press @kbd{q}, nothing is applied. In addition, you can
adjust the window size by @code{wl-template-buffer-lines}.
If @code{wl-template-visible-select} is @code{nil}, you should type the
unset, @code{elmo-pop3-default-stream-type} is used.
@end table
-If variables for POP-before-SMTP (@code{wl-pop-before-smtp-*}) are
+If variables for POP-before-SMTP (@code{wl-pop-before-smtp-*}) are
unset, settings for POP folders (@code{elmo-pop3-default-*}) are
used.
Therefore, if SMTP server and POP server are actually the same, and if
Encodes or decodes the specified region in Caesar cipher.
(@code{wl-caesar-region})
+@item C-l
+@kindex C-l (Draft)
+@findex wl-draft-highlight-and-recenter
+Recenter and rehighlight current draft.
+(@code{wl-draft-highlight-and-recenter})
+
@item M-t
@kindex M-t (Draft)
@findex wl-toggle-plugged
@findex wl-addrmgr
Enter Address Manager.
@xref{Address Manager}.
-
(@code{wl-addrmgr})
@end table
@item wl-template-buffer-lines
@vindex wl-template-buffer-lines
The initial setting is 7.
-If @code{wl-template-visible-select} is non-nil, this variable specifies
+If @code{wl-template-visible-select} is non-nil, this variable specifies
the size of the preview window.
@item wl-draft-reply-buffer-style
The initial setting is @code{nil}.
If non-nil, use new frame for the draft.
+@item wl-draft-truncate-lines
+@vindex wl-draft-truncate-lines
+The initial value is the value of @code{default-truncate-lines}.
+If it is non-nil, truncate long lines in draft buffer.
+
@item wl-from
@vindex wl-from
The initial setting is the value of the variable
The initial setting is @code{nil}. If the value is non-nil and
@code{wl-insert-message-id} is nil, cache the message which is sent.
+@item wl-fcc-force-as-read
+@vindex wl-fcc-force-as-read
+The initial setting is @code{nil}. If the value is non-nil,
+Mark as read the message saved by @samp{Fcc:} (only for IMAP folders).
+
@item wl-auto-flush-queue
@vindex wl-auto-flush-queue
The initial setting is t.
@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,
+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}.
@node Plugged Mode, Off-line State settings, Enable Operations, Disconnected Operations
@section Switching On-line/Off-line per Server/Port
-@kbd{M-t} described above switches networking states as a whole, but you
+@kbd{M-t} described above switches networking states as a whole, but you
can switch on-line/off-line per server/port.
Pressing @kbd{C-t} in the folder or summary modes brings you in
@samp{+queue} for off-line transmission, and @dfn{dop queue} means
off-line operations when @code{elmo-enable-disconnected-operation} is
@code{t}.
-@c If the variable @code{elmo-enable-disconnected-operation} is non-nil,
+@c If the variable @code{elmo-enable-disconnected-operation} is non-nil,
@c off-line operations are enabled.
They are displayed if there are any of them. In the example above, in
basis. Refer to @code{wl-reset-plugged-alist} also.
Usually, when Wanderlust starts up, the plugged state of each port is
-read from @file{~/.folder} and @code{wl-smtp-posting-server},
+read from @file{~/.folders} and @code{wl-smtp-posting-server},
@code{wl-nntp-posting-server} and so on. If you want to change the
plugged state of these ports or to add other ports, configure
@code{wl-make-plugged-hook} with a function.
@item elmo-plugged-condition
@vindex elmo-plugged-condition
The initial setting is @code{one}.
-The value of @code{wl-plugged} reflects the return value of the function
+The value of @code{wl-plugged} reflects the return value of the function
@code{elmo-plugged-p} (without arguments).
This variable @code{elmo-plugged-condition} specifies the condition on
which the return value of @code{(elmo-plugged-p)} should be t depending on the
This differs from @samp{wl-expire-archive-number1} in that this re-files
to the folder up to the specified number regardless of message numbers.
-The archiving folders to which messages are re-filed are determined in the
+The archiving folders to which messages are re-filed are determined in the
same way as @code{wl-expire-archive-number1}.
@item wl-expire-archive-date
@table @code
@item all
All messages with permanent marks are retained,
-i.e. @code{wl-summary-read-uncached-mark} is included in addition to the
+i.e. @code{wl-summary-read-uncached-mark} is included in addition to the
defaults.
@item none
@vindex wl-expire-archive-get-folder-function
The initial setting is @code{wl-expire-archive-get-folder}.
-This variable specifies a function that returns the name of an archiving
+This variable specifies a function that returns the name of an archiving
folder for standard functions in the place of @var{destination}.
You can use the following three variables for simple modification of
folder names; if you want more complex settings, define your own
folders. If there are the archiving folders already, only new messages
are appended.
-You can use @code{wl-archive-alist} in order to specify how messages are
+You can use @code{wl-archive-alist} in order to specify how messages are
archived according to their folder names, as in @code{wl-expire-alist}.
For example:
numbers or by their dates.
These are also useful for backup or confirmation purposes before
expiration.
-If you try to re-file them after they are archived, they are deleted but
+If you try to re-file them after they are archived, they are deleted but
not re-filed.
Per default, the archiving folders to which messages are copied are
@subsection Score File Specification
-@code{wl-score-folder-alist} specifies score files or variables in which
+@code{wl-score-folder-alist} specifies score files or variables in which
scores are defined, corresponding to folder names.
@lisp
but for "from" field, they are fixed upon automatically as substring and
permanent respectively.
However, score values can be modified by the prefix argument.
-Typing @kbd{?} at the mini-buffer shows a help on keys and corresponding
+Typing @kbd{?} at the mini-buffer shows a help on keys and corresponding
headers and types.
-At last, type @kbd{C-c C-c} in the score editing buffer. This saves the
+At last, type @kbd{C-c C-c} in the score editing buffer. This saves the
score file and terminates the edit mode. Typing @kbd{C-c C-c} after
erasing contents of the buffer deletes the score file being edited.
@end enumerate
-The sum of these scores @emph{after all factors are applied} becomes the
+The sum of these scores @emph{after all factors are applied} becomes the
score of the message.
@cindex Score File Atoms
@subsection Caveats
-Not to mention the @code{extra} key, if @code{lines} or @code{xref} keys
+Not to mention the @code{extra} key, if @code{lines} or @code{xref} keys
are used, you need to set @code{elmo-msgdb-extra-fields}.
@lisp
* X-Face:: x-face,bitmap-mule
* dired-dd:: dired-dd.el
* MHC:: MHC
+* Addrbook:: Addrbook
+* mime-w3m:: mime-w3m.el
@end menu
@end group
@end lisp
+You can complete address with BBDB by @kbd{M-@key{TAB}}
+in draft buffer.
+
+
@node supercite, mu-cite, BBDB, Living with other packages
@subsection sc.el(supercite), sc-register.el
@pindex sc
@lisp
@group
-(autoload 'sc-cite-original "sc" nil t)
-(setq mail-yank-hooks 'sc-cite-original)
-(setq sc-preferred-header-style 1)
-(setq sc-electric-references-p nil)
-(setq sc-citation-leader "")
-(setq sc-load-hook '(lambda () (require 'sc-register)))
-(setq sc-preferred-attribution 'registeredname)
+(autoload 'sc-cite-original "supercite" nil t)
+(add-hook 'mail-citation-hook 'sc-cite-original)
@end group
@end lisp
@subsubsection x-face-e21 (for Emacs 21.x)
@pindex x-face-e21
-If you use @file{x-face-e21.el} (@uref{ftp://jpl.org/pub/elisp/})
-with bitmap-mule (@uref{ftp://ftp.jpl.org/pub/elisp/bitmap/}),
+If you use @file{x-face-e21.el} (@uref{ftp://jpl.org/pub/elisp/}),
do the following:
@lisp
@group
-(require 'bitmap)
(autoload 'x-face-decode-message-header "x-face-e21")
(setq wl-highlight-x-face-function 'x-face-decode-message-header)
@end group
@end group
@end lisp
-@node MHC, , dired-dd, Living with other packages
+@node MHC, Addrbook, dired-dd, Living with other packages
@subsection mhc.el
@pindex MHC
@end group
@end lisp
+@node Addrbook, mime-w3m, MHC, Living with other packages
+@subsection wl-addrbook.el
+@pindex Addrbook
+
+Addrbook of Mew
+(@uref{http://www.mew.org/})
+
+Place @file{util/wl-addrbook.el} and @file{util/wl-complete.el} on the
+@code{load-path} and do the following settings.
+
+@lisp
+@group
+(require 'wl-addrbook)
+(wl-addrbook-setup)
+@end group
+@end lisp
+
+@node mime-w3m, , Addrbook, Living with other packages
+@subsection mime-w3m.el
+@pindex mime-w3m
+
+You can display html part by using @file{mime-w3m.el}
+distributed with emacs-w3m (@uref{http://emacs-w3m.namazu.org/}).
+You can find the usage in comment region at the head of @file{mime-w3m.el}.
+
+
@node Highlights, Biff, Living with other packages, Customization
@section Highlights
@item wl-highlight-citation-prefix-regexp
@vindex wl-highlight-citation-prefix-regexp
-Specifies a regular expression to which quoted lines in bodies of
+Specifies a regular expression to which quoted lines in bodies of
drafts and messages match.
Bodies matching to this regular expression are highlighted by the faces
specified by (@code{wl-highlight-message-cited-text-*}).
@item wl-biff-check-interval
@vindex wl-biff-check-interval
The initial setting is 40 (in seconds).
-Check mail arrival in this period.
+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:
+This hook is run at the arrival of new mail.
+To beep with mail arrival(initial setting), set as follows.
@lisp
-(setq wl-biff-notify-hook '(beep))
+(setq wl-biff-notify-hook '(ding))
@end lisp
+For silence, set to @code{nil}.
@end table
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
+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
@item wl-interactive-send
@vindex wl-interactive-send
-The initial setting is @code{nil}.
+The initial setting is @code{t}.
If non-nil, you are asked for confirmation when mail is sent.
@item wl-folder-sync-range-alist
@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
+I would like to express my thanks to the members of the mailing list for
valuable advice and many pieces of code they contributed.
@contents
@bye
-@c Local Variables:
+@c Local Variables:
@c fill-column: 72
@c End:
projects / elisp / wanderlust.git / blobdiff