From: Eli Zaretskii <eliz@gnu.org>
Date: Tue, 25 Apr 2023 06:35:30 +0000 (+0300)
Subject: Document the 'end-session' event on MS-Windows
X-Git-Tag: emacs-29.0.91~103
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=fe8efbb8f75;p=emacs.git

Document the 'end-session' event on MS-Windows

* doc/lispref/commands.texi (Misc Events): Document the
'end-session' event.  (Bug#63058)
---

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