aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref/frames.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/lispref/frames.texi')
-rw-r--r--doc/lispref/frames.texi78
1 files changed, 38 insertions, 40 deletions
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index c5136456177..b6012a4dd53 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -337,9 +337,6 @@ parameters @code{foreground-color}, @code{background-color},
337If the terminal supports frame transparency, the parameter 337If the terminal supports frame transparency, the parameter
338@code{alpha} is also meaningful. 338@code{alpha} is also meaningful.
339 339
340 You can use frame parameters to define frame-local bindings for
341variables. @xref{Frame-Local Variables}.
342
343@menu 340@menu
344* Parameter Access:: How to change a frame's parameters. 341* Parameter Access:: How to change a frame's parameters.
345* Initial Parameters:: Specifying frame parameters when you make a frame. 342* Initial Parameters:: Specifying frame parameters when you make a frame.
@@ -374,9 +371,6 @@ elements of @var{alist}. Each element of @var{alist} has the form
374parameter. If you don't mention a parameter in @var{alist}, its value 371parameter. If you don't mention a parameter in @var{alist}, its value
375doesn't change. If @var{frame} is @code{nil}, it defaults to the selected 372doesn't change. If @var{frame} is @code{nil}, it defaults to the selected
376frame. 373frame.
377
378You can use this function to define frame-local bindings for
379variables, see @ref{Frame-Local Variables}.
380@end defun 374@end defun
381 375
382@defun set-frame-parameter frame parm value 376@defun set-frame-parameter frame parm value
@@ -520,6 +514,11 @@ you don't specify a name, Emacs sets the frame name automatically
520If you specify the frame name explicitly when you create the frame, the 514If you specify the frame name explicitly when you create the frame, the
521name is also used (instead of the name of the Emacs executable) when 515name is also used (instead of the name of the Emacs executable) when
522looking up X resources for the frame. 516looking up X resources for the frame.
517
518@item explicit-name
519If the frame name was specified explicitly when the frame was created,
520this parameter will be that name. If the frame wasn't explicitly
521named, this parameter will be @code{nil}.
523@end table 522@end table
524 523
525@node Position Parameters 524@node Position Parameters
@@ -1954,30 +1953,34 @@ defined in the file @file{lisp/term/x-win.el}. Use @kbd{M-x apropos
1954@node Window System Selections 1953@node Window System Selections
1955@section Window System Selections 1954@section Window System Selections
1956@cindex selection (for window systems) 1955@cindex selection (for window systems)
1957 1956@cindex clipboard
1958The X server records a set of @dfn{selections} which permit transfer of 1957@cindex primary selection
1959data between application programs. The various selections are 1958@cindex secondary selection
1960distinguished by @dfn{selection types}, represented in Emacs by 1959
1961symbols. X clients including Emacs can read or set the selection for 1960 In the X window system, data can be transferred between different
1962any given type. 1961applications by means of @dfn{selections}. X defines an arbitrary
1962number of @dfn{selection types}, each of which can store its own data;
1963however, only three are commonly used: the @dfn{clipboard},
1964@dfn{primary selection}, and @dfn{secondary selection}. @xref{Cut and
1965Paste,, Cut and Paste, emacs, The GNU Emacs Manual}, for Emacs
1966commands that make use of these selections. This section documents
1967the low-level functions for reading and setting X selections.
1963 1968
1964@deffn Command x-set-selection type data 1969@deffn Command x-set-selection type data
1965This function sets a ``selection'' in the X server. It takes two 1970This function sets an X selection. It takes two arguments: a
1966arguments: a selection type @var{type}, and the value to assign to it, 1971selection type @var{type}, and the value to assign to it, @var{data}.
1967@var{data}. If @var{data} is @code{nil}, it means to clear out the 1972
1968selection. Otherwise, @var{data} may be a string, a symbol, an integer 1973@var{type} should be a symbol; it is usually one of @code{PRIMARY},
1969(or a cons of two integers or list of two integers), an overlay, or a 1974@code{SECONDARY} or @code{CLIPBOARD}. These are symbols with
1970cons of two markers pointing to the same buffer. An overlay or a pair 1975upper-case names, in accord with X Window System conventions. If
1971of markers stands for text in the overlay or between the markers. 1976@var{type} is @code{nil}, that stands for @code{PRIMARY}.
1972 1977
1973The argument @var{data} may also be a vector of valid non-vector 1978If @var{data} is @code{nil}, it means to clear out the selection.
1974selection values. 1979Otherwise, @var{data} may be a string, a symbol, an integer (or a cons
1975 1980of two integers or list of two integers), an overlay, or a cons of two
1976Each possible @var{type} has its own selection value, which changes 1981markers pointing to the same buffer. An overlay or a pair of markers
1977independently. The usual values of @var{type} are @code{PRIMARY}, 1982stands for text in the overlay or between the markers. The argument
1978@code{SECONDARY} and @code{CLIPBOARD}; these are symbols with upper-case 1983@var{data} may also be a vector of valid non-vector selection values.
1979names, in accord with X Window System conventions. If @var{type} is
1980@code{nil}, that stands for @code{PRIMARY}.
1981 1984
1982This function returns @var{data}. 1985This function returns @var{data}.
1983@end deffn 1986@end deffn
@@ -2014,14 +2017,6 @@ and @code{x-set-selection} on MS-Windows support the text data type
2014only; if the clipboard holds other types of data, Emacs treats the 2017only; if the clipboard holds other types of data, Emacs treats the
2015clipboard as empty. 2018clipboard as empty.
2016 2019
2017@defopt x-select-enable-clipboard
2018If this is non-@code{nil}, the Emacs yank functions consult the
2019clipboard before the primary selection, and the kill functions store in
2020the clipboard as well as the primary selection. Otherwise they do not
2021access the clipboard at all. The default is @code{t} on systems with
2022clipboards.
2023@end defopt
2024
2025@node Drag and Drop 2020@node Drag and Drop
2026@section Drag and Drop 2021@section Drag and Drop
2027 2022
@@ -2441,10 +2436,13 @@ For a tty display, it is log to base two of the number of colors supported.
2441@end defun 2436@end defun
2442 2437
2443@defun display-visual-class &optional display 2438@defun display-visual-class &optional display
2444This function returns the visual class for the screen. The value is one 2439This function returns the visual class for the screen. The value is
2445of the symbols @code{static-gray}, @code{gray-scale}, 2440one of the symbols @code{static-gray} (a limited, unchangeable number
2446@code{static-color}, @code{pseudo-color}, @code{true-color}, and 2441of grays), @code{gray-scale} (a full range of grays),
2447@code{direct-color}. 2442@code{static-color} (a limited, unchangeable number of colors),
2443@code{pseudo-color} (a limited number of colors), @code{true-color} (a
2444full range of colors), and @code{direct-color} (a full range of
2445colors).
2448@end defun 2446@end defun
2449 2447
2450@defun display-color-cells &optional display 2448@defun display-color-cells &optional display