Specify precedence in .authinfo files

* doc/misc/auth.texi (Help for users): Mention placing more
specific entries first (bug#45711).

diff --git a/doc/misc/auth.texi b/doc/misc/auth.texi
index d810f15c802ee79ce01b16f148b3459984515c26..034004d1df4ca342fba0301fbb444f39f0d3e7f6 100644 (file)
--- 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: