* Minimal Settings:: @file{.emacs} \e$B$N@_Dj\e(B
* Folder Definition:: \e$B9XFI$9$k%U%)%k%@$NDj5A\e(B
* Start Wanderlust:: Wanderlust \e$B$N5/F0\e(B
+* Overview:: \e$B354Q\e(B
@end menu
@subsection \e$BDL>o$N%$%s%9%H!<%k\e(B
-@file{Makefile} \e$B$O\e(B @code{LISPDIR}, @code{EMACS} \e$B$N$"$?$j$rJT=8$7$^$9!#\e(B
+@file{Makefile} \e$B$N\e(B @code{LISPDIR}, @code{EMACS} \e$B$N$"$?$j$rJT=8$7$^$9!#\e(B
@code{LISPDIR} \e$B$K$O%Q%C%1!<%8$N%$%s%9%H!<%k@h!"\e(B
@code{EMACS} \e$B$K$OMxMQ$9$k\e(B Emacs \e$B$N%3%^%s%IL>$r;XDj$7$^$9!#\e(B
@file{Makefile} \e$BCf$N\e(B @code{LISPDIR} \e$B$rJQ99$;$:!"\e(B
\e$B$=$N$^$^\e(B(@samp{NONE} \e$B$N$^$^$G$b\e(B)\e$B%$%s%9%H!<%k$7$?>l9g!"\e(B
-\e$B<+F0E*$K%$%s%9%H!<%k@h$rE,Ev$K8!=P$7$^$9!#\e(B
+\e$BE,Ev$J%$%s%9%H!<%k@h$r<+F0E*$K8!=P$7$^$9!#\e(B
\e$B<B:]$N%$%s%9%H!<%k@h$K$D$$$F$O8e=R$7$^$9!#\e(B
Mule 2.3 \e$B$J$I!"\e(B@file{subdirs.el} \e$B$,L5$/!"\e(B@code{load-path} \e$B$K%5%V%G%#%l%/%H%j$,\e(B
\e$B%j$N\e(B @file{WL-CFG} \e$B$H$$$&%U%!%$%kCf$G\e(B@code{load-path} \e$B$rDL$7$F$*$/$HNI$$\e(B
\e$B$G$7$g$&!#\e(B
-\e$B$^$?!"\e(BBBDB \e$B$rMxMQ$7$?$$>l9g!"\e(BBBDB \e$B$X$b\e(B @code{load-path} \e$B$rDL$7$F$*$/$HI,\e(B
-\e$BMW$J%b%8%e!<%k$,%P%$%H%3%s%Q%$%k\e(B/\e$B%$%s%9%H!<%k$5$l$^$9!#\e(B@xref{BBDB}.
+\e$B$^$?!"?7J9%U%)%k%@$rMxMQ$9$k>l9g$d!"\e(BBBDB \e$B$rMxMQ$9$k>l9g$K$O!"$=$l$>$l\e(B
+emacs-w3m\e$B!"\e(BBBDB \e$B$,%$%s%9%H!<%k$5$l$F$$$k%G%#%l%/%H%j$K\e(B @code{load-path}
+\e$B$rDL$7$F$*$/$HI,MW$J%b%8%e!<%k$,%P%$%H%3%s%Q%$%k\e(B/\e$B%$%s%9%H!<%k$5$l$^$9!#\e(B
+@xref{Shimbun Folder}, @xref{BBDB}.
@subsection @file{WL-CFG}
@lisp
@group
-;; @r{SEMI \e$B$r;H$&$?$a$N@_Dj\e(B}
-(require 'mime-setup)
-
;; @r{autoload \e$B$N@_Dj\e(B}
;; @r{(XEmacs \e$B$N\e(B package \e$B$H$7$F%$%s%9%H!<%k$7$?>l9g$OI,MW$"$j$^$;$s\e(B)}
(autoload 'wl "wl" "Wanderlust" t)
\e$B$&!#\e(Bface \e$B$N@_Dj$O\e(B @file{~/.emacs} \e$B$K=q$/$3$H$O$G$-$J$$$N$G\e(B@file{~/.wl}
\e$B$K=q$$$F$/$@$5$$!#\e(B@xref{Highlights}.
-\e$B>e5-$N$&$A!"\e(B@samp{(require 'mime-setup)} \e$B$H\e(B @code{autoload} \e$B$N@_Dj$O\e(B
-@file{~/.emacs} \e$B$K=q$/I,MW$,$"$j$^$9!#$=$l0J30$N@_Dj$O\e(B @file{~/.wl} \e$B$K5-\e(B
-\e$B=R$G$-$^$9!#\e(B
+\e$B>e5-$N$&$A!"\e(B@code{autoload} \e$B$N@_Dj$O\e(B @file{~/.emacs} \e$B$K=q$/I,MW$,$"$j$^$9!#\e(B
+\e$B$=$l0J30$N@_Dj$O\e(B @file{~/.wl} \e$B$K5-=R$G$-$^$9!#\e(B
@subsection @code{mail-user-agent}
@cindex Default Mailer
@vindex mail-user-agent
@findex compose-mail
-\e$B0J2<$N$h$&$J@_Dj$r\e(B @file{.emacs} \e$BEy$K$7$F$*$/$H!"\e(B@kbd{C-x m}
-(@code{compose-mail}) \e$BEy$K$h$C$F\e(B Wanderlust \e$B$N%I%i%U%H%b!<%I$r5/F0$9$k\e(B
+\e$B0J2<$N$h$&$J@_Dj$r\e(B @file{~/.emacs} \e$B$K$7$F$*$/$H!"\e(B@kbd{C-x m}
+(@code{compose-mail}) \e$B$K$h$C$F\e(B Wanderlust \e$B$N%I%i%U%H%b!<%I$r5/F0$9$k\e(B
\e$B$h$&$K$J$j$^$9!#\e(BWanderlust \e$B$r\e(B Emacs \e$B>e$NI8=`%a!<%i$H$7$F;H$$$?$$>l9g$O@_\e(B
\e$BDj$7$F$*$/$HNI$$$G$7$g$&!#$?$@$7!"$3$l$O\e(B @code{mail-user-agent} \e$B$NDj5A$,\e(B
\e$B2DG=$J\e(B Emacsen \e$B$N>l9g$N$_M-8z$G$9!#\e(B
\e$B$&$KD>@\<+J,$G9%$-$J%U%)%k%@$r%0%k!<%W$H$7$FDj5A$9$k%?%$%W$G$9!#\e(B
\e$B$b$&0l$D$O!">e$NNc$N\e(B @samp{+ /} \e$B$N$h$&$J\e(B @dfn{\e$B%"%/%;%9%0%k!<%W\e(B} \e$B$G$9!#$3$l\e(B
-\e$B$O!"$"$k%U%)%k%@$K4^$^$l$k%5%V%U%)%k%@A4$F$r0l$D$N%0%k!<%W$H$9$k$b$N$G$9!#\e(B
-(\e$B$3$l$O%U%)%k%@$N%?%$%W$K$h$C$F0c$$$^$9!#Nc$($P\e(B @samp{+ /} \e$B$J$i\e(B MH \e$B$N%5%V\e(B
-\e$B%G%#%l%/%H%j$9$Y$F$,$R$H$D$N%0%k!<%W$H$J$j$^$9!#\e(B)
+\e$B$O!"$"$k%U%)%k%@$K4^$^$l$k%5%V%U%)%k%@A4$F$r$^$H$a$F0l$D$N%0%k!<%W$H$9$k$b$N\e(B
+\e$B$G$9!#\e(B(\e$B$=$NF0:n$O%U%)%k%@$N%?%$%W$K$h$C$F0[$J$j$^$9!#Nc$($P\e(B @samp{+ /} \e$B$J$i\e(B
+MH \e$B$N%5%V%G%#%l%/%H%j$9$Y$F$,$R$H$D$N%0%k!<%W$H$J$j$^$9!#\e(B)
\e$B<B:]$K;n$7$F$_$F!"3NG'$7$F$+$i$NJ}$,$o$+$j$d$9$$$+$b$7$l$^$;$s!#\e(B
\e$B$A$g$C$H=q$$$F;n$7$F$_$F$+$i!"$^$?%U%)%k%@$NDj5A$r$d$jD>$9$HNI$$$G$7$g$&!#\e(B
-@node Start Wanderlust, , Folder Definition, Start Me Up
+@node Start Wanderlust, Overview, Folder Definition, Start Me Up
@section Wanderlust \e$B$N5/F0\e(B
@cindex Start Wanderlust
@kbd{C-u M-x wl} \e$B$N$h$&$K\e(B prefix argument \e$B$D$-$G<B9T$9$k$H!"\e(B
\e$B%U%)%k%@$N%A%'%C%/$r>JN,$7$F5/F0$7$^$9!#\e(B
-Wanderlust \e$B$G$O4pK\E*$K<!$K5s$2$k%P%C%U%!$r8_$$$K9T$-Mh$7$J$,$i%a%C%;!<%8$r\e(B
-\e$B<h$j07$$$^$9!#\e(B
+
+@node Overview, , Start Wanderlust, Start Me Up
+@section \e$B354Q\e(B
+@cindex Overview
+
+Wanderlust \e$B$G$O4pK\E*$K!"<!$K5s$2$k%P%C%U%!$r8_$$$K9T$-Mh$7$J$,$i%a%C%;!<%8\e(B
+\e$B$r<h$j07$$$^$9!#$=$l$>$l$N>\:Y$K$D$$$F$O0J2<$N3F>O$G@bL@$7$^$9!#\e(B
@table @samp
@item \e$B%U%)%k%@%P%C%U%!\e(B
\e$B%a%C%;!<%8$NJT=8$r9T$$$^$9!#\e(B
@end table
-\e$B$=$l$>$l$N>\:Y$K$D$$$F$O0J2<$G@bL@$7$^$9!#\e(B
-
@node Folders, Folder, Start Me Up, Top
@chapter Wanderlust \e$B$G07$($k%U%)%k%@$?$A\e(B
@end example
@noindent
-\e$B$r=g$KI=<($7$F$$$^$9!#8=:_$N%P!<%8%g%s$G$OI=<($NJQ99$O$G$-$^$;$s!#\e(B
+\e$B$r=g$KI=<($7$F$$$^$9!#I=<(7A<0$NJQ99$K$D$$$F$O!"%5%^%j9T$N7A<0$N@a$r\e(B
+\e$B;2>H$7$F2<$5$$!#\e(B@xref{Summary View}.
@var{\e$B%a%C%;!<%8HV9f\e(B}\e$B$O$=$N%U%)%k%@Cf$K$"$k%a%C%;!<%8$KBP$9$k%i%Y%k$G$9!#\e(B
News \e$B%U%)%k%@$G$O\e(B article \e$BHV9f!"\e(BIMAP \e$B%U%)%k%@$G$O\e(B UID\e$B!"\e(BMH \e$B%U%)%k%@$G$O%U%!\e(B
@item l
@kindex l (Message)
@findex wl-message-toggle-disp-summary
-\e$B%5%^%j%b!<%I%P%C%U%!$rI=<($9$k$+$I$&$+$r%H%0%k$7$^$9!#\e(B
+\e$B%5%^%j%P%C%U%!$rI=<($9$k$+$I$&$+$r%H%0%k$7$^$9!#\e(B
(@code{wl-message-toggle-disp-summary})
@item Button-2
@node Send Messages off-line, Re-file and Copy queue, Enable Operations, Enable Operations
@subsection \e$B%a%C%;!<%8$NAw?.\e(B
-\e$B%*%U%i%$%s>uBV$G%a!<%k\e(B/\e$B%K%e!<%95-;v$rAw?.$G$-$^$9!#\e(B(@file{im-wl.el} \e$B$r$*\e(B
-\e$B;H$$$N>l9g$O!"4X78$"$j$^$;$s!#\e(B)\e$B%*%U%i%$%s$N$H$-$KAw?.$5$l$?%a%C%;!<%8$O\e(B
-\e$B%-%e!<%U%)%k%@\e(B @samp{+queue} \e$B$KN/$j$^$9!#N/$C$?%a%C%;!<%8$O!"%*%s%i%$%s\e(B
-\e$B$K$J$C$?$H$-$K0l5$$KAw?.$5$l$^$9!#\e(B
+\e$B%*%U%i%$%s>uBV$G%a!<%k\e(B/\e$B%K%e!<%95-;v$NAw?.A`:n$r$9$k$H!"Aw?.$NM=Ls$,$5$l\e(B
+\e$B$^$9!#\e(B(@file{im-wl.el} \e$B$r$*;H$$$N>l9g$O!"4X78$"$j$^$;$s!#\e(B) \e$B%*%U%i%$%s$N\e(B
+\e$B$H$-$KAw?.M=Ls$5$l$?%a%C%;!<%8$O%-%e!<%U%)%k%@\e(B @samp{+queue} \e$B$KN/$j$^$9!#\e(B
+\e$BN/$C$?%a%C%;!<%8$O!"%*%s%i%$%s$K$J$C$?$H$-$K0l5$$KAw?.$5$l$^$9!#\e(B
\e$B%*%U%i%$%s$N$&$A$K\e(B @samp{+queue} \e$B$rK,$l$F!"%-%e!<$K$"$k%a%C%;!<%8$NFbMF\e(B
\e$B$r3NG'$G$-$^$9!#%a%C%;!<%8$r:o=|$9$k$3$H$b2DG=$G$9!#\e(B(\e$B:o=|$5$l$?%a%C%;!<\e(B
* Minimal Settings:: @file{.emacs} setup
* Folder Definition:: Folder definition
* Start Wanderlust:: Starting Wanderlust
+* Overview:: Basic components of Wanderlust
@end menu
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}.
-@xref{BBDB}.
+If you want to handle shimbun folders or to use BBDB, add directory
+where emacs-w3m or BBDB is installed to @code{load-path}. Then necessary
+modules will be byte-compiled and installed.
+@xref{Shimbun Folder}, @xref{BBDB}.
@subsection @file{WL-CFG}
@lisp
@group
-;; @r{The setting to use SEMI}
-(require 'mime-setup)
-
;; @r{autoload configuration}
;; @r{(Not required if you have installed Wanderlust as XEmacs package)}
(autoload 'wl "wl" "Wanderlust" t)
(if you write it to @file{.emacs}, you'll get an error).
@xref{Highlights}.
-All above described settings except @samp{(require 'mime-setup)} and autoload
-configuration can be written in
-@file{~/.wl}).
+All above described settings except autoload configuration can be written
+in @file{~/.wl}).
@subsection @code{mail-user-agent}
@cindex Default Mailer
@vindex mail-user-agent
@findex compose-mail
-If you write following setting in you @file{.emacs}, you can
+If you write following setting in your @file{~/.emacs}, you can
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.
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{+} followed by @samp{/}
-makes entire MH sub-directories to one group)
+It collects all sub-folders in the folder to make a group. (Its
+behavior differs by the type of the folder. For example, @samp{+}
+followed by @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.
-@node Start Wanderlust, , Folder Definition, Start Me Up
+@node Start Wanderlust, Overview, Folder Definition, Start Me Up
@section Start Wanderlust
@cindex Start Wanderlust
@end example
@noindent
-After initialization, Folder Mode which shows the list of folders will appear.
-That means the folders you defined in the @file{~/.folders} are listed
+After initialization, Folder Mode which shows the list of folders will
+appear. That means the folders you defined in the @file{~/.folders} are
+listed.
+
If you start Wanderlust with prefix argument like @kbd{C-u M-x wl}, you
can skip folder checking.
+
+@node Overview, , Start Wanderlust, Start Me Up
+@section Overview
+@cindex Overview
+
Basically, you will handle messages in wanderlust while you come and go
-from/to each of the following buffers.
+from/to each of the following buffers. Details of each ones are
+explained in following chapters.
@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.
+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.
+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
@end example
@noindent
-You cannot change this in the current version.
+If you want to know how to change the format for this, please refer
+the section format of Summary lines.
+@xref{Summary View}.
@var{Message number} is the message's unique number in the folder. In
the NNTP folder, it is article number, in the IMAP folder, it is UID and
@item l
@kindex l (Message)
@findex wl-message-toggle-disp-summary
-Toggles display of Summary mode buffer.
+Toggles display of Summary buffer.
(@code{wl-message-toggle-disp-summary})
@item Button-2
@node Send Messages off-line, Re-file and Copy queue, Enable Operations, Enable Operations
@subsection Transmission of Messages
-You can send mail/news messages off-line (if you are using
-@file{im-wl.el}, it is irrelevant). Messages sent off-line are
-accumulated in the queue folder, @samp{+queue}. These messages are
-transmitted at once when Wanderlust becomes on-line.
+You can proceed sending operation for mail/news messages while you are
+off-line, then it will be reserved for sending (if you are using
+@file{im-wl.el}, it is irrelevant).
+Messages reserved for sending while off-line are accumulated in the
+queue folder, @samp{+queue}. These messages are transmitted at once when
+Wanderlust becomes on-line.
You can visit @samp{+queue} in the off-line state and confirm content of
messages in the queue. You can also remove messages. Removed messages
projects / elisp / wanderlust.git / commitdiff