[Emacs-diffs] emacs-26 ceccb3c: New node Authentication in the Emacs manual

[Michael Albinus]

branch: emacs-26
commit ceccb3c8c4461cfb69b64d94a57709393b8c39fd
Author: Michael Albinus <address@hidden>
Commit: Michael Albinus <address@hidden>

    New node Authentication in the Emacs manual
    
    * doc/emacs/custom.texi (Customization):
    * doc/emacs/emacs.texi (Top): Add node Authentication.
---
 doc/emacs/custom.texi | 38 ++++++++++++++++++++++++++++++++++++++
 doc/emacs/emacs.texi  |  1 +
 2 files changed, 39 insertions(+)

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index 4aaf58c..32706f3 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -32,6 +32,8 @@ Reference Manual}.
                           By changing them, you can redefine keys.
 * Init File::           How to write common customizations in the
                           initialization file.
+* Authentication::      Keeping persistent authentication information.
+
 @end menu
 
 @node Easy Customization
@@ -2609,3 +2611,39 @@ instance:
 
 @noindent
 Type @kbd{C-q}, followed by the key you want to bind, to insert @var{char}.
+
address@hidden Authentication
address@hidden Keeping Persistent Authentication Information
address@hidden ~/.authinfo file
address@hidden ~/.authinfo.gpg file
address@hidden ~/.netrc file
+
+  Some Emacs packages, which connect to other services, require
+authentication (@pxref{Passwords}), e.g., @ref{Top, Gnus,, gnus, The
+Gnus Manual}, or @ref{Top, Tramp,, tramp, The Tramp Manual}.  Because
+it might be annoying to provide the same user name and password again
+and again, Emacs offers to keep this information persistent via the
+auth-source library.
+
+  Per default, this information is taken from the file
address@hidden/.authinfo} or @file{~/.authinfo.gpg} or @file{~/.netrc}.
+These files have a syntax similar to netrc files as known from the ftp
+program, like
+
address@hidden
+machine @var{mymachine} login @var{myloginname} password @var{mypassword} port 
@var{myport}
address@hidden example
+
+  Similarly, the auth-source library supports multiple storage
+backend, currently either the classic netrc backend, JSON files, the
+Secret Service API, and pass, the standard unix password manager.
+
address@hidden auth-sources
+  All these alternatives are customized via the user option
address@hidden, @ref{Top, Emacs auth-source,, auth, Emacs auth-source}.
+
address@hidden auth-source-save-behavior
+  When a password is entered interactively, which is not found via the
+configured backend, some of the backends offer to save it
+persistently.  This can be changed by the customizing user option
address@hidden
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index d501db7..5b16d50 100644
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -1114,6 +1114,7 @@ Customization
                           By changing them, you can redefine keys.
 * Init File::           How to write common customizations in the
                           initialization file.
+* Authentication::      Keeping persistent authentication information.
 
 Easy Customization Interface