add section for summary line format.

diff --git a/doc/wl-ja.texi b/doc/wl-ja.texi
index 18309b9..908ac40 100644 (file)
--- a/doc/wl-ja.texi
+++ b/doc/wl-ja.texi
@@ -2497,6 +2497,7 @@ Non-nil \e$B$J$i\e(B @code{wl-fldmgr-add} \e$B$NJd408uJd$r\e(B
 * Cache::                       \e$B%-%c%C%7%e$H@hFI$_5!G=\e(B
 * Auto Refile::                 \e$B<+F0%j%U%!%$%k\e(B
 * Sticky Summary::              \e$B%9%F%#%C%-!<%5%^%j\e(B
+* Summary View::                \e$B%5%^%j9T$N7A<0\e(B
 * Key Bindings of Summary::     \e$B%-!<%P%$%s%I\e(B
 * Variables of Summary::        \e$B%+%9%?%^%$%:JQ?t\e(B
 @end menu
@@ -2839,7 +2840,7 @@ Non-nil \e$B$G$"$l$P%U%)%k%@$K0\F0$7$?;~$K:G=i$N%a%C%;!<%8$r<+F0E*$K@hFI$_$7$^$9!
 \e$B$NMM$K\e(B @code{wl-summary-auto-refile-skip-marks} \e$B$r\e(B @code{nil} \e$B$K$7$^$9!#\e(B
 
 
-@node Sticky Summary, Key Bindings of Summary, Auto Refile, Summary
+@node Sticky Summary, Summary View, Auto Refile, Summary
 @section \e$B%9%F%#%C%-!<%5%^%j\e(B
 @cindex Summary, Sticky
 @cindex Sticky Summary
@@ -2868,7 +2869,64 @@ Non-nil \e$B$G$"$l$P%U%)%k%@$K0\F0$7$?;~$K:G=i$N%a%C%;!<%8$r<+F0E*$K@hFI$_$7$^$9!
 \e$B$H$9$k$3$H$b$G$-$^$9!#\e(B
 
 
-@node Key Bindings of Summary, Variables of Summary, Sticky Summary, Summary
+@node Summary View, Key Bindings of Summary, Sticky Summary, Summary
+@section \e$B%5%^%j9T$N7A<0\e(B
+@cindex Format of summary lines
+
+\e$B%5%^%j9T$N7A<0$O!"$"$kDxEY<+M3$KJQ99$G$-$^$9!#\e(B
+
+\e$B%5%^%j9T$N7A<0$rJQ99$9$k$K$O\e(B @code{wl-summary-line-format} \e$B$r@_Dj$7$^$9!#\e(B
+@code{wl-summary-line-format-spec-alist} \e$B$GDj5A$5$l$?=q<0$rMQ$$$^$9!#\e(B
+\e$B$=$N:]$NCm0U$H$7$F!"\e(B@code{wl-summary-line-format} \e$B$K$O0l;~E*%^!<%/\e(B(@samp{%T})
+\e$B$H1JB3E*%^!<%/\e(B(@samp{%P})\e$B$r$=$l$>$lDj0LCV$J$k$h$&$KI,$:4^$a$k$h$&$K$7$F2<$5$$!#\e(B
+\e$B0J2<$KNc$r<($7$^$9!#\e(B
+
+@lisp
+@group
+;; @r{\e$BHV9f\e(B \e$B0l;~%^!<%/\e(B \e$B1JB3%^!<%/\e(B \e$BF|IU\e(B \e$B;^\e(B [ (\e$B;R$N?t\e(B) \e$B:9=P?M\e(B ] \e$B7oL>\e(B}
+(setq wl-summary-line-format "%n%T%P%M/%D(%W) %t%[%17(%c %f%) %] %s")
+@end lisp
+@end group
+
+\e$B?t;z$O7e?t$rI=$7$^$9\e(B(\e$BIi$N?t$N>l9g!"1&5M$a$K$J$j$^$9\e(B)
+
+\e$B%G%U%)%k%H$N\e(B @code{wl-summary-line-format-spec-alist} \e$B$GMQ0U$5$l$F$$$k\e(B
+\e$B=q<05-9f$N$&$A<g$J$b$N$O0J2<$NDL$j$G$9!#\e(B
+
+@example
+@group
+%n  \e$B%a%C%;!<%8HV9f\e(B
+%Y  \e$BG/\e(B
+%M  \e$B7n\e(B
+%D  \e$BF|\e(B
+%W  \e$BMKF|\e(B
+%h  \e$B;~\e(B
+%m  \e$BJ,\e(B
+%t  \e$B%9%l%C%I$N;^\e(B
+%[  [ (\e$B7R$.D>$7$?;R$N>l9g$O\e(B <)
+%]  ] (\e$B7R$.D>$7$?;R$N>l9g$O\e(B >)
+%s  \e$B7oL>\e(B
+%S  \e$B%5%$%:\e(B
+%c  +\e$B;R$N?t\e(B: (\e$B%9%l%C%I$r3+$$$?;~$N$_I=<(\e(B)
+%C  [+\e$B;R$N?t\e(B] (\e$B%9%l%C%I$r3+$$$?;~$N$_I=<(\e(B)
+@end example
+@end group
+
+@code{wl-folder-summary-line-format-alist} \e$B$r@_Dj$9$k$H!"\e(B
+\e$B%5%^%j9T$N7A<0$r%U%)%k%@Kh$K;XDj$9$k$3$H$,$G$-$^$9!#\e(B
+\e$B0J2<$NNc$N$h$&$K!"%U%)%k%@L>$N@55,I=8=$H%5%^%j9T$N=q<0$r;XDj\e(B
+\e$B$7$F2<$5$$!#\e(B
+
+@lisp
+@group
+(setq wl-folder-summary-line-format-alist
+      '(("^%" . "%T%P%M/%D(%W)%h:%m %t%[%17(%c %f%) %] %s")
+        ("^+" . "%n%T%P%M/%D %[ %17f %] %t%C%s")))
+@end group
+@end lisp
+
+
+@node Key Bindings of Summary, Variables of Summary, Summary View, Summary
 @section \e$B%-!<%P%$%s%I\e(B
 @cindex Keybind, Summary Mode
 @cindex Keybind, Summary Buffer

diff --git a/doc/wl.texi b/doc/wl.texi
index a716ff4..60c0f28 100644 (file)
--- a/doc/wl.texi
+++ b/doc/wl.texi
@@ -2500,6 +2500,7 @@ mode.
 * Cache::                       File cache, Buffer cache, and Prefetch
 * Auto Refile::                 Auto refile settings
 * Sticky Summary::              Summary make sticky
+* Summary View::                Format of summary lines
 * Key Bindings of Summary::     Key bindings
 * Variables of Summary::        Customize Summary Mode
 @end menu
@@ -2852,7 +2853,7 @@ To execute auto refile on all messages, set following.
 @end lisp
 
 
-@node Sticky Summary, Key Bindings of Summary, Auto Refile, Summary
+@node Sticky Summary, Summary View, Auto Refile, Summary
 @section Sticky Summary
 @cindex Summary, Sticky
 @cindex Sticky Summary
@@ -2880,7 +2881,66 @@ are same as normal summary.
 are automatically stuck.
 
 
-@node Key Bindings of Summary, Variables of Summary, Sticky Summary, Summary
+@node Summary View, Key Bindings of Summary, Sticky Summary, Summary
+@section Format of summary lines
+@cindex Format of summary lines
+You can alter the format of lines in Summary mode.
+
+Summary line format is specified by @code{wl-summary-line-format}.
+You can use control strings defined by
+@code{wl-summary-line-format-spec-alist}.
+Note that @code{wl-summary-line-format} must contain
+temporary mark (@samp{%T}) and permanent mark(@samp{%P}) at
+constant positions respectively. An example follows.
+
+@lisp
+@group
+;; @r{number temporary-mark permanent-mark date branch}
+;; @r{[ (number-of-children) sender ] subject}
+(setq wl-summary-line-format "%n%T%P%M/%D(%W) %t%[%17(%c %f%) %] %s")
+@end lisp
+@end group
+
+Where the number set the column number of the field (for negative value,
+filled from right)
+
+Major control strings defined by @code{wl-summary-line-format-spec-alist}
+are displayed in the following list.
+
+@example
+@group
+%n  message number
+%Y  year
+%M  month
+%D  day
+%W  day of week
+%h  hour
+%m  minute
+%t  branch of the thread
+%[  [ (< for re-connected child)
+%]  ] (> for re-connected child)
+%s  subject
+%S  size
+%c  +number-of-children: (display only for opened thread)
+%C  [+number-of-children] (display only for opened thread)
+@end example
+@end group
+
+You can specify the format by each folders with
+@code{wl-folder-summary-line-format-alist}.
+Please set regular expression for folder names and summary
+line format as the following example.
+
+@lisp
+@group
+(setq wl-folder-summary-line-format-alist
+      '(("^%" . "%T%P%M/%D(%W)%h:%m %t%[%17(%c %f%) %] %s")
+        ("^+" . "%n%T%P%M/%D %[ %17f %] %t%C%s")))
+@end group
+@end lisp
+
+
+@node Key Bindings of Summary, Variables of Summary, Summary View, Summary
 @section Key bindings
 @cindex Keybind, Summary Mode
 @cindex Keybind, Summary Buffer