bug#53199: [PATCH] * Clarify that @var{auto-mode-alist} is searched

[Eli Zaretskii <eliz@gnu.org>]

> From: Hong Xu <hong@topbug.net>
> Date: Tue, 11 Jan 2022 16:46:22 -0800
> 
>  doc/lispref/modes.texi | 7 ++++---
>  1 file changed, 4 insertions(+), 3 deletions(-)
> 
> diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
> index 5fc831536e82..0bd1fc51febf 100644
> --- a/doc/lispref/modes.texi
> +++ b/doc/lispref/modes.texi
> @@ -750,9 +750,10 @@ Auto Major Mode
>  When you visit a file whose expanded file name (@pxref{File Name
>  Expansion}), with version numbers and backup suffixes removed using
>  @code{file-name-sans-versions} (@pxref{File Name Components}), matches
> -a @var{regexp}, @code{set-auto-mode} calls the corresponding
> -@var{mode-function}.  This feature enables Emacs to select the proper
> -major mode for most files.
> +a @var{regexp}, @code{set-auto-mode} calls the @var{mode-function}
> +that corresponds to the first such @var{regexp} in
> +@var{auto-mode-alist}.  This feature enables Emacs to select the
> +proper major mode for most files.

Thanks.  I decided to clarify this in a slightly different way, by
adding the following sentence after the description of the matching
process:

  If @code{auto-mode-alist} has more than one element whose @var{regexp}
  matches the file name, Emacs will use the first match.

With that, I'm closing the bug.