From b94d76752776cca4d1652cfe715a60f4a36f14a3 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Tue, 29 Jan 2019 18:49:50 +0200 Subject: [PATCH] Minor copyedits in last manual change * doc/emacs/custom.texi (Authentication): Improve markup, indexing, and wording. --- doc/emacs/custom.texi | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index b4623fbef84..3f660fe9a28 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -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}. -- 2.39.5