annotate man/xresources.texi @ 40523:198cafe77e0f

Text broken out from cmdargs.texi.
author Richard M. Stallman <rms@gnu.org>
date Tue, 30 Oct 2001 18:38:57 +0000
parents
children a8c2103fca6f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
9 customize tool-bar menus, pop-up menus and tooltip windows, since they
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
10 are implemented by general-purpose libraries that always handle
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
11 customization this way. This appendix describes the X resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
12 that Emacs recognizes and what they mean.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
13
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
14 @node Display X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
15 @appendixsec Specifying the Display Name
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
16 @cindex display name (X Window System)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
17 @cindex @env{DISPLAY} environment variable
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
18
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
19 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
20 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
21 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
22 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
23 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
24 remotely, displaying on your local screen.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
25
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
26 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
27 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
28 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
29 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
30 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
31
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
32 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
33 @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
34 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
35 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
36 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
37 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
38 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
39 included, @var{screen} is usually zero.
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 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
42 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
43 @env{DISPLAY} is @samp{glasperle:0.0}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
44
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
45 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
46 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
47 @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
48
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
49 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
50 emacs --display=glasperle:0 &
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
51 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
52
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
53 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
54 @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
55 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
56
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
57 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
58 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
59 produces messages like this:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
60
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
61 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
62 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
63 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
64
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
65 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
66 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
67 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
68 remote machine.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
69
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
70 @node Font X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
71 @appendixsec Font Specification Options
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
72 @cindex font name (X Window System)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
73
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
74 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
75 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
76 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
77 @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
78 @samp{-fn}).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
79
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
80 @table @samp
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
81 @item -fn @var{name}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
82 @opindex -fn
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
83 @itemx --font=@var{name}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
84 @opindex --font
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
85 @cindex specify default font from the command line
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
86 Use font @var{name} as the default font.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
87 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
88
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
89 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
90 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
91 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
92 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
93 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
94 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
95
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
96 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
97 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
98 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
99
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
100 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
101 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
102
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
103 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
104 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
105 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
106
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
107 A long font name has the following form:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
108
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
109 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
110 -@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
111 @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
112 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
113
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
114 @table @var
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
115 @item maker
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
116 This is the name of the font manufacturer.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
117 @item family
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
118 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
119 @item weight
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
120 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
121 words may appear here in some font names.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
122 @item slant
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
123 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
124 @samp{ri} (reverse italic), or @samp{ot} (other).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
125 @item widthtype
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
126 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
127 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
128 @item style
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
129 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
130 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
131 @item pixels
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
132 This is the font height, in pixels.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
133 @item height
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
134 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
135 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
136 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
137 @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
138 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
139 @item horiz
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
140 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
141 which the font is intended.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
142 @item vert
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
143 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
144 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
145 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
146 specify @samp{*} for this and @var{horiz}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
147 @item spacing
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
148 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
149 (character cell).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
150 @item width
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
151 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
152 @item charset
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
153 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
154 Normally you should use @samp{iso8859-1}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
155 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
156
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
157 @cindex listing system fonts
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
158 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
159 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
160 @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
161 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
162 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
163
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
164 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
165 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
166 xlsfonts -fn '*-*-*-*-*-*-*-*-*-*-*-m*'
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
167 xlsfonts -fn '*-*-*-*-*-*-*-*-*-*-*-c*'
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
168 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
169
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
170 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
171 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
172 For example:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
173
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
174 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
175 xfd -fn 6x13
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
176 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
177
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
178 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
179 displays the entire font @samp{6x13}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
180
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
181 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
182 (@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
183 (@pxref{Faces}).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
184
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
185 @node Colors X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
186 @appendixsec Window Color Options
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
187 @cindex color of window
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
188 @cindex text colors, from command line
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
189
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
190 @findex list-colors-display
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
191 @cindex available colors
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
192 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
193 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
194 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
195 @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
196 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
197 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
198 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
199 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
200 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
201
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
202 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
203
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
204 @table @samp
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
205 @item -fg @var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
206 @opindex -fg
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
207 @itemx --foreground-color=@var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
208 @opindex --foreground-color
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
209 @cindex foreground color, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
210 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
211 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
212 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
213 @item -bg @var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
214 @opindex -bg
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
215 @itemx --background-color=@var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
216 @opindex --background-color
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
217 @cindex background color, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
218 Specify the background color.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
219 @item -bd @var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
220 @opindex -bd
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
221 @itemx --border-color=@var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
222 @opindex --border-color
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
223 @cindex border color, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
224 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
225 @item -cr @var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
226 @opindex -cr
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
227 @itemx --cursor-color=@var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
228 @opindex --cursor-color
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
229 @cindex cursor color, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
230 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
231 @item -ms @var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
232 @opindex -ms
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
233 @itemx --mouse-color=@var{color}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
234 @opindex --mouse-color
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
235 @cindex mouse pointer color, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
236 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
237 @item -r
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
238 @opindex -r
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
239 @itemx -rv
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
240 @opindex -rv
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
241 @itemx --reverse-video
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
242 @opindex --reverse-video
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
243 @cindex reverse video, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
244 Reverse video---swap the foreground and background colors.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
245 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
246
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
247 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
248 enter:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
249
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
250 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
251 emacs -ms coral -cr 'slate blue' &
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
252 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
253
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
254 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
255 @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
256
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
257 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
258 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
259
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
260 @node Window Size X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
261 @appendixsec Options for Window Geometry
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
262 @cindex geometry of Emacs window
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
263 @cindex position and size of Emacs frame
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
264 @cindex width and height of Emacs frame
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
265
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
266 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
267 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
268 geometry:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
269
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
270 @table @samp
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
271 @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
272 @opindex -g
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
273 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
274 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
275 (measured in pixels).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
276
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
277 @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
278 @opindex --geometry
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
279 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
280 @end table
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 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
283 @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
284 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
285 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
286 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
287 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
288 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
289 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
290
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
291 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
292 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
293 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
294 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
295 @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
296
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
297 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
298 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
299 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
300 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
301 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
302 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
303
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
304 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
305 specification.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
306
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
307 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
308 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
309 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
310 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
311 lines tall.
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 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
314 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
315 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
316 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
317 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
318 @samp{x45} specifies just the height.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
319
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
320 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
321 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
322 @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
323 @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
324 @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
325
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
326 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
327 @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
328 @samp{--geometry} option.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
329
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
330 @node Borders X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
331 @appendixsec Internal and External Borders
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
332 @cindex borders (X Window System)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
333
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
334 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
335 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
336 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
337 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
338 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
339 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
340
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
341 @table @samp
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
342 @item -ib @var{width}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
343 @opindex -ib
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
344 @itemx --internal-border=@var{width}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
345 @opindex --internal-border
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
346 @cindex border width, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
347 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
348
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
349 @item -bw @var{width}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
350 @opindex -bw
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
351 @itemx --border-width=@var{width}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
352 @opindex --border-width
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
353 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
354 @end table
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 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
357 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
358 external border.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
359
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
360 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
361 @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
362 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
363 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
364 external border is 2.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
365
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
366 @node Title X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
367 @appendixsec Frame Titles
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
368
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
369 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
370 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
371 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
372 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
373 (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
374 there is more than one frame).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
375
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
376 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
377 line option:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
378
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
379 @table @samp
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
380 @item -title @var{title}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
381 @opindex --title
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
382 @itemx --title=@var{title}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
383 @itemx -T @var{title}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
384 @opindex -T
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
385 @cindex frame title, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
386 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
387 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
388
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
389 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
390 for the initial Emacs frame.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
391
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
392 @node Icons X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
393 @appendixsec Icons
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
394 @cindex icons (X Window System)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
395
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
396 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
397 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
398 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
399 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
400 the screen by iconifying most of the clients.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
401
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
402 @table @samp
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
403 @item -i
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
404 @opindex -i
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
405 @itemx --icon-type
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
406 @opindex --icon-type
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
407 @cindex Emacs icon, a gnu
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
408 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
409
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
410 @item -iconic
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
411 @opindex --iconic
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
412 @itemx --iconic
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
413 @cindex start iconified, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
414 Start Emacs in iconified state.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
415 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
416
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
417 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
418 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
419 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
420 rectangle containing the frame's title.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
421
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
422 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
423 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
424 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
425 appear until you deiconify it.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
426
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
427 @node Resources X
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
428 @appendixsec X Resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
429 @cindex resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
430
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
431 @cindex X resources, @file{~/.Xdefaults} file
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
432 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
433 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
434 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
435 @file{~/.Xdefaults}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
436
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
437 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
438 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
439 (optionally even for all programs).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
440
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
441 @cindex Registry (MS-Windows)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
442 @cindex @file{.Xdefaults} file, and MS-Windows
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
443 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
444 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
445 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
446 and @samp{HKEY_LOCAL_MACHINE\SOFTWARE\GNU\Emacs}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
447
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
448 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
449 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
450 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
451 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
452 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
453 @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
454 names.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
455
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
456 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
457 on one line, like this:
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 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
460 emacs.borderWidth: 2
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
461 @end example
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 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
464 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
465 in that class. Here's an example:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
466
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
467 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
468 emacs.BorderWidth: 2
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
469 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
470
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
471 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
472 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
473 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
474 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
475 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
476
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
477 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
478 emacs.BorderWidth: 2
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
479 emacs.borderWidth: 4
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
480 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
481
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
482 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
483 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
484
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
485 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
486 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
487 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
488 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
489
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
490 @table @samp
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
491 @item -name @var{name}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
492 @opindex --name
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
493 @itemx --name=@var{name}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
494 @cindex resource name, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
495 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
496 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
497 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
498
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
499 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
500 executable's name as the resource name.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
501
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
502 @item -xrm @var{resource-values}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
503 @opindex --xrm
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
504 @itemx --xrm=@var{resource-values}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
505 @cindex resource values, command-line argument
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
506 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
507 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
508
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
509 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
510 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
511
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
512 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
513 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
514 @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
515 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
516 file. Here is an example:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
517
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
518 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
519 Emacs.BorderWidth: 2
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
520 Emacs.borderWidth: 4
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
521 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
522
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
523 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
524 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
525 @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
526 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
527 @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
528 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
529 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
530 take precedence over all other resource specifications.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
531
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
532 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
533 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
534
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
535 @table @asis
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
536 @item @code{background} (class @code{Background})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
537 Background color name.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
538
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
539 @item @code{bitmapIcon} (class @code{BitmapIcon})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
540 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
541 manager choose an icon if @samp{off}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
542
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
543 @item @code{borderColor} (class @code{BorderColor})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
544 Color name for the external border.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
545
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
546 @item @code{borderWidth} (class @code{BorderWidth})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
547 Width in pixels of the external border.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
548
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
549 @item @code{cursorColor} (class @code{Foreground})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
550 Color name for text cursor (point).
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
551
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
552 @item @code{font} (class @code{Font})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
553 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
554
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
555 @item @code{foreground} (class @code{Foreground})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
556 Color name for text.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
557
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
558 @item @code{geometry} (class @code{Geometry})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
559 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
560 @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
561 as the Emacs frame itself.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
562
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
563 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
564 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
565 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
566 all frames.
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{iconName} (class @code{Title})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
569 Name to display in the icon.
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{internalBorder} (class @code{BorderWidth})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
572 Width in pixels of the internal border.
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{lineSpacing} (class @code{LineSpacing})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
575 @cindex line spacing
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
576 @cindex leading
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
577 Additional space (@dfn{leading}) between lines, in pixels.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
578
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
579 @item @code{menuBar} (class @code{MenuBar})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
580 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
581
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
582 @item @code{toolBar} (class @code{ToolBar})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
583 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
584 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
585 @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
586 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
587
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
588 @item @code{minibuffer} (class @code{Minibuffer})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
589 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
590 It will use a separate minibuffer frame instead.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
591
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
592 @item @code{paneFont} (class @code{Font})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
593 @cindex font for menus
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
594 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
595
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
596 @item @code{pointerColor} (class @code{Foreground})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
597 Color of the mouse cursor.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
598
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
599 @ignore
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
600 @item @code{privateColormap} (class @code{PrivateColormap})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
601 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
602 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
603 @end ignore
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
604
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
605 @item @code{reverseVideo} (class @code{ReverseVideo})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
606 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
607 specified if @samp{off}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
608
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
609 @item @code{screenGamma} (class @code{ScreenGamma})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
610 @cindex gamma correction
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
611 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
612 @code{screen-gamma}.
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{selectionFont} (class @code{Font})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
615 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
616 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
617 Resources}.)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
618
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
619 @item @code{synchronous} (class @code{Synchronous})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
620 @cindex debugging X problems
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
621 @cindex synchronous X mode
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
622 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
623 useful for debugging X problems.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
624
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
625 @item @code{title} (class @code{Title})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
626 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
627
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
628 @item @code{verticalScrollBars} (class @code{ScrollBars})
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
629 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
630 @samp{off}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
631 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
632
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
633 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
634 (@pxref{Faces}):
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 @table @code
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
637 @item @var{face}.attributeFont
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
638 Font for face @var{face}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
639 @item @var{face}.attributeForeground
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
640 Foreground color for face @var{face}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
641 @item @var{face}.attributeBackground
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
642 Background color for face @var{face}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
643 @item @var{face}.attributeUnderline
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
644 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
645 yes.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
646 @item @var{face}.attributeFamily
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
647 Font family for face @var{face}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
648 @item @var{face}.attributeWidth
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
649 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
650 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
651 @code{condensed}, @code{semi-condensed}, @code{normal},
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
652 @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
653 @code{ultra-expanded}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
654 @item @var{face}.attributeHeight
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
655 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
656 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
657 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
658 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
659 will return a new height.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
660 @item @var{face}.attributeWeight
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
661 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
662 @code{ultra-bold}, @code{extra-bold}, @code{bold},
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
663 @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
664 @code{extra-light}, @code{ultra-light}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
665 @item @var{face}.attributeSlant
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
666 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
667 @code{italic}, @code{oblique}, @code{normal},
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
668 @code{reverse-italic}, or @code{reverse-oblique}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
669 @item @var{face}.attributeStrikeThrough
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
670 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
671 through the characters.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
672 @item @var{face}.attributeOverline
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
673 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
674 @item @var{face}.attributeBox
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
675 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
676 @item @var{face}.attributeInverse
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
677 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
678 video.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
679 @item @var{face}.attributeStipple
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
680 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
681 @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
682 @item @var{face}.attributeBackgroundPixmap
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
683 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
684 pixmap file or @code{false}.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
685 @item @var{face}.attributeBold
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
686 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
687 @item @var{face}.attributeItalic
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
688 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
689 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
690
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
691 @node Lucid Resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
692 @appendixsec Lucid Menu X Resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
693 @cindex Menu X Resources (Lucid widgets)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
694 @cindex Lucid Widget X Resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
695
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
696 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
697 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
698 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
699 (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
700 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
701
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
702 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
703 Emacs.pane.menubar.@var{resource}: @var{value}
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
704 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
705
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
706 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
707 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
708 write this:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
709
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
710 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
711 Emacs.pane.menubar.font: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
712 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
713
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
714 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
715 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
716 @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
717 @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
718
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
719 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
720 Emacs.menu*.font: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
721 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
722
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
723 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
724 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
725
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
726 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
727 Emacs.dialog*.font: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
728 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
729
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
730 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
731 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
732 @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
733 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
734
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
735 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
736
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
737 @table @code
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
738 @item font
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
739 Font for menu item text.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
740 @item foreground
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
741 Color of the foreground.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
742 @item background
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
743 Color of the background.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
744 @item buttonForeground
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
745 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
746 @item horizontalSpacing
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
747 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
748 @item verticalSpacing
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
749 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
750 @item arrowSpacing
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
751 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
752 the associated text. Default is 10.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
753 @item shadowThickness
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
754 Thickness of shadow line around the widget.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
755 @item margin
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
756 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
757 menu bar appear like the LessTif/Motif one.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
758 @end table
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
759
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
760 @node LessTif Resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
761 @appendixsec LessTif Menu X Resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
762 @cindex Menu X Resources (LessTif widgets)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
763 @cindex LessTif Widget X Resources
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
764
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
765 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
766 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
767 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
768 widgets and have their own resources.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
769
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
770 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
771 (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
772 @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
773 like this:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
774
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
775 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
776 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
777 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
778
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
779 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
780 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
781 @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
782 @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
783 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
784 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
785 @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
786
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
787 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
788 Emacs.pane.menubar.*.fontList: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
789 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
790
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
791 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
792 This also specifies the resource value for submenus.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
793
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
794 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
795 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
796 @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
797 item looks like this:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
798
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
799 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
800 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
801 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
802
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
803 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
804 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
805 buffer)} item:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
806
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
807 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
808 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
809 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
810
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
811 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
812 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
813 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
814 template:
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 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
817 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
818 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
819
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
820 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
821 For example,
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
822
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
823 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
824 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
825 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
826
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
827 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
828 (This should be one long line.)
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
829
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
830 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
831 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
832 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
833 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
834 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
835
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
836 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
837 Emacs.pane.menubar.*.fontList: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
838 Emacs.pane.menubar.popup_*.fontList: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
839 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
840
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
841 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
842 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
843 @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
844 the pop-up menu items, write this:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
845
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
846 @smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
847 Emacs.menu*.fontList: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
848 @end smallexample
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
849
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
850 @noindent
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
851 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
852
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
853 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
854 Emacs.dialog*.fontList: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
855 Emacs.dialog*.foreground: hotpink
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
856 @end 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 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
859 @samp{fsb*}, like this:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
860
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
861 @example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
862 Emacs.fsb*.fontList: 8x16
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
863 @end example
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
864
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
865 @iftex
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
866 @medbreak
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
867 @end iftex
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
868 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
869 pop-up menus:
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
870
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
871 @table @code
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
872 @item armColor
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
873 The color to show in an armed button.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
874 @item fontList
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
875 The font to use.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
876 @item marginBottom
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
877 @itemx marginHeight
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
878 @itemx marginLeft
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
879 @itemx marginRight
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
880 @itemx marginTop
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
881 @itemx marginWidth
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
882 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
883 @item borderWidth
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
884 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
885 @item shadowThickness
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
886 The width of the border shadow.
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
887 @item bottomShadowColor
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
888 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
889 @item topShadowColor
198cafe77e0f Text broken out from cmdargs.texi.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
890 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
891 @end table