emacs-29 fe8efbb8f75: Document the 'end-session' event on MS-Windows

[Eli Zaretskii]

branch: emacs-29
commit fe8efbb8f753916b964feef8313077fae45c9f16
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    Document the 'end-session' event on MS-Windows
    
    * doc/lispref/commands.texi (Misc Events): Document the
    'end-session' event.  (Bug#63058)
---
 doc/lispref/commands.texi | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 30765a7e8f7..cd1745614eb 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -2395,6 +2395,17 @@ as @code{set-language-environment}), use the
 ;; Get the full localized name of the language
 (w32-get-locale-info language-id t)
 @end smallexample
+
+@cindex @code{end-session} event
+@item end-session
+This event is generated on MS-Windows when the operating system
+informs Emacs that the user terminated the interactive session, or
+that the system is shutting down.  The standard definition of this
+event is to invoke the @code{kill-emacs} command (@pxref{Killing
+Emacs}) so as to shut down Emacs in an orderly fashion; if there are
+unsaved changes, this will produce auto-save files
+(@pxref{Auto-Saving}) that the user can use after restarting the
+session to restore the unsaved edits.
 @end table
 
   If one of these events arrives in the middle of a key sequence---that