; Clarify documentation of 'server-after-make-frame-hook'

* doc/lispref/frames.texi (Creating Frames):
* lisp/server.el (server-after-make-frame-hook): Clarify
documentation of 'server-after-make-frame-hook'.  (Bug#64873)

(cherry picked from commit e650a14f64)
This commit is contained in:
Eli Zaretskii 2023-07-27 09:37:03 +03:00
parent d13029cdcd
commit 54e98b5f9b
2 changed files with 11 additions and 5 deletions

View file

@ -187,9 +187,13 @@ selected frame.
@end defvar @end defvar
@defopt server-after-make-frame-hook @defopt server-after-make-frame-hook
A normal hook run when the Emacs server creates a client frame. When A normal hook run when the Emacs server starts using a client frame.
this hook is called, the created frame is the selected one. When this hook is called, the client frame is the selected one. Note
@xref{Emacs Server,,, emacs, The GNU Emacs Manual}. that, depending on how @command{emacsclient} was invoked
(@pxref{Invoking emacsclient,,, emacs, The GNU Emacs Manual}), this
client frame could be a new frame created for the client, or it could
be an existing frame that the server reused for handling the client
commands. @xref{Emacs Server,,, emacs, The GNU Emacs Manual}.
@end defopt @end defopt

View file

@ -182,8 +182,10 @@ space (this means characters from ! to ~; or from code 33 to
:type 'hook) :type 'hook)
(defcustom server-after-make-frame-hook nil (defcustom server-after-make-frame-hook nil
"Hook run when the Emacs server creates a client frame. "Hook run when the Emacs server starts using a client frame.
The created frame is selected when the hook is called." The client frame is selected when the hook is called.
The client frame could be a newly-created frame, or an
existing frame reused for this purpose."
:type 'hook :type 'hook
:version "27.1") :version "27.1")