import xemacs-21.2.37

[chise/xemacs-chise.git.1] / man / lispref / x-windows.texi

diff --git a/man/lispref/x-windows.texi b/man/lispref/x-windows.texi
index 1cadf17..04a521d 100644 (file)
--- a/man/lispref/x-windows.texi
+++ b/man/lispref/x-windows.texi
@@ -1,6 +1,6 @@
 @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
@@ -72,11 +72,23 @@ This function returns the contents of cut buffer number @var{n}. (This
 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
@@ -237,7 +249,7 @@ be made before the connection to the X server is initialized, that is,
 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''.
@@ -251,7 +263,7 @@ get information about the capabilities and origin of the X server
 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