[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master 997ca88: ; * lisp/server.el (server-stop-automatically): Doc fix.
From: |
Eli Zaretskii |
Subject: |
master 997ca88: ; * lisp/server.el (server-stop-automatically): Doc fix. |
Date: |
Thu, 11 Nov 2021 06:13:37 -0500 (EST) |
branch: master
commit 997ca88ef44f5833f1a9a55fc3be863e7cc07a4b
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>
; * lisp/server.el (server-stop-automatically): Doc fix.
---
lisp/server.el | 28 +++++++++++++++-------------
1 file changed, 15 insertions(+), 13 deletions(-)
diff --git a/lisp/server.el b/lisp/server.el
index deaaf07..2f003a3 100644
--- a/lisp/server.el
+++ b/lisp/server.el
@@ -1791,24 +1791,26 @@ only these files will be asked to be saved."
;;;###autoload
(defun server-stop-automatically (arg)
- "Automatically stop server when possible.
+ "Automatically stop server as specified by ARG.
-When ARG is 'empty, the server is stopped when it has no remaining
-clients, no remaining unsaved file-visiting buffers, and no
-running processes with a query-on-exit flag.
+If ARG is the symbol `empty', stop the server when it has no
+remaining clients, no remaining unsaved file-visiting buffers,
+and no running processes with a `query-on-exit' flag.
-When ARG is 'delete-frame, the user is asked when the last frame is
-being closed whether each unsaved file-visiting buffer must be
-saved and each running process with a query-on-exit flag can be
-stopped, and if so, the server itself is stopped.
+If ARG is the symbol `delete-frame', ask the user when the last
+frame is deleted whether each unsaved file-visiting buffer must
+be saved and each running process with a `query-on-exit' flag
+can be stopped, and if so, stop the server itself.
-When ARG is 'kill-terminal, the user is asked when the last frame
-is being close with \\[save-buffers-kill-terminal] \
+If ARG is the symbol `kill-terminal', ask the user when the
+terminal is killed with \\[save-buffers-kill-terminal] \
whether each unsaved file-visiting
-buffer must be saved and each running process with a query-on-exit
-flag can be stopped, and if so, the server itself is stopped.
+buffer must be saved and each running process with a `query-on-exit'
+flag can be stopped, and if so, stop the server itself.
-This function is meant to be put in init files."
+Any other value of ARG will cause this function to signal an error.
+
+This function is meant to be called from the user init file."
(when (daemonp)
(setq server-stop-automatically arg)
(cond
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- master 997ca88: ; * lisp/server.el (server-stop-automatically): Doc fix.,
Eli Zaretskii <=