@c -*-texinfo-*-
@c This is part of the XEmacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
+@c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
@c See the file lispref.texi for copying conditions.
@setfilename ../../info/x-windows.texinfo
@node X-Windows, ToolTalk Support, System Interface, Top
generalize well, and they are covered specially here.
@menu
-* X Selections:: Transferring text to and from other X clients.
-* X Server:: Information about the X server connected to
- a particular device.
+* X Selections:: Transferring text to and from other X clients.
+* X Server:: Information about the X server connected to
+ a particular device.
* X Miscellaneous:: Other X-specific functions and variables.
@end menu
function is called @code{x-get-cut-buffer} in FSF Emacs.)
@end defun
-@defun x-store-cutbuffer string
+@defun x-store-cutbuffer string &optional push
This function stores @var{string} into the first cut buffer (cut buffer
-0), moving the other values down through the series of cut buffers,
-kill-ring-style. (This function is called @code{x-set-cut-buffer} in FSF
-Emacs.)
+0).
+
+Normally, the contents of the first cut buffer are simply replaced by
+@var{string}. However, if optional argument @var{push} is
+non-@code{nil}, the cut buffers are rotated. This means that the
+previous value of the first cut buffer moves to the second cut buffer,
+and the second to the third, and so on, moving the other values down
+through the series of cut buffers, kill-ring-style. There are 8 cut
+buffers altogether.
+
+Cut buffers are considered obsolete; you should use selections instead.
+
+This function has no effect if support for cut buffers was not compiled in.
+
+This function is called @code{x-set-cut-buffer} in FSF Emacs.
@end defun
@node X Server
the X server XEmacs is using.
@menu
-* Resources:: Getting resource values from the server.
-* Server Data:: Getting info about the X server.
-* Grabs:: Restricting access to the server by other apps.
+* Resources:: Getting resource values from the server.
+* Server Data:: Getting info about the X server.
+* Grabs:: Restricting access to the server by other apps.
@end menu
@node Resources
@example
@code{XrmGetResource (db, "xemacs.buffer.@var{buffer-name}.foreground",
- "Emacs.EmacsLocaleType.EmacsBuffer.Foreground",
- "String");}
+ "Emacs.EmacsLocaleType.EmacsBuffer.Foreground",
+ "String");}
@end example
@item
@example
@code{XrmGetResource (db, "xemacs.frame.@var{frame-name}.foreground",
- "Emacs.EmacsLocaleType.EmacsFrame.Foreground",
- "String");}
+ "Emacs.EmacsLocaleType.EmacsFrame.Foreground",
+ "String");}
@end example
@item
@example
@code{XrmGetResource (db, "xemacs.device.@var{device-name}.foreground",
- "Emacs.EmacsLocaleType.EmacsDevice.Foreground",
- "String");}
+ "Emacs.EmacsLocaleType.EmacsDevice.Foreground",
+ "String");}
@end example
@item
@example
@code{XrmGetResource (db, "xemacs.foreground",
- "Emacs.Foreground",
- "String");}
+ "Emacs.Foreground",
+ "String");}
@end example
@end enumerate
this variable may only be changed before XEmacs is dumped, or by setting
it in the file @file{lisp/term/x-win.el}.
-By default, this variable is nil at startup. When the connection
+By default, this variable is @code{nil} at startup. When the connection
to the X server is first initialized, the X resource database will
be consulted and the value will be set according to whether any
resources are found for the application class ``XEmacs''.
corresponding to a particular device. The device argument is generally
optional and defaults to the selected device.
-@defun x-server-version &optional device
+@defun x-server-version &optional device
This function returns the list of version numbers of the X server
@var{device} is on. The returned value is a list of three integers: the
major and minor version numbers of the X protocol in use, and the
@defun x-grab-keyboard &optional device
This function grabs the keyboard on the given device (defaulting to the
selected one). So long as the keyboard is grabbed, all keyboard events
-will be delivered to XEmacs -- it is not possible for other X clients to
+will be delivered to XEmacs---it is not possible for other X clients to
eavesdrop on them. Ungrab the keyboard with @code{x-ungrab-keyboard}
(use an @code{unwind-protect}). Returns @code{t} if the grab was
successful; @code{nil} otherwise.