diff options
author | Chong Yidong <[email protected]> | 2011-07-11 14:40:48 -0400 |
---|---|---|
committer | Chong Yidong <[email protected]> | 2011-07-11 14:40:48 -0400 |
commit | 963578d396f018f4cae81bca311882ab4ed15b4f (patch) | |
tree | 1a5f9d705fcecd87d47fc1e4fb09507dd2ff00f5 /doc/lispref/frames.texi | |
parent | 07151e498ff9174518675e14b619aca4b8307733 (diff) |
More documentation of Emacs 24 X selection changes.
* doc/emacs/frames.texi (Mouse Commands): Document mouse-yank-primary.
* doc/emacs/killing.texi (Primary Selection): Document `only' setting for
select-active-regions.
* doc/emacs/mark.texi (Setting Mark): Reference Shift Selection node.
* doc/lispref/frames.texi (Window System Selections): Discussion of
x-select-enable-clipboard moved to Emacs manual.
Diffstat (limited to 'doc/lispref/frames.texi')
-rw-r--r-- | doc/lispref/frames.texi | 56 |
1 files changed, 26 insertions, 30 deletions
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 7dc6934c7d..9a30ba5fdb 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -1959,30 +1959,34 @@ defined in the file @file{lisp/term/x-win.el}. Use @kbd{M-x apropos @node Window System Selections @section Window System Selections @cindex selection (for window systems) - -The X server records a set of @dfn{selections} which permit transfer of -data between application programs. The various selections are -distinguished by @dfn{selection types}, represented in Emacs by -symbols. X clients including Emacs can read or set the selection for -any given type. +@cindex clipboard +@cindex primary selection +@cindex secondary selection + + In the X window system, data can be transferred between different +applications by means of @dfn{selections}. X defines an arbitrary +number of @dfn{selection types}, each of which can store its own data; +however, only three are commonly used: the @dfn{clipboard}, +@dfn{primary selection}, and @dfn{secondary selection}. @xref{Cut and +Paste,, Cut and Paste, emacs, The GNU Emacs Manual}, for Emacs +commands that make use of these selections. This section documents +the low-level functions for reading and setting X selections. @deffn Command x-set-selection type data -This function sets a ``selection'' in the X server. It takes two -arguments: a selection type @var{type}, and the value to assign to it, -@var{data}. If @var{data} is @code{nil}, it means to clear out the -selection. Otherwise, @var{data} may be a string, a symbol, an integer -(or a cons of two integers or list of two integers), an overlay, or a -cons of two markers pointing to the same buffer. An overlay or a pair -of markers stands for text in the overlay or between the markers. - -The argument @var{data} may also be a vector of valid non-vector -selection values. - -Each possible @var{type} has its own selection value, which changes -independently. The usual values of @var{type} are @code{PRIMARY}, -@code{SECONDARY} and @code{CLIPBOARD}; these are symbols with upper-case -names, in accord with X Window System conventions. If @var{type} is -@code{nil}, that stands for @code{PRIMARY}. +This function sets an X selection. It takes two arguments: a +selection type @var{type}, and the value to assign to it, @var{data}. + +@var{type} should be a symbol; it is usually one of @code{PRIMARY}, +@code{SECONDARY} or @code{CLIPBOARD}. These are symbols with +upper-case names, in accord with X Window System conventions. If +@var{type} is @code{nil}, that stands for @code{PRIMARY}. + +If @var{data} is @code{nil}, it means to clear out the selection. +Otherwise, @var{data} may be a string, a symbol, an integer (or a cons +of two integers or list of two integers), an overlay, or a cons of two +markers pointing to the same buffer. An overlay or a pair of markers +stands for text in the overlay or between the markers. The argument +@var{data} may also be a vector of valid non-vector selection values. This function returns @var{data}. @end deffn @@ -2019,14 +2023,6 @@ and @code{x-set-selection} on MS-Windows support the text data type only; if the clipboard holds other types of data, Emacs treats the clipboard as empty. -@defopt x-select-enable-clipboard -If this is non-@code{nil}, the Emacs yank functions consult the -clipboard before the primary selection, and the kill functions store in -the clipboard as well as the primary selection. Otherwise they do not -access the clipboard at all. The default is @code{t} on systems with -clipboards. -@end defopt - @node Drag and Drop @section Drag and Drop |