diff options
| author | Eli Zaretskii | 2019-01-29 18:49:50 +0200 |
|---|---|---|
| committer | Eli Zaretskii | 2019-01-29 18:49:50 +0200 |
| commit | b94d76752776cca4d1652cfe715a60f4a36f14a3 (patch) | |
| tree | 184020f7faf7e2bb50b83f7c08b80a2f63094c19 /doc | |
| parent | 73508e62459113be4c7c101648afbe541dd18558 (diff) | |
| download | emacs-b94d76752776cca4d1652cfe715a60f4a36f14a3.tar.gz emacs-b94d76752776cca4d1652cfe715a60f4a36f14a3.zip | |
Minor copyedits in last manual change
* doc/emacs/custom.texi (Authentication): Improve markup,
indexing, and wording.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/emacs/custom.texi | 26 |
1 files 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}. | |||
| 2614 | 2614 | ||
| 2615 | @node Authentication | 2615 | @node Authentication |
| 2616 | @section Keeping Persistent Authentication Information | 2616 | @section Keeping Persistent Authentication Information |
| 2617 | @cindex ~/.authinfo file | ||
| 2618 | @cindex ~/.authinfo.gpg file | ||
| 2619 | @cindex ~/.netrc file | ||
| 2620 | 2617 | ||
| 2621 | Some Emacs packages, which connect to other services, require | 2618 | Some Emacs packages, which connect to other services, require |
| 2622 | authentication (@pxref{Passwords}), e.g., @ref{Top, Gnus,, gnus, The | 2619 | authentication (@pxref{Passwords}), e.g., see @ref{Top, Gnus,, gnus, The |
| 2623 | Gnus Manual}, or @ref{Top, Tramp,, tramp, The Tramp Manual}. Because | 2620 | Gnus Manual}, or @ref{Top, Tramp,, tramp, The Tramp Manual}. Because |
| 2624 | it might be annoying to provide the same user name and password again | 2621 | it might be annoying to provide the same user name and password again |
| 2625 | and again, Emacs offers to keep this information persistent via the | 2622 | and again, Emacs offers to keep this information persistent via the |
| 2626 | auth-source library. | 2623 | @file{auth-source} library. |
| 2627 | 2624 | ||
| 2628 | Per default, this information is taken from the file | 2625 | @cindex @file{~/.authinfo} file |
| 2626 | @cindex @file{~/.authinfo.gpg} file | ||
| 2627 | @cindex ~/.netrc file | ||
| 2628 | By default, the authentication information is taken from the file | ||
| 2629 | @file{~/.authinfo} or @file{~/.authinfo.gpg} or @file{~/.netrc}. | 2629 | @file{~/.authinfo} or @file{~/.authinfo.gpg} or @file{~/.netrc}. |
| 2630 | These files have a syntax similar to netrc files as known from the ftp | 2630 | These files have a syntax similar to netrc files as known from the |
| 2631 | program, like | 2631 | @command{ftp} program, like this: |
| 2632 | 2632 | ||
| 2633 | @example | 2633 | @example |
| 2634 | machine @var{mymachine} login @var{myloginname} password @var{mypassword} port @var{myport} | 2634 | machine @var{mymachine} login @var{myloginname} password @var{mypassword} port @var{myport} |
| 2635 | @end example | 2635 | @end example |
| 2636 | 2636 | ||
| 2637 | Similarly, the auth-source library supports multiple storage | 2637 | Similarly, the @file{auth-source} library supports multiple storage |
| 2638 | backend, currently either the classic netrc backend, JSON files, the | 2638 | backend, currently either the classic netrc backend, JSON files, the |
| 2639 | Secret Service API, and pass, the standard unix password manager. | 2639 | Secret Service API, and pass, the standard unix password manager. |
| 2640 | 2640 | ||
| 2641 | @vindex auth-sources | 2641 | @vindex auth-sources |
| 2642 | All these alternatives are customized via the user option | 2642 | All these alternatives can be customized via the user option |
| 2643 | @code{auth-sources}, @ref{Help for users, Emacs auth-source,, auth, | 2643 | @code{auth-sources}, see @ref{Help for users, Emacs auth-source,, |
| 2644 | Emacs auth-source}. | 2644 | auth, Emacs auth-source}. |
| 2645 | 2645 | ||
| 2646 | @vindex auth-source-save-behavior | 2646 | @vindex auth-source-save-behavior |
| 2647 | When a password is entered interactively, which is not found via the | 2647 | When a password is entered interactively, which is not found via the |
| 2648 | configured backend, some of the backends offer to save it | 2648 | configured backend, some of the backends offer to save it |
| 2649 | persistently. This can be changed by the customizing user option | 2649 | persistently. This can be changed by customizing the user option |
| 2650 | @code{auth-source-save-behavior}. | 2650 | @code{auth-source-save-behavior}. |