Commit b94d7675 authored by Eli Zaretskii's avatar Eli Zaretskii

Minor copyedits in last manual change

* doc/emacs/custom.texi (Authentication): Improve markup,
indexing, and wording.
parent 73508e62
Pipeline #644 passed with stage
in 57 minutes and 47 seconds
......@@ -2614,37 +2614,37 @@ Type @kbd{C-q}, followed by the key you want to bind, to insert @var{char}.
@node Authentication
@section Keeping Persistent Authentication Information
@cindex ~/.authinfo file
@cindex ~/.authinfo.gpg file
@cindex ~/.netrc file
Some Emacs packages, which connect to other services, require
authentication (@pxref{Passwords}), e.g., @ref{Top, Gnus,, gnus, The
authentication (@pxref{Passwords}), e.g., see @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.
@file{auth-source} library.
Per default, this information is taken from the file
@cindex @file{~/.authinfo} file
@cindex @file{~/.authinfo.gpg} file
@cindex ~/.netrc file
By default, the authentication information is taken from the file
@file{~/.authinfo} or @file{~/.authinfo.gpg} or @file{~/.netrc}.
These files have a syntax similar to netrc files as known from the ftp
program, like
These files have a syntax similar to netrc files as known from the
@command{ftp} program, like this:
@example
machine @var{mymachine} login @var{myloginname} password @var{mypassword} port @var{myport}
@end example
Similarly, the auth-source library supports multiple storage
Similarly, the @file{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.
@vindex auth-sources
All these alternatives are customized via the user option
@code{auth-sources}, @ref{Help for users, Emacs auth-source,, auth,
Emacs auth-source}.
All these alternatives can be customized via the user option
@code{auth-sources}, see @ref{Help for users, Emacs auth-source,,
auth, Emacs auth-source}.
@vindex 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
persistently. This can be changed by customizing the user option
@code{auth-source-save-behavior}.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment