diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index 05aabd0e15b..6001096f35b 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -899,6 +899,16 @@ input stream for each server. Each server also has its own selected frame. The commands you enter with a particular X server apply to that server's selected frame. + On multi-monitor displays it is possible to use the command +@code{make-frame-on-monitor}: + +@findex make-frame-on-monitor +@table @kbd +@item M-x make-frame-on-monitor @key{RET} @var{monitor} @key{RET} +Create a new frame on monitor @var{monitor} whose screen area is +a part of the current display. +@end table + @node Frame Parameters @section Frame Parameters @vindex default-frame-alist diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 8cb406cded3..820006a5675 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -440,6 +440,17 @@ This function returns the attributes of the physical monitor dominating (see above) @var{frame}, which defaults to the selected frame. @end defun +On multi-monitor displays it is possible to use the command +@code{make-frame-on-monitor} to make frames on the specified monitor. + +@deffn Command make-frame-on-monitor monitor &optional display parameters +This function creates and returns a new frame on @var{monitor} located +on @var{display}, taking the other frame parameters from the alist +@var{parameters}. @var{monitor} should be the name of the physical +monitor, the same string as returned by the function +@code{display-monitor-attributes-list} in the attribute @code{name}. +@var{display} should be the name of an X display (a string). +@end deffn @node Frame Geometry @section Frame Geometry