Mercurial > emacs
annotate man/xresources.texi @ 41109:0bcf2d7f0112
(values, values-list, multiple-value-list, multiple-value-apply, nth-value):
Use defsubst rather than defalias, to get better doc strings.
author | Richard M. Stallman <rms@gnu.org> |
---|---|
date | Thu, 15 Nov 2001 23:57:43 +0000 |
parents | 3e02d6f71d09 |
children | 6a9bede30a62 |
rev | line source |
---|---|
40523
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
1 @c This is part of the Emacs manual. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
2 @c Copyright (C) 1987,93,94,95,1997,2001 Free Software Foundation, Inc. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
3 @c See file emacs.texi for copying conditions. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
4 @node X Resources, Antinews, Command Arguments, Top |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
5 @appendix X Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
6 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
7 Some aspects of Emacs behavior can be customized using X resources, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
8 as is usual for programs that use X. X resources are the only way to |
40765
3e02d6f71d09
Minor clarification of previous change.
Richard M. Stallman <rms@gnu.org>
parents:
40597
diff
changeset
|
9 customize tooltip windows and LessTif menus, since the libraries that |
3e02d6f71d09
Minor clarification of previous change.
Richard M. Stallman <rms@gnu.org>
parents:
40597
diff
changeset
|
10 implement them don't provide for customization through Emacs. This |
3e02d6f71d09
Minor clarification of previous change.
Richard M. Stallman <rms@gnu.org>
parents:
40597
diff
changeset
|
11 appendix describes the X resources that Emacs recognizes and what they |
3e02d6f71d09
Minor clarification of previous change.
Richard M. Stallman <rms@gnu.org>
parents:
40597
diff
changeset
|
12 mean. |
40523
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
13 |
40591 | 14 One way to experiment with the effect of different resource settings |
15 is to use the @code{editres} program. Select @samp{Get Tree} from the | |
16 @samp{Commands} menu, then click on an Emacs frame. This will display | |
17 a tree showing the structure of X toolkit widgets used in an Emacs | |
18 frame. Select one of them, such as @samp{menubar}, then select | |
40597
8a3401d69e10
(X Resources): Fix typo and syntax.
Pavel Janík <Pavel@Janik.cz>
parents:
40591
diff
changeset
|
19 @samp{Show Resource Box} from the @samp{Commands} menu. This displays |
40591 | 20 a list of all the meaningful X resources and allows you to edit them. |
21 Changes take effect immediately if you click on the @samp{Apply} button. | |
22 | |
23 @menu | |
24 * Display X:: Changing the default display and using remote login. | |
25 * Font X:: Choosing a font for text, under X. | |
26 * Colors X:: Choosing colors, under X. | |
27 * Window Size X:: Start-up window size, under X. | |
28 * Borders X:: Internal and external borders, under X. | |
29 * Title X:: Specifying the initial frame's title. | |
30 * Icons X:: Choosing what sort of icon to use, under X. | |
31 * Resources X:: Advanced use of classes and resources, under X. | |
32 * Lucid Resources:: X resources for Lucid menus. | |
33 * LessTif Resources:: X resources for LessTif and Motif menus. | |
34 @end menu | |
35 | |
40523
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
36 @node Display X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
37 @appendixsec Specifying the Display Name |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
38 @cindex display name (X Window System) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
39 @cindex @env{DISPLAY} environment variable |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
40 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
41 The environment variable @env{DISPLAY} tells all X clients, including |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
42 Emacs, where to display their windows. Its value is set by default |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
43 in ordinary circumstances, when you start an X server and run jobs |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
44 locally. Occasionally you may need to specify the display yourself; for |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
45 example, if you do a remote login and want to run a client program |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
46 remotely, displaying on your local screen. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
47 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
48 With Emacs, the main reason people change the default display is to |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
49 let them log into another system, run Emacs on that system, but have the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
50 window displayed at their local terminal. You might need to log in |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
51 to another system because the files you want to edit are there, or |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
52 because the Emacs executable file you want to run is there. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
53 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
54 The syntax of the @env{DISPLAY} environment variable is |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
55 @samp{@var{host}:@var{display}.@var{screen}}, where @var{host} is the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
56 host name of the X Window System server machine, @var{display} is an |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
57 arbitrarily-assigned number that distinguishes your server (X terminal) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
58 from other servers on the same machine, and @var{screen} is a |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
59 rarely-used field that allows an X server to control multiple terminal |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
60 screens. The period and the @var{screen} field are optional. If |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
61 included, @var{screen} is usually zero. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
62 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
63 For example, if your host is named @samp{glasperle} and your server is |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
64 the first (or perhaps the only) server listed in the configuration, your |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
65 @env{DISPLAY} is @samp{glasperle:0.0}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
66 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
67 You can specify the display name explicitly when you run Emacs, either |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
68 by changing the @env{DISPLAY} variable, or with the option @samp{-d |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
69 @var{display}} or @samp{--display=@var{display}}. Here is an example: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
70 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
71 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
72 emacs --display=glasperle:0 & |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
73 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
74 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
75 You can inhibit the direct use of the window system and GUI with the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
76 @samp{-nw} option. It tells Emacs to display using ordinary ASCII on |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
77 its controlling terminal. This is also an initial option. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
78 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
79 Sometimes, security arrangements prevent a program on a remote system |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
80 from displaying on your local system. In this case, trying to run Emacs |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
81 produces messages like this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
82 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
83 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
84 Xlib: connection to "glasperle:0.0" refused by server |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
85 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
86 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
87 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
88 You might be able to overcome this problem by using the @code{xhost} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
89 command on the local system to give permission for access from your |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
90 remote machine. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
91 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
92 @node Font X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
93 @appendixsec Font Specification Options |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
94 @cindex font name (X Window System) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
95 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
96 By default, Emacs displays text in the font named @samp{9x15}, which |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
97 makes each character nine pixels wide and fifteen pixels high. You can |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
98 specify a different font on your command line through the option |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
99 @samp{-fn @var{name}} (or @samp{--font}, which is an alias for |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
100 @samp{-fn}). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
101 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
102 @table @samp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
103 @item -fn @var{name} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
104 @opindex -fn |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
105 @itemx --font=@var{name} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
106 @opindex --font |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
107 @cindex specify default font from the command line |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
108 Use font @var{name} as the default font. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
109 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
110 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
111 Under X, each font has a long name which consists of eleven words or |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
112 numbers, separated by dashes. Some fonts also have shorter |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
113 nicknames---@samp{9x15} is such a nickname. You can use either kind of |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
114 name. You can use wildcard patterns for the font name; then Emacs lets |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
115 X choose one of the fonts that match the pattern. Here is an example, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
116 which happens to specify the font whose nickname is @samp{6x13}: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
117 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
118 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
119 emacs -fn "-misc-fixed-medium-r-semicondensed--13-*-*-*-c-60-iso8859-1" & |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
120 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
121 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
122 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
123 You can also specify the font in your @file{.Xdefaults} file: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
124 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
125 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
126 emacs.font: -misc-fixed-medium-r-semicondensed--13-*-*-*-c-60-iso8859-1 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
127 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
128 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
129 A long font name has the following form: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
130 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
131 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
132 -@var{maker}-@var{family}-@var{weight}-@var{slant}-@var{widthtype}-@var{style}@dots{} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
133 @dots{}-@var{pixels}-@var{height}-@var{horiz}-@var{vert}-@var{spacing}-@var{width}-@var{charset} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
134 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
135 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
136 @table @var |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
137 @item maker |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
138 This is the name of the font manufacturer. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
139 @item family |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
140 This is the name of the font family---for example, @samp{courier}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
141 @item weight |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
142 This is normally @samp{bold}, @samp{medium} or @samp{light}. Other |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
143 words may appear here in some font names. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
144 @item slant |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
145 This is @samp{r} (roman), @samp{i} (italic), @samp{o} (oblique), |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
146 @samp{ri} (reverse italic), or @samp{ot} (other). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
147 @item widthtype |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
148 This is normally @samp{condensed}, @samp{extended}, @samp{semicondensed} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
149 or @samp{normal}. Other words may appear here in some font names. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
150 @item style |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
151 This is an optional additional style name. Usually it is empty---most |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
152 long font names have two hyphens in a row at this point. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
153 @item pixels |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
154 This is the font height, in pixels. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
155 @item height |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
156 This is the font height on the screen, measured in tenths of a printer's |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
157 point---approximately 1/720 of an inch. In other words, it is the point |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
158 size of the font, times ten. For a given vertical resolution, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
159 @var{height} and @var{pixels} are proportional; therefore, it is common |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
160 to specify just one of them and use @samp{*} for the other. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
161 @item horiz |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
162 This is the horizontal resolution, in pixels per inch, of the screen for |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
163 which the font is intended. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
164 @item vert |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
165 This is the vertical resolution, in pixels per inch, of the screen for |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
166 which the font is intended. Normally the resolution of the fonts on |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
167 your system is the right value for your screen; therefore, you normally |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
168 specify @samp{*} for this and @var{horiz}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
169 @item spacing |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
170 This is @samp{m} (monospace), @samp{p} (proportional) or @samp{c} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
171 (character cell). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
172 @item width |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
173 This is the average character width, in pixels, multiplied by ten. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
174 @item charset |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
175 This is the character set that the font depicts. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
176 Normally you should use @samp{iso8859-1}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
177 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
178 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
179 @cindex listing system fonts |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
180 You will probably want to use a fixed-width default font---that is, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
181 a font in which all characters have the same width. Any font with |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
182 @samp{m} or @samp{c} in the @var{spacing} field of the long name is a |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
183 fixed-width font. Here's how to use the @code{xlsfonts} program to |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
184 list all the fixed-width fonts available on your system: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
185 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
186 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
187 xlsfonts -fn '*x*' | egrep "^[0-9]+x[0-9]+" |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
188 xlsfonts -fn '*-*-*-*-*-*-*-*-*-*-*-m*' |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
189 xlsfonts -fn '*-*-*-*-*-*-*-*-*-*-*-c*' |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
190 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
191 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
192 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
193 To see what a particular font looks like, use the @code{xfd} command. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
194 For example: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
195 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
196 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
197 xfd -fn 6x13 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
198 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
199 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
200 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
201 displays the entire font @samp{6x13}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
202 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
203 While running Emacs, you can set the font of the current frame |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
204 (@pxref{Frame Parameters}) or for a specific kind of text |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
205 (@pxref{Faces}). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
206 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
207 @node Colors X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
208 @appendixsec Window Color Options |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
209 @cindex color of window |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
210 @cindex text colors, from command line |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
211 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
212 @findex list-colors-display |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
213 @cindex available colors |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
214 On a color display, you can specify which color to use for various |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
215 parts of the Emacs display. To find out what colors are available on |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
216 your system, type @kbd{M-x list-colors-display}, or press |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
217 @kbd{C-Mouse-2} and select @samp{Display Colors} from the pop-up menu. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
218 If you do not specify colors, on windowed displays the default for the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
219 background is white and the default for all other colors is black. On a |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
220 monochrome display, the foreground is black, the background is white, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
221 and the border is gray if the display supports that. On terminals, the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
222 background is usually black and the foreground is white. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
223 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
224 Here is a list of the command-line options for specifying colors: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
225 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
226 @table @samp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
227 @item -fg @var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
228 @opindex -fg |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
229 @itemx --foreground-color=@var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
230 @opindex --foreground-color |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
231 @cindex foreground color, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
232 Specify the foreground color. @var{color} should be a standard color |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
233 name, or a numeric specification of the color's red, green, and blue |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
234 components as in @samp{#4682B4} or @samp{RGB:46/82/B4}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
235 @item -bg @var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
236 @opindex -bg |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
237 @itemx --background-color=@var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
238 @opindex --background-color |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
239 @cindex background color, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
240 Specify the background color. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
241 @item -bd @var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
242 @opindex -bd |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
243 @itemx --border-color=@var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
244 @opindex --border-color |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
245 @cindex border color, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
246 Specify the color of the border of the X window. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
247 @item -cr @var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
248 @opindex -cr |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
249 @itemx --cursor-color=@var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
250 @opindex --cursor-color |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
251 @cindex cursor color, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
252 Specify the color of the Emacs cursor which indicates where point is. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
253 @item -ms @var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
254 @opindex -ms |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
255 @itemx --mouse-color=@var{color} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
256 @opindex --mouse-color |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
257 @cindex mouse pointer color, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
258 Specify the color for the mouse cursor when the mouse is in the Emacs window. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
259 @item -r |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
260 @opindex -r |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
261 @itemx -rv |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
262 @opindex -rv |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
263 @itemx --reverse-video |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
264 @opindex --reverse-video |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
265 @cindex reverse video, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
266 Reverse video---swap the foreground and background colors. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
267 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
268 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
269 For example, to use a coral mouse cursor and a slate blue text cursor, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
270 enter: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
271 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
272 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
273 emacs -ms coral -cr 'slate blue' & |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
274 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
275 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
276 You can reverse the foreground and background colors through the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
277 @samp{-rv} option or with the X resource @samp{reverseVideo}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
278 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
279 The @samp{-fg}, @samp{-bg}, and @samp{-rv} options function on |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
280 text-only terminals as well as on window systems. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
281 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
282 @node Window Size X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
283 @appendixsec Options for Window Geometry |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
284 @cindex geometry of Emacs window |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
285 @cindex position and size of Emacs frame |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
286 @cindex width and height of Emacs frame |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
287 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
288 The @samp{--geometry} option controls the size and position of the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
289 initial Emacs frame. Here is the format for specifying the window |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
290 geometry: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
291 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
292 @table @samp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
293 @item -g @var{width}x@var{height}@r{[@{}+-@r{@}}@var{xoffset}@r{@{}+-@r{@}}@var{yoffset}@r{]]} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
294 @opindex -g |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
295 Specify window size @var{width} and @var{height} (measured in character |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
296 columns and lines), and positions @var{xoffset} and @var{yoffset} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
297 (measured in pixels). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
298 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
299 @item --geometry=@var{width}x@var{height}@r{[@{}+-@r{@}}@var{xoffset}@r{@{}+-@r{@}}@var{yoffset}@r{]]} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
300 @opindex --geometry |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
301 This is another way of writing the same thing. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
302 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
303 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
304 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
305 @code{@r{@{}+-@r{@}}} means either a plus sign or a minus sign. A plus |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
306 sign before @var{xoffset} means it is the distance from the left side of |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
307 the screen; a minus sign means it counts from the right side. A plus |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
308 sign before @var{yoffset} means it is the distance from the top of the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
309 screen, and a minus sign there indicates the distance from the bottom. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
310 The values @var{xoffset} and @var{yoffset} may themselves be positive or |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
311 negative, but that doesn't change their meaning, only their direction. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
312 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
313 Emacs uses the same units as @code{xterm} does to interpret the geometry. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
314 The @var{width} and @var{height} are measured in characters, so a large font |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
315 creates a larger frame than a small font. (If you specify a proportional |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
316 font, Emacs uses its maximum bounds width as the width unit.) The |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
317 @var{xoffset} and @var{yoffset} are measured in pixels. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
318 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
319 Since the mode line and the echo area occupy the last 2 lines of the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
320 frame, the height of the initial text window is 2 less than the height |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
321 specified in your geometry. In non-X-toolkit versions of Emacs, the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
322 menu bar also takes one line of the specified number. But in the X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
323 toolkit version, the menu bar is additional and does not count against |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
324 the specified height. The tool bar, if present, is also additional. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
325 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
326 You do not have to specify all of the fields in the geometry |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
327 specification. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
328 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
329 If you omit both @var{xoffset} and @var{yoffset}, the window manager |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
330 decides where to put the Emacs frame, possibly by letting you place |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
331 it with the mouse. For example, @samp{164x55} specifies a window 164 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
332 columns wide, enough for two ordinary width windows side by side, and 55 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
333 lines tall. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
334 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
335 The default width for Emacs is 80 characters and the default height is |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
336 40 lines. You can omit either the width or the height or both. If |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
337 you start the geometry with an integer, Emacs interprets it as the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
338 width. If you start with an @samp{x} followed by an integer, Emacs |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
339 interprets it as the height. Thus, @samp{81} specifies just the width; |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
340 @samp{x45} specifies just the height. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
341 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
342 If you start with @samp{+} or @samp{-}, that introduces an offset, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
343 which means both sizes are omitted. Thus, @samp{-3} specifies the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
344 @var{xoffset} only. (If you give just one offset, it is always |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
345 @var{xoffset}.) @samp{+3-3} specifies both the @var{xoffset} and the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
346 @var{yoffset}, placing the frame near the bottom left of the screen. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
347 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
348 You can specify a default for any or all of the fields in |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
349 @file{.Xdefaults} file, and then override selected fields with a |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
350 @samp{--geometry} option. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
351 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
352 @node Borders X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
353 @appendixsec Internal and External Borders |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
354 @cindex borders (X Window System) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
355 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
356 An Emacs frame has an internal border and an external border. The |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
357 internal border is an extra strip of the background color around the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
358 text portion of the frame. Emacs itself draws the internal border. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
359 The external border is added by the window manager outside the frame; |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
360 depending on the window manager you use, it may contain various boxes |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
361 you can click on to move or iconify the window. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
362 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
363 @table @samp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
364 @item -ib @var{width} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
365 @opindex -ib |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
366 @itemx --internal-border=@var{width} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
367 @opindex --internal-border |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
368 @cindex border width, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
369 Specify @var{width} as the width of the internal border, in pixels. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
370 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
371 @item -bw @var{width} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
372 @opindex -bw |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
373 @itemx --border-width=@var{width} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
374 @opindex --border-width |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
375 Specify @var{width} as the width of the main border, in pixels. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
376 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
377 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
378 When you specify the size of the frame, that does not count the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
379 borders. The frame's position is measured from the outside edge of the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
380 external border. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
381 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
382 Use the @samp{-ib @var{n}} option to specify an internal border |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
383 @var{n} pixels wide. The default is 1. Use @samp{-bw @var{n}} to |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
384 specify the width of the external border (though the window manager may |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
385 not pay attention to what you specify). The default width of the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
386 external border is 2. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
387 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
388 @node Title X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
389 @appendixsec Frame Titles |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
390 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
391 An Emacs frame may or may not have a specified title. The frame |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
392 title, if specified, appears in window decorations and icons as the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
393 name of the frame. If an Emacs frame has no specified title, the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
394 default title has the form @samp{@var{invocation-name}@@@var{machine}} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
395 (if there is only one frame) or the selected window's buffer name (if |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
396 there is more than one frame). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
397 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
398 You can specify a title for the initial Emacs frame with a command |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
399 line option: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
400 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
401 @table @samp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
402 @item -title @var{title} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
403 @opindex --title |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
404 @itemx --title=@var{title} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
405 @itemx -T @var{title} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
406 @opindex -T |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
407 @cindex frame title, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
408 Specify @var{title} as the title for the initial Emacs frame. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
409 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
410 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
411 The @samp{--name} option (@pxref{Resources X}) also specifies the title |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
412 for the initial Emacs frame. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
413 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
414 @node Icons X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
415 @appendixsec Icons |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
416 @cindex icons (X Window System) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
417 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
418 Most window managers allow the user to ``iconify'' a frame, removing |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
419 it from sight, and leaving a small, distinctive ``icon'' window in its |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
420 place. Clicking on the icon window makes the frame itself appear again. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
421 If you have many clients running at once, you can avoid cluttering up |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
422 the screen by iconifying most of the clients. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
423 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
424 @table @samp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
425 @item -i |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
426 @opindex -i |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
427 @itemx --icon-type |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
428 @opindex --icon-type |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
429 @cindex Emacs icon, a gnu |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
430 Use a picture of a gnu as the Emacs icon. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
431 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
432 @item -iconic |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
433 @opindex --iconic |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
434 @itemx --iconic |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
435 @cindex start iconified, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
436 Start Emacs in iconified state. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
437 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
438 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
439 The @samp{-i} or @samp{--icon-type} option tells Emacs to use an icon |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
440 window containing a picture of the GNU gnu. If omitted, Emacs lets the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
441 window manager choose what sort of icon to use---usually just a small |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
442 rectangle containing the frame's title. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
443 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
444 The @samp{-iconic} option tells Emacs to begin running as an icon, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
445 rather than showing a frame right away. In this situation, the icon |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
446 is the only indication that Emacs has started; the text frame doesn't |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
447 appear until you deiconify it. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
448 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
449 @node Resources X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
450 @appendixsec X Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
451 @cindex resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
452 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
453 @cindex X resources, @file{~/.Xdefaults} file |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
454 Programs running under the X Window System organize their user options |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
455 under a hierarchy of classes and resources. You can specify default |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
456 values for these options in your X resources file, usually named |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
457 @file{~/.Xdefaults}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
458 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
459 Each line in the file specifies a value for one option or for a |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
460 collection of related options, for one program or for several programs |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
461 (optionally even for all programs). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
462 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
463 @cindex Registry (MS-Windows) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
464 @cindex @file{.Xdefaults} file, and MS-Windows |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
465 MS-Windows systems don't support @file{~/.Xdefaults} files, but |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
466 Emacs compiled for Windows looks for X resources in the Windows |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
467 Registry, under the keys @samp{HKEY_CURRENT_USER\SOFTWARE\GNU\Emacs} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
468 and @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
469 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
470 Programs define named resources with particular meanings. They also |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
471 define how to group resources into named classes. For instance, in |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
472 Emacs, the @samp{internalBorder} resource controls the width of the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
473 internal border, and the @samp{borderWidth} resource controls the width |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
474 of the external border. Both of these resources are part of the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
475 @samp{BorderWidth} class. Case distinctions are significant in these |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
476 names. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
477 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
478 In @file{~/.Xdefaults}, you can specify a value for a single resource |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
479 on one line, like this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
480 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
481 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
482 emacs.borderWidth: 2 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
483 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
484 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
485 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
486 Or you can use a class name to specify the same value for all resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
487 in that class. Here's an example: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
488 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
489 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
490 emacs.BorderWidth: 2 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
491 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
492 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
493 If you specify a value for a class, it becomes the default for all |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
494 resources in that class. You can specify values for individual |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
495 resources as well; these override the class value, for those particular |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
496 resources. Thus, this example specifies 2 as the default width for all |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
497 borders, but overrides this value with 4 for the external border: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
498 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
499 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
500 emacs.BorderWidth: 2 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
501 emacs.borderWidth: 4 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
502 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
503 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
504 The order in which the lines appear in the file does not matter. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
505 Also, command-line options always override the X resources file. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
506 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
507 The string @samp{emacs} in the examples above is also a resource |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
508 name. It actually represents the name of the executable file that you |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
509 invoke to run Emacs. If Emacs is installed under a different name, it |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
510 looks for resources under that name instead of @samp{emacs}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
511 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
512 @table @samp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
513 @item -name @var{name} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
514 @opindex --name |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
515 @itemx --name=@var{name} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
516 @cindex resource name, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
517 Use @var{name} as the resource name (and the title) for the initial |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
518 Emacs frame. This option does not affect subsequent frames, but Lisp |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
519 programs can specify frame names when they create frames. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
520 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
521 If you don't specify this option, the default is to use the Emacs |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
522 executable's name as the resource name. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
523 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
524 @item -xrm @var{resource-values} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
525 @opindex --xrm |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
526 @itemx --xrm=@var{resource-values} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
527 @cindex resource values, command-line argument |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
528 Specify X resource values for this Emacs job (see below). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
529 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
530 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
531 For consistency, @samp{-name} also specifies the name to use for |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
532 other resource values that do not belong to any particular frame. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
533 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
534 The resources that name Emacs invocations also belong to a class; its |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
535 name is @samp{Emacs}. If you write @samp{Emacs} instead of |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
536 @samp{emacs}, the resource applies to all frames in all Emacs jobs, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
537 regardless of frame titles and regardless of the name of the executable |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
538 file. Here is an example: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
539 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
540 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
541 Emacs.BorderWidth: 2 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
542 Emacs.borderWidth: 4 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
543 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
544 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
545 You can specify a string of additional resource values for Emacs to |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
546 use with the command line option @samp{-xrm @var{resources}}. The text |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
547 @var{resources} should have the same format that you would use inside a file |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
548 of X resources. To include multiple resource specifications in |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
549 @var{resources}, put a newline between them, just as you would in a file. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
550 You can also use @samp{#include "@var{filename}"} to include a file full |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
551 of resource specifications. Resource values specified with @samp{-xrm} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
552 take precedence over all other resource specifications. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
553 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
554 The following table lists the resource names that designate options |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
555 for Emacs, each with the class that it belongs to: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
556 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
557 @table @asis |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
558 @item @code{background} (class @code{Background}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
559 Background color name. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
560 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
561 @item @code{bitmapIcon} (class @code{BitmapIcon}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
562 Use a bitmap icon (a picture of a gnu) if @samp{on}, let the window |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
563 manager choose an icon if @samp{off}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
564 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
565 @item @code{borderColor} (class @code{BorderColor}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
566 Color name for the external border. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
567 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
568 @item @code{borderWidth} (class @code{BorderWidth}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
569 Width in pixels of the external border. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
570 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
571 @item @code{cursorColor} (class @code{Foreground}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
572 Color name for text cursor (point). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
573 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
574 @item @code{font} (class @code{Font}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
575 Font name for text (or fontset name, @pxref{Fontsets}). |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
576 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
577 @item @code{foreground} (class @code{Foreground}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
578 Color name for text. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
579 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
580 @item @code{geometry} (class @code{Geometry}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
581 Window size and position. Be careful not to specify this resource as |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
582 @samp{emacs*geometry}, because that may affect individual menus as well |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
583 as the Emacs frame itself. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
584 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
585 If this resource specifies a position, that position applies only to the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
586 initial Emacs frame (or, in the case of a resource for a specific frame |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
587 name, only that frame). However, the size, if specified here, applies to |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
588 all frames. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
589 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
590 @item @code{iconName} (class @code{Title}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
591 Name to display in the icon. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
592 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
593 @item @code{internalBorder} (class @code{BorderWidth}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
594 Width in pixels of the internal border. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
595 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
596 @item @code{lineSpacing} (class @code{LineSpacing}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
597 @cindex line spacing |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
598 @cindex leading |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
599 Additional space (@dfn{leading}) between lines, in pixels. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
600 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
601 @item @code{menuBar} (class @code{MenuBar}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
602 Give frames menu bars if @samp{on}; don't have menu bars if @samp{off}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
603 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
604 @item @code{toolBar} (class @code{ToolBar}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
605 Number of lines to reserve for the tool bar. A zero value suppresses |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
606 the tool bar. If the value is non-zero and |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
607 @code{auto-resize-tool-bars} is non-@code{nil}, the tool bar's size |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
608 will be changed automatically so that all tool bar items are visible. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
609 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
610 @item @code{minibuffer} (class @code{Minibuffer}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
611 If @samp{none}, don't make a minibuffer in this frame. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
612 It will use a separate minibuffer frame instead. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
613 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
614 @item @code{paneFont} (class @code{Font}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
615 @cindex font for menus |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
616 Font name for menu pane titles, in non-toolkit versions of Emacs. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
617 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
618 @item @code{pointerColor} (class @code{Foreground}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
619 Color of the mouse cursor. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
620 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
621 @ignore |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
622 @item @code{privateColormap} (class @code{PrivateColormap}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
623 If @samp{on}, use a private color map, in the case where the ``default |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
624 visual'' of class PseudoColor and Emacs is using it. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
625 @end ignore |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
626 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
627 @item @code{reverseVideo} (class @code{ReverseVideo}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
628 Switch foreground and background default colors if @samp{on}, use colors as |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
629 specified if @samp{off}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
630 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
631 @item @code{screenGamma} (class @code{ScreenGamma}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
632 @cindex gamma correction |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
633 Gamma correction for colors, equivalent to the frame parameter |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
634 @code{screen-gamma}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
635 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
636 @item @code{selectionFont} (class @code{Font}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
637 Font name for pop-up menu items, in non-toolkit versions of Emacs. (For |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
638 toolkit versions, see @ref{Lucid Resources}, also see @ref{LessTif |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
639 Resources}.) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
640 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
641 @item @code{synchronous} (class @code{Synchronous}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
642 @cindex debugging X problems |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
643 @cindex synchronous X mode |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
644 Run Emacs in synchronous mode if @samp{on}. Synchronous mode is |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
645 useful for debugging X problems. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
646 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
647 @item @code{title} (class @code{Title}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
648 Name to display in the title bar of the initial Emacs frame. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
649 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
650 @item @code{verticalScrollBars} (class @code{ScrollBars}) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
651 Give frames scroll bars if @samp{on}; don't have scroll bars if |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
652 @samp{off}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
653 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
654 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
655 Here are resources for controlling the appearance of particular faces |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
656 (@pxref{Faces}): |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
657 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
658 @table @code |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
659 @item @var{face}.attributeFont |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
660 Font for face @var{face}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
661 @item @var{face}.attributeForeground |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
662 Foreground color for face @var{face}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
663 @item @var{face}.attributeBackground |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
664 Background color for face @var{face}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
665 @item @var{face}.attributeUnderline |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
666 Underline flag for face @var{face}. Use @samp{on} or @samp{true} for |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
667 yes. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
668 @item @var{face}.attributeFamily |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
669 Font family for face @var{face}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
670 @item @var{face}.attributeWidth |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
671 Relative proportional width of the font to use for face @var{face}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
672 It should be one of @code{ultra-condensed}, @code{extra-condensed}, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
673 @code{condensed}, @code{semi-condensed}, @code{normal}, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
674 @code{semi-expanded}, @code{expanded}, @code{extra-expanded}, or |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
675 @code{ultra-expanded}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
676 @item @var{face}.attributeHeight |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
677 Height of the font to use for face @var{face}: either an integer |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
678 specifying the height in units of 1/10@dmn{pt}, or a floating point |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
679 number that specifies a scale factor to scale the underlying face's |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
680 default font, or a function to be called with the default height which |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
681 will return a new height. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
682 @item @var{face}.attributeWeight |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
683 A weight to use for the face @var{face}. It must be one of |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
684 @code{ultra-bold}, @code{extra-bold}, @code{bold}, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
685 @code{semi-bold}, @code{normal}, @code{semi-light}, @code{light}, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
686 @code{extra-light}, @code{ultra-light}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
687 @item @var{face}.attributeSlant |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
688 The slant to use for the font of face @var{face}. It must be one of |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
689 @code{italic}, @code{oblique}, @code{normal}, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
690 @code{reverse-italic}, or @code{reverse-oblique}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
691 @item @var{face}.attributeStrikeThrough |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
692 Whether the face @var{face} should be drawn with a line striking |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
693 through the characters. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
694 @item @var{face}.attributeOverline |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
695 Whether the characters in the face @var{face} should be overlined. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
696 @item @var{face}.attributeBox |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
697 Whether to draw a box around the characters in face @var{face}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
698 @item @var{face}.attributeInverse |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
699 Whether to display the characters in face @var{face} in inverse |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
700 video. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
701 @item @var{face}.attributeStipple |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
702 The name of a pixmap data file to use for the stipple pattern, or |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
703 @code{false} to not use stipple for the face @var{face}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
704 @item @var{face}.attributeBackgroundPixmap |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
705 The background pixmap for the face @var{face}. Should be a name of a |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
706 pixmap file or @code{false}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
707 @item @var{face}.attributeBold |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
708 Whether to draw the characters in the face @var{face} as bold. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
709 @item @var{face}.attributeItalic |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
710 Whether to draw the characters in the face @var{face} as italic. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
711 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
712 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
713 @node Lucid Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
714 @appendixsec Lucid Menu X Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
715 @cindex Menu X Resources (Lucid widgets) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
716 @cindex Lucid Widget X Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
717 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
718 If the Emacs installed at your site was built to use the X toolkit |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
719 with the Lucid menu widgets, then the menu bar is a separate widget and |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
720 has its own resources. The resource names contain @samp{pane.menubar} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
721 (following, as always, the name of the Emacs invocation, or @samp{Emacs}, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
722 which stands for all Emacs invocations). Specify them like this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
723 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
724 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
725 Emacs.pane.menubar.@var{resource}: @var{value} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
726 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
727 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
728 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
729 For example, to specify the font @samp{8x16} for the menu-bar items, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
730 write this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
731 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
732 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
733 Emacs.pane.menubar.font: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
734 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
735 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
736 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
737 Resources for @emph{non-menubar} toolkit pop-up menus have |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
738 @samp{menu*}, in like fashion. For example, to specify the font |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
739 @samp{8x16} for the pop-up menu items, write this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
740 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
741 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
742 Emacs.menu*.font: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
743 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
744 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
745 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
746 For dialog boxes, use @samp{dialog} instead of @samp{menu}: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
747 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
748 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
749 Emacs.dialog*.font: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
750 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
751 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
752 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
753 Experience shows that on some systems you may need to add |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
754 @samp{shell.}@: before the @samp{pane.menubar} or @samp{menu*}. On |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
755 some other systems, you must not add @samp{shell.}. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
756 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
757 Here is a list of the specific resources for menu bars and pop-up menus: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
758 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
759 @table @code |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
760 @item font |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
761 Font for menu item text. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
762 @item foreground |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
763 Color of the foreground. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
764 @item background |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
765 Color of the background. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
766 @item buttonForeground |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
767 In the menu bar, the color of the foreground for a selected item. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
768 @item horizontalSpacing |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
769 Horizontal spacing in pixels between items. Default is 3. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
770 @item verticalSpacing |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
771 Vertical spacing in pixels between items. Default is 1. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
772 @item arrowSpacing |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
773 Horizontal spacing between the arrow (which indicates a submenu) and |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
774 the associated text. Default is 10. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
775 @item shadowThickness |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
776 Thickness of shadow line around the widget. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
777 @item margin |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
778 The margin of the menu bar, in characters. The default of 4 makes the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
779 menu bar appear like the LessTif/Motif one. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
780 @end table |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
781 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
782 @node LessTif Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
783 @appendixsec LessTif Menu X Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
784 @cindex Menu X Resources (LessTif widgets) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
785 @cindex LessTif Widget X Resources |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
786 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
787 If the Emacs installed at your site was built to use the X toolkit |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
788 with the LessTif or Motif widgets, then the menu bar, the dialog |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
789 boxes, the pop-up menus, and the file-selection box are separate |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
790 widgets and have their own resources. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
791 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
792 The resource names for the menu bar contain @samp{pane.menubar} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
793 (following, as always, the name of the Emacs invocation, or |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
794 @samp{Emacs}, which stands for all Emacs invocations). Specify them |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
795 like this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
796 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
797 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
798 Emacs.pane.menubar.@var{subwidget}.@var{resource}: @var{value} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
799 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
800 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
801 Each individual string in the menu bar is a subwidget; the subwidget's |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
802 name is the same as the menu item string. For example, the word |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
803 @samp{File} in the menu bar is part of a subwidget named |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
804 @samp{emacs.pane.menubar.File}. Most likely, you want to specify the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
805 same resources for the whole menu bar. To do this, use @samp{*} instead |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
806 of a specific subwidget name. For example, to specify the font |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
807 @samp{8x16} for the menu-bar items, write this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
808 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
809 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
810 Emacs.pane.menubar.*.fontList: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
811 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
812 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
813 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
814 This also specifies the resource value for submenus. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
815 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
816 Each item in a submenu in the menu bar also has its own name for X |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
817 resources; for example, the @samp{File} submenu has an item named |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
818 @samp{Save (current buffer)}. A resource specification for a submenu |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
819 item looks like this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
820 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
821 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
822 Emacs.pane.menubar.popup_*.@var{menu}.@var{item}.@var{resource}: @var{value} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
823 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
824 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
825 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
826 For example, here's how to specify the font for the @samp{Save (current |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
827 buffer)} item: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
828 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
829 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
830 Emacs.pane.menubar.popup_*.File.Save (current buffer).fontList: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
831 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
832 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
833 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
834 For an item in a second-level submenu, such as @samp{Complete Word} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
835 under @samp{Spell Checking} under @samp{Tools}, the resource fits this |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
836 template: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
837 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
838 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
839 Emacs.pane.menubar.popup_*.popup_*.@var{menu}.@var{resource}: @var{value} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
840 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
841 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
842 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
843 For example, |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
844 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
845 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
846 Emacs.pane.menubar.popup_*.popup_*.Spell Checking.Complete Word: @var{value} |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
847 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
848 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
849 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
850 (This should be one long line.) |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
851 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
852 It's impossible to specify a resource for all the menu-bar items |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
853 without also specifying it for the submenus as well. So if you want the |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
854 submenu items to look different from the menu bar itself, you must ask |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
855 for that in two steps. First, specify the resource for all of them; |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
856 then, override the value for submenus alone. Here is an example: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
857 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
858 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
859 Emacs.pane.menubar.*.fontList: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
860 Emacs.pane.menubar.popup_*.fontList: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
861 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
862 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
863 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
864 For LessTif pop-up menus, use @samp{menu*} instead of |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
865 @samp{pane.menubar}. For example, to specify the font @samp{8x16} for |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
866 the pop-up menu items, write this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
867 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
868 @smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
869 Emacs.menu*.fontList: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
870 @end smallexample |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
871 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
872 @noindent |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
873 For LessTif dialog boxes, use @samp{dialog} instead of @samp{menu}: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
874 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
875 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
876 Emacs.dialog*.fontList: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
877 Emacs.dialog*.foreground: hotpink |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
878 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
879 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
880 To specify resources for the LessTif file-selection box, use |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
881 @samp{fsb*}, like this: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
882 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
883 @example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
884 Emacs.fsb*.fontList: 8x16 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
885 @end example |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
886 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
887 @iftex |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
888 @medbreak |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
889 @end iftex |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
890 Here is a list of the specific resources for LessTif menu bars and |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
891 pop-up menus: |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
892 |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
893 @table @code |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
894 @item armColor |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
895 The color to show in an armed button. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
896 @item fontList |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
897 The font to use. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
898 @item marginBottom |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
899 @itemx marginHeight |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
900 @itemx marginLeft |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
901 @itemx marginRight |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
902 @itemx marginTop |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
903 @itemx marginWidth |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
904 Amount of space to leave around the item, within the border. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
905 @item borderWidth |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
906 The width of the border around the menu item, on all sides. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
907 @item shadowThickness |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
908 The width of the border shadow. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
909 @item bottomShadowColor |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
910 The color for the border shadow, on the bottom and the right. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
911 @item topShadowColor |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
912 The color for the border shadow, on the top and the left. |
198cafe77e0f
Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff
changeset
|
913 @end table |