Merge from origin/emacs-28

282dde887d ; Fix typo missed in previous change
62c47ffd5f ; * lisp/net/tramp-crypt.el: Improve commentary
cba30431ff Merge branch 'emacs-28' of git.savannah.gnu.org:/srv/git/e...
8f9993bb3f ; * src/buffer.c (syms_of_buffer) <mode-line-format>: Doc ...
fec4bb89f9 ; Fix typos (Bug#56550)

1 files changed, 4 insertions, 1 deletions

diff --git a/src/buffer.c b/src/buffer.c
index e5fa09a9789..4994a310438 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5610,7 +5610,7 @@ used.  */);
 
   DEFVAR_PER_BUFFER ("mode-line-format", &BVAR (current_buffer, mode_line_format),
                      Qnil,
-                     doc: /* Template for displaying mode line for current buffer.
+                     doc: /* Template for displaying mode line for a window's buffer.
 
 The value may be nil, a string, a symbol or a list.
 
@@ -5623,6 +5623,9 @@ For any symbol other than t or nil, the symbol's value is processed as
  `risky-local-variable' property, all properties in any strings, as
  well as all :eval and :propertize forms in the value, are ignored.
 
+When the value is processed, the window's buffer is temporarily the
+current buffer.
+
 A list whose car is a string or list is processed by processing each
  of the list elements recursively, as separate mode line constructs,
  and concatenating the results.