fix/bug-57080-mode-line-format-docs a93f9d7f16 4/5: * doc/lispref/modes.texi: Improve docs for obsolete '%m' construct

[Phil Sainty]

branch: fix/bug-57080-mode-line-format-docs
commit a93f9d7f16bb47aa8f258c5623c12e66ce6537b5
Author: Phil Sainty <psainty@orcon.net.nz>
Commit: Phil Sainty <psainty@orcon.net.nz>

    * doc/lispref/modes.texi: Improve docs for obsolete '%m' construct
    
    Bug #57080.
---
 doc/lispref/modes.texi | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 5dee277469..8b67e0aa51 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -2439,6 +2439,11 @@ abbreviate.
 The current line number of point, counting within the accessible portion
 of the buffer.
 
+@item %m
+Obsolete; use the @code{mode-name} variable instead.  The @code{%m}
+construct is still supported, but it is inadequate, as it produces an
+empty string if the value of @code{mode-name} is a non-string
+mode-line construct (as in @code{emacs-lisp-mode}, for example).
 
 @item %M
 The value of @code{global-mode-string} (which is part of
@@ -2514,15 +2519,6 @@ The character @samp{%}---this is how to include a 
literal @samp{%} in a
 string in which @code{%}-constructs are allowed.
 @end table
 
-The following @code{%}-construct is still supported, but it is
-obsolete, since you can get the same result using the variable
-@code{mode-name}.
-
-@table @code
-@item %m
-The value of @code{mode-name}.
-@end table
-
 @node Properties in Mode
 @subsection Properties in the Mode Line
 @cindex text properties in the mode line