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

[Phil Sainty]

branch: fix/bug-57080-mode-line-format-docs
commit b2225d849c58ec68bf1dba325aad25505a053455
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 | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 30baa7f4d80..3da716a3b8a 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -2441,6 +2441,12 @@ 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
 @code{mode-line-misc-info} by default).
@@ -2515,15 +2521,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