add section: Password Management

diff --git a/doc/wl-ja.texi b/doc/wl-ja.texi
index 5434be7..a966bd5 100644 (file)
--- a/doc/wl-ja.texi
+++ b/doc/wl-ja.texi
@@ -7445,6 +7445,7 @@ overview \e$B>pJs$K4^$^$l$J$$%U%#!<%k%I$r8!::$NBP>]$H$9$k>l9g!"\e(B
 * Living with other packages::  \e$B%Q%C%1!<%8$N$"$k@83h\e(B
 * Highlights::                  \e$B%O%$%i%$%H$N@_Dj\e(B
 * Biff::                        \e$B%a!<%k$NCe?.$rCN$i$;$k\e(B
+* Password Management::         \e$B%Q%9%o!<%I$N4IM}\e(B
 * Advanced Settings::           \e$B%+%9%?%^%$%:!A1~MQJT!A\e(B
 * Customizable Valiables::      \e$B$=$NB>$N%+%9%?%^%$%:JQ?t0lMw\e(B
 * Hooks::                       \e$B%U%C%/\e(B
@@ -7971,7 +7972,7 @@ face \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$
 @end table
 
 
-@node Biff, Advanced Settings, Highlights, Customization
+@node Biff, Password Management, Highlights, Customization
 @section \e$B%a!<%k$NCe?.$rCN$i$;$k\e(B
 @cindex Biff
 
@@ -8014,7 +8015,39 @@ face \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$
 @end table
 
 
-@node Advanced Settings, Customizable Valiables, Biff, Customization
+@node Password Management, Advanced Settings, Biff, Customization
+@section \e$B%Q%9%o!<%I$N4IM}\e(B
+
+\e$B%5!<%P$K@\B3$9$k0Y$KF~NO$7$?%Q%9%o!<%I$OJQ?t\e(B @code{elmo-passwd-alist} \e$B$K\e(B
+\e$B@\B3Kh$KJ];}$5$l$^$9!#$3$NJQ?t$K$O%(%s%3!<%I$5$l$?@8$N%Q%9%o!<%I$,J];}$5\e(B
+\e$B$l$F$*$j!"\e(BEmacs \e$B$rB>?M$K?($i$l$k$H%Q%9%o!<%I$r8+$i$l$k4m81@-$,$"$k$N$G==\e(B
+\e$BJ,$KCm0U$7$F2<$5$$!#\e(B
+
+\e$B%Q%9%o!<%I$,J];}$5$l$F$$$k>uBV$G\e(B @kbd{M-x elmo-passwd-alist-save} \e$B$r<B9T\e(B
+\e$B$9$k$H%Q%9%o!<%I$,%U%!%$%k$KJ]B8$5$l!"%Q%9%o!<%I$NF~NO$,ITMW$K$J$j$^$9!#\e(B
+\e$B$3$N>l9g!"%-!<F~NO$rEp$_8+$i$l$k4m81@-$O8:$k$+$b$7$l$^$;$s$,!"@8$N%Q%9%o\e(B
+\e$B!<%I$,%U%!%$%k$KJ]B8$5$l$k$N$G!"$=$N07$$$K$O==J,Cm0U$7$F2<$5$$!#%U%!%$%k\e(B
+\e$B$KJ]B8$5$l$?%Q%9%o!<%I$r>C5n$9$k$K$O\e(B @kbd{M-x elmo-passwd-alist-clear}
+\e$B$N8e!"\e(B@kbd{M-x elmo-passwd-alist-save} \e$B$r<B9T$7$F2<$5$$!#\e(B
+
+@table @code
+@item elmo-passwd-alist-file-name
+@vindex  elmo-passwd-alist-file-name
+\e$B=i4|@_Dj$O\e(B @file{passwd}\e$B!#\e(B
+\e$B%Q%9%o!<%I$r%;!<%V$7$F$*$/%U%!%$%k$NL>A0$G$9!#\e(B
+\e$B%3%^%s%I\e(B @code{elmo-passwd-alist-save} \e$B$r<B9T$9$k$H$3$N%U%!%$%k$K8=:_@_Dj\e(B
+\e$B$5$l$F$$$k%Q%9%o!<%I$,%;!<%V$5$l$^$9!#\e(B
+
+@item elmo-passwd-life-time
+@vindex  elmo-passwd-life-time
+\e$B=i4|@_Dj$O\e(B @code{nil}\e$B!#\e(B
+Non-nil \e$B$JCM$,@_Dj$5$l$?>l9g$O!"?75,$K%Q%9%o!<%I$,F~NO$5$l$F$+$i\e(B
+@code{elmo-passwd-life-time} \e$BIC8e$K%Q%9%o!<%I$r>C5n$9$k%?%$%^$,!"\e(B
+\e$B%;%C%H$5$l$^$9!#\e(B@code{nil} \e$B$N>l9g$OF~NO$5$l$?%Q%9%o!<%I$r>C5n$7$^$;$s!#\e(B
+@end table
+
+
+@node Advanced Settings, Customizable Valiables, Password Management, Customization
 @section \e$B%+%9%?%^%$%:!A1~MQJT!A\e(B
 
 @menu
@@ -8419,20 +8452,6 @@ XEmacs \e$B$N$_M-8z$G$9!#=i4|@_Dj$O!"\e(BXEmacs \e$B$K0MB8$7$^$9!#\e(B
 (dbm \e$B$N5!G=$r$b$D\e(B XEmacs \e$B$J$i$P\e(B @code{t} \e$B$H$J$j$^$9!#\e(B)
 Non-nil \e$B$J$i$P\e(B dbm \e$B$r;H$C$F\e(B Message-ID \e$B$N4IM}$r9T$J$$$^$9!#\e(B
 
-@item elmo-passwd-alist-file-name
-@vindex  elmo-passwd-alist-file-name
-\e$B=i4|@_Dj$O\e(B @file{passwd}\e$B!#\e(B
-\e$B%Q%9%o!<%I$r%;!<%V$7$F$*$/%U%!%$%k$NL>A0$G$9!#\e(B
-\e$B%3%^%s%I\e(B @code{elmo-passwd-alist-save} \e$B$r<B9T$9$k$H$3$N%U%!%$%k$K8=:_@_Dj\e(B
-\e$B$5$l$F$$$k%Q%9%o!<%I$,%;!<%V$5$l$^$9!#\e(B
-
-@item elmo-passwd-life-time
-@vindex  elmo-passwd-life-time
-\e$B=i4|@_Dj$O\e(B @code{nil}\e$B!#\e(B
-Non-nil \e$B$JCM$,@_Dj$5$l$?>l9g$O!"?75,$K%Q%9%o!<%I$,F~NO$5$l$F$+$i\e(B
-@code{elmo-passwd-life-time} \e$BIC8e$K%Q%9%o!<%I$r>C5n$9$k%?%$%^$,!"\e(B
-\e$B%;%C%H$5$l$^$9!#\e(B
-
 @item elmo-nntp-list-folders-use-cache
 @vindex elmo-nntp-list-folders-use-cache
 \e$B=i4|@_Dj$O\e(B 600 (\e$BIC\e(B)\e$B!#\e(B

diff --git a/doc/wl.texi b/doc/wl.texi
index 42f7e84..eca611e 100644 (file)
--- a/doc/wl.texi
+++ b/doc/wl.texi
@@ -7483,6 +7483,7 @@ a list of folder names.
 * Living with other packages:: Cooperating with other packages
 * Highlights::                 Highlights
 * Biff::                       Notify Mail arrival
+* Password Management::        Manage Passwords
 * Advanced Settings::          Advanced Settings
 * Customizable Variables::     Customizable Variables
 * Hooks::                      Hooks
@@ -8014,7 +8015,7 @@ The face for strings (for example, a version number) in the demo.
 @end table
 
 
-@node Biff, Advanced Settings, Highlights, Customization
+@node Biff, Password Management, Highlights, Customization
 @section Notify Mail arrival
 @cindex Biff
 
@@ -8056,7 +8057,39 @@ For silence, set to @code{nil}.
 @end table
 
 
-@node Advanced Settings, Customizable Variables, Biff, Customization
+@node Password Management, Advanced Settings, Biff, Customization
+@section Manage Passwords
+
+If you input passwords to connect servers, they are stored in the
+variable @code{elmo-passwd-alist} per connection. You should be careful
+that others might read your passwords if they can touch your Emacs,
+since encoded plain passwords are there.
+
+If you invoke @kbd{M-x elmo-passwd-alist-save} while you have stored
+passwords, then they are saved on the file, and it will save you to
+input passwords. In this case, the risk that someone reads your
+keystroke might decrease, but please not that plain passwords are
+stored on a file. You should treat them very carefully.
+To remove saved passwords on file, invoke @kbd{M-x elmo-passwd-alist-clear}
+and then @kbd{M-x elmo-passwd-alist-save}.
+
+@table @code
+@item elmo-passwd-alist-file-name
+@vindex elmo-passwd-alist-file-name
+The initial setting is @file{passwd}.
+This is the name of the file in which passwords are saved.
+@code{elmo-passwd-alist-save} saves current passwords to the file.
+
+@item elmo-passwd-life-time
+@vindex  elmo-passwd-life-time
+The initial setting is @code{nil}.
+If the value is some number, timer is set to remove password entry after
+@code{elmo-passwd-life-time} seconds since you input the password.
+@code{nil} means never to remove passwords.
+@end table
+
+
+@node Advanced Settings, Customizable Variables, Password Management, Customization
 @section Advanced Settings
 
 @menu
@@ -8467,12 +8500,6 @@ This is meaningful for XEmacs only.  The initial setting depends on
 XEmacs (@code{t} for XEmacs with dbm).
 If non-nil, Message-ID is controlled by dbm.
 
-@item elmo-passwd-alist-file-name
-@vindex elmo-passwd-alist-file-name
-The initial setting is @file{passwd}.
-This is the name of the file in which passwords are saved.
-@code{elmo-passwd-alist-save} saves current passwords to the file.
-
 @item elmo-nntp-list-folders-use-cache
 @vindex elmo-nntp-list-folders-use-cache
 The initial setting is 600 (in seconds).