@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
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
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