summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2021-01-10 15:32:57 +0100
committerLars Ingebrigtsen <larsi@gnus.org>2021-01-10 15:32:57 +0100
commit9717ba930975d772412c65b0e2dbb9258cf502bd (patch)
tree2db98658dca035411ed5173143efa0668109005d /doc
parente186af261a4ed0fbcf8cbb35374b69582f42f25b (diff)
downloademacs-9717ba930975d772412c65b0e2dbb9258cf502bd.tar.gz
Specify precedence in .authinfo files
* doc/misc/auth.texi (Help for users): Mention placing more specific entries first (bug#45711).
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/auth.texi12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi
index d810f15c802..034004d1df4 100644
--- a/doc/misc/auth.texi
+++ b/doc/misc/auth.texi
@@ -107,6 +107,18 @@ The @code{user} is the user name. It's known as @var{:user} in
@code{auth-source-search} queries. You can also use @code{login} and
@code{account}.
+Matching entries are usually used in the order they appear, so placing
+the most specific entries first in the file is a good idea. For
+instance:
+
+@example
+machine example.com login foobar password geheimnis port smtp
+machine example.com login foobar password hemmelig
+@end example
+
+Here we're using one password for the @code{smtp} service, and a
+different one for all the other services.
+
You can also use this file to specify client certificates to use when
setting up TLS connections. The format is: