aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman1995-07-26 18:00:24 +0000
committerRichard M. Stallman1995-07-26 18:00:24 +0000
commita3431be8a6d8a21342d7d5a7df71e517071adc16 (patch)
treee78a6a4404d036757ba6b1210c8417340e011628
parentaa42ddbe493986f54727866912103937eccbd01c (diff)
downloademacs-a3431be8a6d8a21342d7d5a7df71e517071adc16.tar.gz
emacs-a3431be8a6d8a21342d7d5a7df71e517071adc16.zip
multiple-frames is not terminal-local.
Add frame argument to x-color-define-p and x-color-values.
-rw-r--r--lispref/frames.texi28
1 files changed, 15 insertions, 13 deletions
diff --git a/lispref/frames.texi b/lispref/frames.texi
index c0eb9d6aa92..f78258b9e75 100644
--- a/lispref/frames.texi
+++ b/lispref/frames.texi
@@ -102,9 +102,8 @@ own selected frame and its own minibuffer windows. A few Lisp variables
102have values local to the current terminal (that is, the terminal 102have values local to the current terminal (that is, the terminal
103corresponding to the currently selected frame): these are 103corresponding to the currently selected frame): these are
104@code{default-minibuffer-frame}, @code{defining-kbd-macro}, 104@code{default-minibuffer-frame}, @code{defining-kbd-macro},
105@code{last-kbd-macro}, @code{multiple-frames} and 105@code{last-kbd-macro}, and @code{system-key-alist}. These variables are
106@code{system-key-alist}. These variables are always terminal-local and 106always terminal-local and can never be buffer-local.
107can never be buffer-local.
108 107
109 A single X server can handle more than one screen. A display name 108 A single X server can handle more than one screen. A display name
110@samp{@var{host}.@var{server}.@var{screen}} has three parts; the last 109@samp{@var{host}.@var{server}.@var{screen}} has three parts; the last
@@ -562,9 +561,6 @@ there are two or more frames (not counting minibuffer-only frames or
562invisible frames). The default value of @code{frame-title-format} uses 561invisible frames). The default value of @code{frame-title-format} uses
563@code{multiple-frames} so as to put the buffer name in the frame title 562@code{multiple-frames} so as to put the buffer name in the frame title
564only when there is more than one frame. 563only when there is more than one frame.
565
566The variable is always local to the current terminal and cannot be
567buffer-local. @xref{Multiple Displays}.
568@end defvar 564@end defvar
569 565
570@node Deleting Frames 566@node Deleting Frames
@@ -1184,9 +1180,11 @@ like the way successive kills in Emacs move down the kill ring.
1184@node Color Names 1180@node Color Names
1185@section Color Names 1181@section Color Names
1186 1182
1187@defun x-color-defined-p color 1183@defun x-color-defined-p color &optional frame
1188This function reports whether a color name is meaningful. It returns 1184This function reports whether a color name is meaningful. It returns
1189@code{t} if so; otherwise, @code{nil}. 1185@code{t} if so; otherwise, @code{nil}. The argument @var{frame} says
1186which frame's display to ask about; if @var{frame} is omitted or
1187@code{nil}, the selected frame is used.
1190 1188
1191Note that this does not tell you whether the display you are using 1189Note that this does not tell you whether the display you are using
1192really supports that color. You can ask for any defined color on any 1190really supports that color. You can ask for any defined color on any
@@ -1195,16 +1193,16 @@ works. Here's an approximate way to test whether your display supports
1195the color @var{color}: 1193the color @var{color}:
1196 1194
1197@example 1195@example
1198(defun x-color-supported-p (color) 1196(defun x-color-supported-p (color &optional frame)
1199 (and (x-color-defined-p color) 1197 (and (x-color-defined-p color frame)
1200 (or (x-display-color-p) 1198 (or (x-display-color-p frame)
1201 (member color '("black" "white")) 1199 (member color '("black" "white"))
1202 (and (> (x-display-planes) 1) 1200 (and (> (x-display-planes frame) 1)
1203 (equal color "gray"))))) 1201 (equal color "gray")))))
1204@end example 1202@end example
1205@end defun 1203@end defun
1206 1204
1207@defun x-color-values color 1205@defun x-color-values color &optional frame
1208This function returns a value that describes what @var{color} should 1206This function returns a value that describes what @var{color} should
1209ideally look like. If @var{color} is defined, the value is a list of 1207ideally look like. If @var{color} is defined, the value is a list of
1210three integers, which give the amount of red, the amount of green, and 1208three integers, which give the amount of red, the amount of green, and
@@ -1224,6 +1222,10 @@ defined, the value is @code{nil}.
1224(x-color-values "hungry") 1222(x-color-values "hungry")
1225 @result{} nil 1223 @result{} nil
1226@end example 1224@end example
1225
1226The color values are returned for @var{frame}'s display. If @var{frame}
1227is omitted or @code{nil}, the information is return for the selected
1228frame's display.
1227@end defun 1229@end defun
1228 1230
1229@node Resources 1231@node Resources