@c %**end of header
@documentlanguage en
@documentencoding us-ascii
-@set VERSION 2.3.0
+@set VERSION 2.3.92
@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}.
+@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.
@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}.
+@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
-@item Cyrus imapd 1.5.19
-@item Cyrus imapd 1.6.22
-@item Cyrus imapd 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, 2.0.5 or later
@item AIR MAIL (AIRC imapd release 2.00)
@item Express Mail
@item Microsoft Exchange Server 5.5
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.12.7 and SEMI 1.13.4
@item APEL 10.2, FLIM 1.13.2 and SEMI 1.13.7
@end itemize
-Combination of APEL 10.2 and FLIM 1.12.7 makes following error
-while compiling FLIM 1.12.7.
-
-@example
-Please install latest APEL 7.3 or later.
-@end example
-
-In this case, please comment out following lines in @file{FLIM-CFG}.
-
-@lisp
-@group
-(or (fboundp 'write-region-as-binary)
- (error "Please install latest APEL 7.3 or later."))
-(or (fboundp 'insert-file-contents-as-binary)
- (error "Please install latest APEL 7.3 or later."))
-@end group
-@end lisp
-
You can also use many other FLIM/SEMI variants. Combination of the
latest versions should work. For example, following combination is
confirmed to work.
@itemize @minus
-@item APEL 10.2, Chao 1.14.1 and REMI 1.14.1
+@item APEL 10.2, Chao 1.14.1, REMI 1.14.2
+@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")
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 `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
@cindex Folder Definition
@cindex .folders
-Define the folders you want to subscribe in file @file{~/.folders}.
-The contents written in @file{~/.folders} become the folders which
-you subscribe to as it is.
-
You can skip this section because it is possible to add/edit the
subscribe folders from the buffer for list of folders.
+Define the folders you want to subscribe in file @file{~/.folders}. The
+contents written in @file{~/.folders} become the folders which you
+subscribe to as it is.
+
Format for @file{~/.folders} is very simple. Here is an example:
@example
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.editor.xemacs,-fj.editor.mule,-fj.editor.emacs "fj's Emacsen"
@end group
@end example
-Each line contains one folder you want to read. The definition of folders
-will be explained in detail in the next section.
+Each line contains one folder you want to read. The definition of
+folders will be explained in detail in the next section.
-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 collecting some folders and putting them
-in order.
+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
+collecting some folders and putting them in order.
Please note that @samp{@var{group name}@{} and @samp{@}} occupies one
line and you have to write it that way (It is because the parser sucks).
example which the user chooses his favorite folders as a group.
The other one is @dfn{access group} like @samp{+} from above example.
-It makes all the sub-folders in a folder to a group.
-(It differs from the type of the folder. For example, @samp{+} makes entire
- MH sub-directories to one group)
+It makes all the sub-folders in a folder to a group. (It differs from
+the type of the folder. For example, @samp{+} makes entire MH
+sub-directories to one group)
-This behavior is better understood if you try it and confirmed the function
-first. You can write and try a small folder definition, so you will know the
-idea of the folder function before writing the real one.
+This behavior is better understood if you try it and confirmed the
+function first. You can write and try a small folder definition, so you
+will know the idea of the folder function before writing the real one.
@node Start Wanderlust, , Folder Definition, Start Me Up
@section Start Wanderlust
@cindex Modified UTF7
@cindex UTF7
@cindex UTF8
+@cindex Unicode
@pindex Mule-UCS
@pindex ucs-conv
You can use international mailbox names in @var{mailbox} part, if you
are using Emacs which can treat unicode and
@code{elmo-imap4-use-modified-utf7} is set to non-nil value (default
-value is nil).
+value is @code{nil}).
Currently, following Emacsen can treat unicode.
@end group
@end example
-You also need utf7 conversion programs, @code{u7tou8} and @code{u8tou7}
-to use international mailbox name in the current XEmacs. These programs
-are included in the UTF7 package which can be obtained from following
-URL.
+You also need utf7 conversion programs, @command{u7tou8} and
+@command{u8tou7} to use international mailbox name in the current
+XEmacs. These programs are included in the UTF7 package which can be
+obtained from following URL.
@example
ftp://ftp.ifcss.org/pub/software/unix/convert/utf7.tar.gz
default:
@example
@var{hostname} -> The value of @code{elmo-default-nntp-server}.
- Initial setting is "localhost".
+ Initial setting is @samp{localhost}.
@var{username} -> The value of @code{elmo-default-nntp-user}.
- Initial setting is nil.
+ Initial setting is @code{nil}.
@var{port} -> The value of @code{elmo-default-nntp-port}.
Initial setting is 119.
@end 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
@example
@group
-+inbox -> "~/Mail/inbox"
-+from/teranisi -> "~/Mail/from/teranisi"
-+~/test -> "~/test"
++inbox -> @file{~/Mail/inbox}
++from/teranisi -> @file{~/Mail/from/teranisi}
++~/test -> @file{~/test}
@end group
@end example
(this is also true for drive-letters).
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} directory and not accessed for 36 hours are deleted.
+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}
+directory and not accessed for 36 hours are deleted.
This behavior conforms to the @uref{http://cr.yp.to/proto/maildir.html}.
@example
@group
-. -> "~/Maildir"
-.inbox -> "~/Maildir/inbox"
-.from/teranisi -> "~/Maildir/from/teranisi"
-.~/test -> "~/test"
+. -> @file{~/Maildir}
+.inbox -> @file{~/Maildir/inbox}
+.from/teranisi -> @file{~/Maildir/from/teranisi}
+.~/test -> @file{~/test}
@end group
@end example
@cindex @samp{=}
@pindex gnspool
-This folder handles locally saved news articles which are proposed by Mew/IM.
-You can also read articles directly from a spool-file which is retrieved
-by an utility like gnspool.
+This folder handles locally saved news articles which are proposed by
+Mew/IM. You can also read articles directly from a spool-file which is
+retrieved by an utility like @command{gnspool}.
Format:
@samp{=} @var{directory-name}
@end example
-@var{directory-name} is a sub-directory to the directory defined by variable
-@code{elmo-localnews-folder-path} (default is @file{~/News})
+@var{directory-name} is a sub-directory to the directory defined by
+variable @code{elmo-localnews-folder-path} (default is @file{~/News})
You can use @samp{.} as directory delimiter as well as @samp{/}.
Example:
@example
@group
-=fj/os/os2 -> "~/News/fj/os/os2"
-=fj.os.bsd.freebsd -> "~/News/fj/os/bsd/freebsd"
+=fj/os/os2 -> @file{~/News/fj/os/os2}
+=fj.os.bsd.freebsd -> @file{~/News/fj/os/bsd/freebsd}
@end group
@end example
(Initial setting is @code{zip}) is referred.
@var{prefix} specifies the internal directory structure of the archive.
-For example, if the ML server is fml, @file{msend.tar.gz} has a structure like
-@file{spool/1}, so you have to specify @samp{spool} as @var{prefix}.
+For example, if the ML server is fml, @file{msend.tar.gz} has a
+structure like @file{spool/1}, so you have to specify @samp{spool} as
+@var{prefix}.
Example:
@example
@group
-$teranisi -> "~/Mail/teranisi/elmo-archive.zip"
-$bsd/freebsd;lha -> "~/Mail/bsd/freebsd/elmo-archive.lzh"
-$/foo@@server:~/bar;zoo -> "~/bar/elmo-archive.zoo" on ftp server
-$d:/msend.tar.gz;tgz;spool -> "d:/msend.tar.gz"
+$teranisi -> @file{~/Mail/teranisi/elmo-archive.zip}
+$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}
@end group
@end example
If your archiver can include multiple files in one archive, you have a
possibility use it as an archiver of Wanderlust (ARJ/UNARJ, ARC is one
of the candidate. TAR is supported read-only because it cannot delete
-file in the archive ('mv)).
+file in the archive (@code{mv})).
-gzip, bzip, bzip2 cannot be used as an archiver of Wanderlust because
-they cannot include multiple files. Archivers that cannot extract files
-to standard output are also not supported.
+@command{gzip}, @command{bzip}, @command{bzip2} cannot be used as an
+archiver of Wanderlust because they cannot include multiple
+files. Archivers that cannot extract files to standard output are also
+not supported.
@subsection OS specific information about archiver.
* Caution about GNU tar
-You have to take care about GNU tar's version because
-many version has problem on deleting file from archive.
+You have to take care about GNU tar's version because many version has
+problem on deleting file from archive.
Please test @option{--delete} @option{-f} options work. Otherwise, your
archive will be destroyed. No problem is reported on above versions of
@item elmo-archive-lha-dos-compatible
@vindex elmo-archive-lha-dos-compatible
-The initial setting is t on OS/2 and Win32.
-If non-nil, LHA is DOS (Mr. Yoshizaki original) compatible.
+The initial setting is @code{t} on OS/2 and Win32. If non-nil, LHA is
+DOS (Mr. Yoshizaki original) compatible.
@item elmo-archive-cmdstr-max-length
@vindex elmo-archive-cmdstr-max-length
@env{LOGNAME} environment variable or return value of
@code{(user-login-name)}.
@var{authenticate-type} -> The value of @code{elmo-default-pop3-authenticate-type}.
- Initial setting is "user".
+ Initial setting is @samp{user}.
@var{hostname} -> The value of @code{elmo-default-pop3-server}.
- Initial setting is "localhost".
+ Initial setting is @samp{localhost}.
@var{port} -> The value of @code{elmo-default-pop3-port}.
Initial setting is 110.
@end example
@example
@group
-&hoge@@localhost -> access to localhost as user "hoge".
+&hoge@@localhost -> access to localhost as user @samp{hoge}.
&hoge@@popserver:109 -> access to the server "popserver" on port 109
- as user "hoge".
+ as user @samp{hoge}.
@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).
-
-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.
+(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.
@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
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
@xref{Message}.
-@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).
on the messages in the thread.
-@node Cache, Auto Refile, Thread Oparations, Summary
+@node Cache, Auto Refile, Thread Operations, Summary
@section Cache
@subsection Cache File
@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.
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
(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
@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
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
@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.
+@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.
+@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
@node Biff, Advanced Settings, Highlights, Customization
@section Notify Mail arrival
+@cindex Biff
Following setting is to notify mail arrival of @samp{%inbox}
by the indicator on the modeline
@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.
@node User-Agent Field, , Thread Format, Advanced Settings
@subsection User-Agent Field
+@cindex X-Mailer
+@cindex User-Agent
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:
(setq wl-generate-mailer-string-func
(function
(lambda ()
- (let ((mime-edit-insert-user-agent-field nil))
- (wl-generate-user-agent-string)))))
+ (concat "User-Agent: "
+ (wl-generate-user-agent-string-1 nil)))))
@end group
@end lisp
@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.
Currently they are picked up alphabetically from the top 40 hits of
U.S. Billboard magazines in 1980s.
-(@uref{http://www.summer.com.br/~pfilho/html/top40/index.html})
+(@uref{http://lyrics.natalnet.com.br/html/top40/index.html})
@node Index, , Addition, Top
projects / elisp / wanderlust.git / blobdiff