summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGregory Heytings <gregory@heytings.org>2021-11-05 00:14:30 +0100
committerLars Ingebrigtsen <larsi@gnus.org>2021-11-05 00:14:30 +0100
commit2bcc2160c9f7f16c5e9cd815b8074de27f30896d (patch)
tree82fe7f4ff83a6d65e24384cd1e2eb70f15dbcac3 /doc
parenta78ac0c5df74be6925f48896fd024f1f6f363c44 (diff)
downloademacs-2bcc2160c9f7f16c5e9cd815b8074de27f30896d.tar.gz
emacs-2bcc2160c9f7f16c5e9cd815b8074de27f30896d.tar.bz2
emacs-2bcc2160c9f7f16c5e9cd815b8074de27f30896d.zip
New emacsclient option to either create or reuse an existing frame.
* doc/emacs/misc.texi (emacsclient Options): Document the new option. * doc/man/emacsclient.1: Mention the new option (bug#51374). * etc/NEWS: Mention the new option. * lib-src/emacsclient.c (reuse_frame): New variable. (longopts): New option. (decode_options): Decode the new option. (print_help_and_exit): Document the new option. (main): Use the new option.
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/misc.texi5
-rw-r--r--doc/man/emacsclient.13
2 files changed, 8 insertions, 0 deletions
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index f66b69cdd73..4be47990d1f 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -1992,6 +1992,11 @@ the new frame displays the @file{*scratch*} buffer by default. You
can customize this behavior with the variable @code{initial-buffer-choice}
(@pxref{Entering Emacs}).
+@item -r
+@itemx --reuse-frame
+Create a new graphical @dfn{client frame} if none exists, otherwise
+use an existing Emacs frame.
+
@item -F @var{alist}
@itemx --frame-parameters=@var{alist}
Set the parameters for a newly-created graphical frame
diff --git a/doc/man/emacsclient.1 b/doc/man/emacsclient.1
index ba64efa282c..cc58f106e69 100644
--- a/doc/man/emacsclient.1
+++ b/doc/man/emacsclient.1
@@ -69,6 +69,9 @@ start Emacs in daemon mode, and try to connect to it.
.B -c, \-\-create-frame
Create a new frame instead of trying to use the current Emacs frame.
.TP
+.B -r \-\-reuse-frame
+Reuse an existing frame if one exists, otherwise create a new frame.
+.TP
.B \-F, \-\-frame-parameters=ALIST
Set the parameters of a newly-created frame.
.TP