Added more description about summary view.

diff --git a/doc/wl-ja.texi b/doc/wl-ja.texi
index 0dcb48c..38c277a 100644 (file)
--- a/doc/wl-ja.texi
+++ b/doc/wl-ja.texi
@@ -2877,8 +2877,6 @@ 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%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
@@ -2910,13 +2908,31 @@ 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!
 %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)
+%T  \e$B0l;~E*%^!<%/\e(B(\e$BI,?\\e(B)
+%P  \e$B1JB3E*%^!<%/\e(B(\e$BI,?\\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
+@code{wl-summary-line-format} \e$B$K$O!$0l;~E*%^!<%/\e(B(@samp{%T}) \e$B$H1JB3E*%^!<\e(B
+\e$B%/\e(B(@samp{%P})\e$B$O$=$l$>$lI,$:4^$a$J$1$l$P$J$j$^$;$s!#$^$?!"$3$l$i$O!"I,$:\e(B
+\e$B0lDj$N0LCV$KI=<($5$l$k$h$&$KDj5A$7$J$1$l$P$J$j$^$;$s!#Nc$($P!"%9%l%C%I$K\e(B
+\e$B$h$C$FD9$5$,JQ$o$k\e(B @samp{%t} \e$B$N$&$7$m$K\e(B @samp{%T} \e$B$d\e(B @samp{%P} \e$B$rI=<($9\e(B
+\e$B$k$h$&$K$7$F$7$^$&$H!"@5$7$/%^!<%/=hM}$r9T$J$($J$/$J$k2DG=@-$,$"$j$^$9!#\e(B
+
+\e$B$^$?!$\e(B@samp{%\e$B?t;z\e(B(}, @samp{%)} \e$B$G0O$s$@HO0O$O!$\e(B'\e$B?t;z\e(B'\e$B$N7e?t$K$J$j$^$9\e(B(\e$BF~\e(B
+\e$B$l;R$b2D\e(B)\e$B!#J#?t$N=q<05-9f$KBP$9$kI}$r@_Dj$9$k$H$-$K;H$$$^$9!#Nc$($P!">e\e(B
+\e$B5-Nc$N\e(B
+
+@example
+%17(%c %f%)
+@end example
+
+\e$B$H$$$&;XDj$O!"!X!V;R$N?t!W$H!V:9=P?M!W$r$D$J$2$?J8;zNs$r\e(B 17 \e$B7e$K$9$k!Y$H\e(B
+\e$B$$$&0UL#$G$9!#\e(B
+
+\e$B$^$?!"\e(B@code{wl-folder-summary-line-format-alist} \e$B$r@_Dj$9$k$H!"%5%^%j9T\e(B
+\e$B$N7A<0$r%U%)%k%@Kh$K;XDj$9$k$3$H$,$G$-$^$9!#0J2<$NNc$N$h$&$K!"%U%)%k%@L>\e(B
+\e$B$N@55,I=8=$H%5%^%j9T$N=q<0$r;XDj$7$F2<$5$$!#\e(B
 
 @lisp
 @group
@@ -2926,7 +2942,6 @@ 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!
 @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

diff --git a/doc/wl.texi b/doc/wl.texi
index 02bce4d..504a9f1 100644 (file)
--- a/doc/wl.texi
+++ b/doc/wl.texi
@@ -2889,13 +2889,12 @@ 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.
+
+An example follows.
 
 @lisp
 @group
-;; @r{number temporary-mark permanent-mark date branch}
+;; @r{number temporary-mark persistent-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
@@ -2924,13 +2923,33 @@ are displayed in the following list.
 %S  size
 %c  +number-of-children: (display only for opened thread)
 %C  [+number-of-children] (display only for opened thread)
+%T  temporary mark (mandatory)
+%P  persistent mark (mandatory)
 @end example
 @end group
 
+@code{wl-summary-line-format} must contain temporary mark (@samp{%T})
+and persistent mark (@samp{%P}). Furthermore, these marks must appear at
+the constant column. For example, if you specify @samp{%T} or
+@samp{%P} after the @samp{%t}, which changes its length by thread
+position, marks are not treated correctly.
+
+If the format string is enclosed by @samp{%number(} and @samp{%)}, the
+column of the enclosed region is justified to the `number'. Multiple
+level @samp{%number(} parenthesis can be defined.  It is useful to
+justify the column of the multiple control strings.  For example, in the
+above @code{wl-summary-line-format},
+
+@example
+%17(%c %f%)
+@end example
+
+means ``Adjust number-of-children and sender string to the 17 column''.
+
 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.
+@code{wl-folder-summary-line-format-alist}.  Please set regular
+expression for folder names and summary line format as the following
+example.
 
 @lisp
 @group