X-Git-Url: https://cgit.sxemacs.org/?a=blobdiff_plain;f=texi%2Fsasl.texi;h=f4c09777c05d900540676a551118ad66efab3282;hb=8229c618c1c4fdd041277de1f865f6eb7f1b091f;hp=8d73326430789f59d747f716ae176f852f37f82e;hpb=7bbaeee6ac765a86ec251227b4257b18cb4b6301;p=gnus diff --git a/texi/sasl.texi b/texi/sasl.texi index 8d7332643..f4c09777c 100644 --- a/texi/sasl.texi +++ b/texi/sasl.texi @@ -3,61 +3,66 @@ @setfilename sasl.info @set VERSION 0.2 - -@dircategory Emacs -@direntry -* SASL: (sasl). The Emacs SASL library. -@end direntry - @settitle Emacs SASL Library @value{VERSION} -@ifinfo -This file describes the Emacs SASL library. +@copying +This file describes the Emacs SASL library, version @value{VERSION}. -Copyright (C) 2000 Daiki Ueno. +Copyright @copyright{} 2000, 2004, 2005, 2006, 2007, 2008, 2009, 2010 +Free Software Foundation, Inc. +@quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or +under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license is included in the section entitled "GNU -Free Documentation License". -@end ifinfo +Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' +and with the Back-Cover Texts as in (a) below. A copy of the license +is included in the section entitled ``GNU Free Documentation License'' +in the Emacs manual. + +(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and +modify this GNU manual. Buying copies from the FSF supports it in +developing GNU and promoting software freedom.'' + +This document is part of a collection distributed under the GNU Free +Documentation License. If you want to distribute this document +separately from the collection, you can do so by adding a copy of the +license to the document, as described in section 6 of the license. +@end quotation +@end copying + +@dircategory Emacs +@direntry +* SASL: (sasl). The Emacs SASL library. +@end direntry -@tex @titlepage -@title Emacs SASL Library +@title Emacs SASL Library @value{VERSION} @author by Daiki Ueno @page @vskip 0pt plus 1filll -Copyright @copyright{} 2000 Daiki Ueno. - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.1 or -any later version published by the Free Software Foundation; with no -Invariant Sections, with no Front-Cover Texts, and with no Back-Cover -Texts. A copy of the license is included in the section entitled "GNU -Free Documentation License". +@insertcopying @end titlepage -@page -@end tex @node Top @top Emacs SASL -This manual describes the Emacs SASL library. -A common interface to share several authentication mechanisms between +SASL is a common interface to share several authentication mechanisms between applications using different protocols. +@ifnottex +@insertcopying +@end ifnottex + @menu * Overview:: What Emacs SASL library is. * How to use:: Adding authentication support to your applications. * Data types:: -* Backend drivers:: Writing your own drivers. +* Back end drivers:: Writing your own drivers. * Index:: * Function Index:: * Variable Index:: @@ -72,9 +77,9 @@ adding authentication support to various application protocols. The toplevel interface of this library is inspired by Java @sc{sasl} Application Program Interface. It defines an abstraction over a series -of authentication mechanism drivers (@ref{Backend drivers}). +of authentication mechanism drivers (@ref{Back end drivers}). -Backend drivers are designed to be close as possible to the +Back end drivers are designed to be close as possible to the authentication mechanism. You can access the additional configuration information anywhere from the implementation. @@ -118,9 +123,9 @@ A list of mechanism names. @defun sasl-find-mechanism mechanisms -Retrieve an apropriate mechanism. +Retrieve an appropriate mechanism. This function compares @var{mechanisms} and @code{sasl-mechanisms} then -returns apropriate @code{sasl-mechanism} object. +returns appropriate @code{sasl-mechanism} object. @example (let ((sasl-mechanisms '("CRAM-MD5" "DIGEST-MD5"))) @@ -133,7 +138,7 @@ returns apropriate @code{sasl-mechanism} object. Return name of mechanism, a string. @end defun -If you want to write an authentication mechanism driver (@ref{Backend +If you want to write an authentication mechanism driver (@ref{Back end drivers}), use @code{sasl-make-mechanism} and modify @code{sasl-mechanisms} and @code{sasl-mechanism-alist} correctly. @@ -144,7 +149,7 @@ of authentication functions. @example (defconst sasl-anonymous-steps - '(identity ;no initial response + '(identity ;no initial response sasl-anonymous-response)) (put 'sasl-anonymous 'sasl-mechanism @@ -228,7 +233,7 @@ authentication protocol exchange. For example, @example (process-send-string process - (if (sasl-step-data step) ;initial response + (if (sasl-step-data step) ;initial response (format "AUTH %s %s\r\n" name (base64-encode-string (sasl-step-data step) t)) (format "AUTH %s\r\n" name))) @end example @@ -241,8 +246,8 @@ Perform the authentication step. At the first time @var{step} should be set to @code{nil}. @end defun -@node Backend drivers -@chapter Backend drivers +@node Back end drivers +@chapter Back end drivers (Not yet written). @@ -263,3 +268,7 @@ At the first time @var{step} should be set to @code{nil}. @bye @c End: + +@ignore + arch-tag: dc9650be-a953-40bf-bc55-24fe5f19d875 +@end ignore