@copying
\e$B$3$N%U%!%$%k$O\e(B Emacs auth-source \e$B%i%$%V%i%j!<$r@bL@$7$^$9!#\e(B
-Copyright @copyright{} 2008-2011 Free Software Foundation, Inc.
+Copyright @copyright{} 2008-2012 Free Software Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
\e$BF1MM$K\e(B auth-source \e$B%i%$%V%i%j!<$OB?$/$NCyB"%P%C%/%(%s%I!"8=:_$OEAE}E*\e(B
\e$B$J\e(B ``netrc'' \e$B%P%/%(%s%I\e(B (\e$B$3$NJ8=q$N8e$NJ}$K$"$j$^$9\e(B) \e$B$^$?$O%7!<%/%l%C%H\e(B
-\e$B%5!<%S%9\e(B API \e$B$r%5%]!<%H$7$^$9!#$3$l$O\e(B EIEIO \e$B$K4p$E$$$?%P%/%(%s%I$G9T$J$o\e(B
-\e$B$l!"$b$7I,MW$J$i$"$J$?FH<+$N$b$N$r=q$/$3$H$,$G$-$^$9!#\e(B
+\e$B%5!<%S%9\e(B API \e$B$r%5%]!<%H$7$^$9!#$3$l$O\e(B EIEIO \e$B$K4p$E$$$?%P%C%/%(%s%I$G9T$J\e(B
+\e$B$o$l!"$b$7I,MW$J$i$"$J$?FH<+$N$b$N$r=q$/$3$H$,$G$-$^$9!#\e(B
@node Help for users
@chapter \e$BMxMQ<T$N$?$a$N%X%k%W\e(B
@end defun
-@c TRANSLATEME
-Let's take a look at an example of using @code{auth-source-search}
-from Gnus' @code{nnimap.el}.
+\e$B$G$O\e(B Gnus \e$B$N\e(B @code{nnimap.el} \e$B$+$i\e(B @code{auth-source-search} \e$B$r;H$&Nc$r\e(B
+\e$B8+$F$_$^$7$g$&!#\e(B
@example
(defun nnimap-credentials (address ports)
nil)))
@end example
-This call requires the user and password (secret) to be in the
-results. It also requests that an entry be created if it doesn't
-exist already. While the created entry is being assembled, the shown
-prompts will be used to interact with the user. The caller can also
-pass data in @code{auth-source-creation-defaults} to supply defaults
-for any of the prompts.
+@c
\e$B0J2<$NLuJ8$N<A$,0-$$$N$O86J8$N=PMh$N9s$5$N$?$a!#
\e(B
+\e$B$3$N8F$S=P$7$O$=$N7k2L$K%f!<%6!<L>$H%Q%9%o!<%I\e(B (\e$B<0Cf$N\e(B @code{secret}) \e$B$,\e(B
+\e$B4^$^$l$k$3$H$r5a$a$F$$$^$9!#$5$i$K!"$b$7$=$N9`L\$,$^$@L5$+$C$?$i:n$kI,MW\e(B
+
\e$B$b$"$j$^$9!#$=$N9`L\$r:n$k:]$K%f!<%6!<$H$d$j<h$j$9$k>l9g$O!"<0Cf$K$"$k<A
\e(B
+
\e$BLdJ8$,;H$o$l$^$9!#$3$N8F$S=P$7$O!"%f!<%6!<$X$N<ALdJ8$N%G%#%U%)%k%HCM$N$?
\e(B
+\e$B$a$K\e(B @code{auth-source-creation-defaults} \e$B$K$"$k%G!<%?$rEO$9$3$H$b$G$-$^\e(B
+\e$B$9!#\e(B
-Note that the password needs to be evaluated if it's a function. It's
-wrapped in a function to provide some security.
+\e$B%Q%9%o!<%I$,$b$74X?t$@$C$?$i!"$=$l$OI>2A$5$l$kI,MW$,$"$k$3$H$KCm0U$7$F$/\e(B
+\e$B$@$5$$!#$"$kDxEY$N0BA4BP:v$H$7$F!"$=$l$O4X?t$GJq$^$l$F$$$^$9!#\e(B
-Later, after a successful login, @code{nnimal.el} calls the
-@code{:save-function} like so:
+\e$B$=$N8e%m%0%$%s$K@.8y$7$?$i\e(B @code{nnimap.el} \e$B$O<!$N$h$&\e(B
+\e$B$K\e(B @code{:save-function} \e$B$r8F$S$^$9\e(B:
@example
(when (functionp (nth 2 credentials))
(funcall (nth 2 credentials)))
@end example
-Which will work whether the @code{:save-function} was provided or not.
-@code{:save-function} will be provided only when a new entry was
-created, so this effectively says ``after a successful login, save the
-authentication information we just used, if it was newly created.''
+\e$B$3$l$O\e(B @code{:save-function} \e$B$NM-L5$K4X$o$i$9F0:n$9$k$G$7$g$&!#\e(B
+@code{:save-function}\e$B$O?7$7$$9`L\$,:n$i$l$?$H$-$@$1Ds6!$5$l$k$N$G!"$3$l\e(B
+\e$B$O<B:]$K!V%m%0%$%s@.8y8e!W$J$N$G$9!#$=$7$F2f!9$,$A$g$&$I;H$C$F$$$?G'>Z>p\e(B
+\e$BJs\e(B (\e$B$?$@$7$3$l$,?7$?:n$i$l$?$b$N$G$"$k$N$J$i\e(B) \e$B$r%;!<%V$7$^$9!#\e(B
+
+\e$B:G=i$K$=$l$,8F$P$l$?8e!"\e(B@code{:save-function} \e$B$,:FEYAv$k$3$H$O$"$j$^$;$s\e(B
+(\e$B$7$+$7$b$7\e(B @code{auth-source-debug} \e$B$r\e(B @code{'trivia} \e$B$K@_Dj$7$F$"$k$J\e(B
+
\e$B$i$P!"$=$N$3$H$rB?>/5-O?$7$^$9!#$3$l$9$J$o$A!"$=$l$O]5F+$7$$F1$8<ALd$,7+
\e(B
+\e$B$jJV$5$l$k$3$H$O$J$$$H$$$&$3$H$G$9!#\e(B
+
+\e$B$7$?$,$C$F\e(B @code{:create t} \e$B$r@_Dj$7$?\e(B API \e$B%f!<%6!<$N@UG$$O!"$b$7B8:_$9\e(B
+\e$B$k$J$i$P\e(B @code{:save-function} \e$B$r8F$V$3$H$G$9!#\e(B
@defun auth-source-delete SPEC
projects / elisp / gnus-doc-ja.git / blobdiff