Minor copyedits in last manual change

* doc/emacs/custom.texi (Authentication): Improve markup,
indexing, and wording.

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index b4623fbef842b0207993f883fbd5e11f257f1c69..3f660fe9a28f0678ae3fd428b37e2b97b555eb30 100644 (file)
--- 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}.