X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=man%2Flispref%2Fx-windows.texi;h=fa65f2482e2fc00cb3a1707e387ff99842b95317;hb=1156318b9be74d9d66eddf7895ee463e4870b9a9;hp=c40ab1482376f44074a182594527c53ae13fc60a;hpb=6883ee56ec887c2c48abe5b06b5e66aa74031910;p=chise%2Fxemacs-chise.git.1 diff --git a/man/lispref/x-windows.texi b/man/lispref/x-windows.texi index c40ab14..fa65f24 100644 --- 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 @@ -18,9 +18,9 @@ However, there are some features of the X Window System that do not 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 @@ -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 @@ -86,9 +98,9 @@ This section describes how to access and change the overall status of 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 @@ -118,7 +130,7 @@ object that the database is searched for. @item The fourth arg is the locale to search for the resources on, and can -currently be a a buffer, a frame, a device, or the symbol @code{global}. +currently be a buffer, a frame, a device, or the symbol @code{global}. If omitted, it defaults to @code{global}. @item @@ -161,8 +173,8 @@ is an interface to a C call something like @example @code{XrmGetResource (db, "xemacs.buffer.@var{buffer-name}.foreground", - "Emacs.EmacsLocaleType.EmacsBuffer.Foreground", - "String");} + "Emacs.EmacsLocaleType.EmacsBuffer.Foreground", + "String");} @end example @item @@ -176,8 +188,8 @@ is an interface to a C call something like @example @code{XrmGetResource (db, "xemacs.frame.@var{frame-name}.foreground", - "Emacs.EmacsLocaleType.EmacsFrame.Foreground", - "String");} + "Emacs.EmacsLocaleType.EmacsFrame.Foreground", + "String");} @end example @item @@ -191,8 +203,8 @@ is an interface to a C call something like @example @code{XrmGetResource (db, "xemacs.device.@var{device-name}.foreground", - "Emacs.EmacsLocaleType.EmacsDevice.Foreground", - "String");} + "Emacs.EmacsLocaleType.EmacsDevice.Foreground", + "String");} @end example @item @@ -206,8 +218,8 @@ is an interface to a C call something like @example @code{XrmGetResource (db, "xemacs.foreground", - "Emacs.Foreground", - "String");} + "Emacs.Foreground", + "String");} @end example @end enumerate @@ -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 @@ -278,7 +290,7 @@ from previous versions of XEmacs, which returned @code{StaticGray}, @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.