diff options
Diffstat (limited to 'doc/lispref/frames.texi')
| -rw-r--r-- | doc/lispref/frames.texi | 78 |
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}, | |||
| 337 | If the terminal supports frame transparency, the parameter | 337 | If 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 | ||
| 341 | variables. @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 | |||
| 374 | parameter. If you don't mention a parameter in @var{alist}, its value | 371 | parameter. If you don't mention a parameter in @var{alist}, its value |
| 375 | doesn't change. If @var{frame} is @code{nil}, it defaults to the selected | 372 | doesn't change. If @var{frame} is @code{nil}, it defaults to the selected |
| 376 | frame. | 373 | frame. |
| 377 | |||
| 378 | You can use this function to define frame-local bindings for | ||
| 379 | variables, 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 | |||
| 520 | If you specify the frame name explicitly when you create the frame, the | 514 | If you specify the frame name explicitly when you create the frame, the |
| 521 | name is also used (instead of the name of the Emacs executable) when | 515 | name is also used (instead of the name of the Emacs executable) when |
| 522 | looking up X resources for the frame. | 516 | looking up X resources for the frame. |
| 517 | |||
| 518 | @item explicit-name | ||
| 519 | If the frame name was specified explicitly when the frame was created, | ||
| 520 | this parameter will be that name. If the frame wasn't explicitly | ||
| 521 | named, 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 | |
| 1958 | The X server records a set of @dfn{selections} which permit transfer of | 1957 | @cindex primary selection |
| 1959 | data between application programs. The various selections are | 1958 | @cindex secondary selection |
| 1960 | distinguished by @dfn{selection types}, represented in Emacs by | 1959 | |
| 1961 | symbols. X clients including Emacs can read or set the selection for | 1960 | In the X window system, data can be transferred between different |
| 1962 | any given type. | 1961 | applications by means of @dfn{selections}. X defines an arbitrary |
| 1962 | number of @dfn{selection types}, each of which can store its own data; | ||
| 1963 | however, only three are commonly used: the @dfn{clipboard}, | ||
| 1964 | @dfn{primary selection}, and @dfn{secondary selection}. @xref{Cut and | ||
| 1965 | Paste,, Cut and Paste, emacs, The GNU Emacs Manual}, for Emacs | ||
| 1966 | commands that make use of these selections. This section documents | ||
| 1967 | the 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 |
| 1965 | This function sets a ``selection'' in the X server. It takes two | 1970 | This function sets an X selection. It takes two arguments: a |
| 1966 | arguments: a selection type @var{type}, and the value to assign to it, | 1971 | selection 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 | |
| 1968 | selection. 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 |
| 1970 | cons of two markers pointing to the same buffer. An overlay or a pair | 1975 | upper-case names, in accord with X Window System conventions. If |
| 1971 | of markers stands for text in the overlay or between the markers. | 1976 | @var{type} is @code{nil}, that stands for @code{PRIMARY}. |
| 1972 | 1977 | ||
| 1973 | The argument @var{data} may also be a vector of valid non-vector | 1978 | If @var{data} is @code{nil}, it means to clear out the selection. |
| 1974 | selection values. | 1979 | Otherwise, @var{data} may be a string, a symbol, an integer (or a cons |
| 1975 | 1980 | of two integers or list of two integers), an overlay, or a cons of two | |
| 1976 | Each possible @var{type} has its own selection value, which changes | 1981 | markers pointing to the same buffer. An overlay or a pair of markers |
| 1977 | independently. The usual values of @var{type} are @code{PRIMARY}, | 1982 | stands 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. |
| 1979 | names, in accord with X Window System conventions. If @var{type} is | ||
| 1980 | @code{nil}, that stands for @code{PRIMARY}. | ||
| 1981 | 1984 | ||
| 1982 | This function returns @var{data}. | 1985 | This 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 | |||
| 2014 | only; if the clipboard holds other types of data, Emacs treats the | 2017 | only; if the clipboard holds other types of data, Emacs treats the |
| 2015 | clipboard as empty. | 2018 | clipboard as empty. |
| 2016 | 2019 | ||
| 2017 | @defopt x-select-enable-clipboard | ||
| 2018 | If this is non-@code{nil}, the Emacs yank functions consult the | ||
| 2019 | clipboard before the primary selection, and the kill functions store in | ||
| 2020 | the clipboard as well as the primary selection. Otherwise they do not | ||
| 2021 | access the clipboard at all. The default is @code{t} on systems with | ||
| 2022 | clipboards. | ||
| 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 |
| 2444 | This function returns the visual class for the screen. The value is one | 2439 | This function returns the visual class for the screen. The value is |
| 2445 | of the symbols @code{static-gray}, @code{gray-scale}, | 2440 | one of the symbols @code{static-gray} (a limited, unchangeable number |
| 2446 | @code{static-color}, @code{pseudo-color}, @code{true-color}, and | 2441 | of 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 | ||
| 2444 | full range of colors), and @code{direct-color} (a full range of | ||
| 2445 | colors). | ||
| 2448 | @end defun | 2446 | @end defun |
| 2449 | 2447 | ||
| 2450 | @defun display-color-cells &optional display | 2448 | @defun display-color-cells &optional display |