1 |
COMMENT(-- $Id: rxvt-resources.yo,v 1.2 2003/11/24 17:31:27 pcg Exp $ --) |
2 |
COMMENT(----------------------------------------------------------------------) |
3 |
manpagesection(RESOURCES (available also as long-options)) |
4 |
|
5 |
Note: `rxvt --help' gives a list of all resources (long options) compiled |
6 |
into your version. |
7 |
If compiled with internal Xresources support (i.e. bf(rxvt -h) lists |
8 |
bf(.Xdefaults)) then bf(rxvt) accepts application defaults set in |
9 |
XAPPLOADDIR/Rxvt (compile-time defined: usually |
10 |
bf(/usr/lib/X11/app-defaults/Rxvt)) and resources set in bf(~/.Xdefaults), |
11 |
or bf(~/.Xresources) if bf(~/.Xdefaults) does not exist. Note that when |
12 |
reading X resources, bf(rxvt) recognizes two class names: bf(XTerm) and |
13 |
bf(Rxvt). The class name bf(XTerm) allows resources common to both |
14 |
bf(rxvt) and em(xterm) to be easily configured, while the class name |
15 |
bf(Rxvt) allows resources unique to bf(rxvt), notably colours and |
16 |
key-handling, to be shared between different bf(rxvt) configurations. |
17 |
If no resources are specified, suitable defaults will be used. |
18 |
Command-line arguments can be used to override resource settings. The |
19 |
following resources are allowed: |
20 |
|
21 |
startdit() |
22 |
dit(bf(geometry:) em(geom)) |
23 |
Create the window with the specified X window geometry [default |
24 |
80x24]; |
25 |
option bf(-geometry). |
26 |
dit(bf(background:) em(colour)) |
27 |
Use the specified colour as the window's background colour [default |
28 |
White]; |
29 |
option bf(-bg). |
30 |
dit(bf(foreground:) em(colour)) |
31 |
Use the specified colour as the window's foreground colour [default |
32 |
Black]; |
33 |
option bf(-fg). |
34 |
dit(bf(color)em(n)bf(:) em(colour)) |
35 |
Use the specified colour for the colour value em(n), where 0-7 |
36 |
corresponds to low-intensity (normal) colours and 8-15 corresponds to |
37 |
high-intensity (bold = bright foreground, blink = bright |
38 |
background) colours. The canonical names are as follows: |
39 |
0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, |
40 |
but the actual colour names used are listed in the |
41 |
bf(COLORS AND GRAPHICS) section. |
42 |
dit(bf(colorBD:) em(colour)) |
43 |
Use the specified colour to display bold characters when the |
44 |
foreground colour is the default. |
45 |
dit(bf(colorUL:) em(colour)) |
46 |
Use the specified colour to display underlined characters when the |
47 |
foreground colour is the default. |
48 |
dit(bf(colorRV:) em(colour)) |
49 |
Use the specified colour as the background for reverse video |
50 |
characters. |
51 |
dit(bf(cursorColor:) em(colour)) |
52 |
Use the specified colour for the cursor. The default is to use the |
53 |
foreground colour; |
54 |
option bf(-cr). |
55 |
dit(bf(cursorColor2:) em(colour)) |
56 |
Use the specified colour for the colour of the cursor text. For this |
57 |
to take effect, bf(cursorColor) must also be specified. The default |
58 |
is to use the background colour. |
59 |
dit(bf(reverseVideo:) em(boolean)) |
60 |
bf(True): simulate reverse video by foreground and background colours; |
61 |
option bf(-rv). |
62 |
bf(False): regular screen colours [default]; |
63 |
option bf(+rv). |
64 |
See note in bf(COLORS AND GRAPHICS) section. |
65 |
dit(bf(jumpScroll:) em(boolean)) |
66 |
bf(True): specify that jump scrolling should be used. When scrolling |
67 |
quickly, fewer screen updates are performed [default]; |
68 |
option bf(-j). |
69 |
bf(False): specify that smooth scrolling should be used; |
70 |
option bf(+j). |
71 |
dit(bf(inheritPixmap:) em(boolean)) |
72 |
bf(True): make the background inherit the parent windows' pixmap, |
73 |
giving artificial transparency. |
74 |
bf(False): do not inherit the parent windows' pixmap. |
75 |
dit(bf(scrollColor:) em(colour)) |
76 |
Use the specified colour for the scrollbar [default #B2B2B2]. |
77 |
dit(bf(troughColor:) em(colour)) |
78 |
Use the specified colour for the scrollbar's trough area [default |
79 |
#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. |
80 |
dit(bf(backgroundPixmap:) em(file[;geom])) |
81 |
Use the specified XPM file (note the `.xpm' extension is optional) |
82 |
for the background and also optionally specify its scaling with a |
83 |
geometry string bf(WxH+X+Y), in which bf("W" / "H") specify the |
84 |
horizontal/vertical scale (percent) and bf("X" / "Y") locate the |
85 |
image centre (percent). A scale of 0 displays the image with tiling. |
86 |
A scale of 1 displays the image without any scaling. A scale of 2 to |
87 |
9 specifies an integer number of images in that direction. No image |
88 |
will be magnified beyond 10 times its original size. The maximum |
89 |
permitted scale is 1000. [default 0x0+50+50] |
90 |
dit(bf(menu:) em(file[;tag])) |
91 |
Read in the specified menu file (note the `.menu' extension is |
92 |
optional) and also optionally specify a starting tag to find. See |
93 |
the reference documentation for details on the syntax for the menuBar. |
94 |
dit(bf(path:) em(path)) |
95 |
Specify the colon-delimited search path for finding files (XPM and |
96 |
menus), in addition to the paths specified by the bf(RXVTPATH) and |
97 |
bf(PATH) environment variables. |
98 |
dit(bf(font:) em(fontname)) |
99 |
Select the fonts to be used used. This is a comma seperated |
100 |
list of font names that are used in turn when trying to display |
101 |
unicode characters. The first font defines the cell size for characters, |
102 |
pther fonts might be smaller, but not larger. A reasonable default list |
103 |
is appended. |
104 |
option bf(-fn). |
105 |
dit(bf(greek_keyboard:) em(mode)) |
106 |
Set the Greek keyboard translation mode to be used; |
107 |
bf(iso): ISO-8859 mapping (elot-928) [default]. |
108 |
bf(ibm): IBM-437 mapping (DOS codepage 737); |
109 |
option bf(-grk). |
110 |
dit(bf(greektoggle_key:) em(keysym)) |
111 |
Set the key to toggle keyboard input between no translation and |
112 |
Greek translation [default bf(Mode_switch)]. |
113 |
For more details, see the distributed file bf(README.greek). |
114 |
dit(bf(selectstyle:) em(mode)) |
115 |
Set mouse selection style to bf(old) which is 2.20, bf(oldword) which |
116 |
is xterm style with 2.20 old word selection, or anything else which |
117 |
gives xterm style selection. |
118 |
dit(bf(scrollstyle:) em(mode)) |
119 |
Set scrollbar style to bf(rxvt), bf(next) or bf(xterm) |
120 |
dit(bf(title:) em(string)) |
121 |
Set window title string, the default title is the command-line |
122 |
specified after the bf(-e) option, if any, otherwise the application |
123 |
name; |
124 |
option bf(-title). |
125 |
dit(bf(iconName:) em(string)) |
126 |
Set the name used to label the window's icon or displayed in an icon |
127 |
manager window, it also sets the window's title unless it is |
128 |
explicitly set; |
129 |
option bf(-n). |
130 |
dit(bf(mapAlert:) em(boolean)) |
131 |
bf(True): de-iconify (map) on receipt of a bell character. |
132 |
bf(False): no de-iconify (map) on receipt of a bell character |
133 |
[default]. |
134 |
dit(bf(visualBell:) em(boolean)) |
135 |
bf(True): use visual bell on receipt of a bell character; |
136 |
option bf(-vb). |
137 |
bf(False): no visual bell [default]; |
138 |
option bf(+vb). |
139 |
dit(bf(loginShell:) em(boolean)) |
140 |
bf(True): start as a login shell by prepending a `-' to bf(argv[0]) |
141 |
of the shell; |
142 |
option bf(-ls). |
143 |
bf(False): start as a normal sub-shell [default]; |
144 |
option bf(+ls). |
145 |
dit(bf(utmpInhibit:) em(boolean)) |
146 |
bf(True): inhibit writing record into the system log file bf(utmp); |
147 |
option bf(-ut). |
148 |
bf(False): write record into the system log file bf(utmp) [default]; |
149 |
option bf(+ut). |
150 |
dit(bf(print-pipe:) em(string)) |
151 |
Specify a command pipe for vt100 printer [default em(lpr(1))]. Use |
152 |
bf(Print) to initiate a screen dump to the printer and bf(Ctrl-Print) |
153 |
or bf(Shift-Print) to include the scrollback as well. |
154 |
dit(bf(scrollBar:) em(boolean)) |
155 |
bf(True): enable the scrollbar [default]; |
156 |
option bf(-sb). |
157 |
bf(False): disable the scrollbar; |
158 |
option bf(+sb). |
159 |
dit(bf(scrollBar_right:) em(boolean)) |
160 |
bf(True): place the scrollbar on the right of the window; |
161 |
option bf(-sr). |
162 |
bf(False): place the scrollbar on the left of the window; |
163 |
option bf(+sr). |
164 |
dit(bf(scrollBar_floating:) em(boolean)) |
165 |
bf(True): display an rxvt scrollbar without a trough; |
166 |
option bf(-st). |
167 |
bf(False): display an rxvt scrollbar with a trough; |
168 |
option bf(+st). |
169 |
dit(bf(scrollBar_align:) em(mode)) |
170 |
Align the bf(top), bf(bottom) or bf(centre) [default] of |
171 |
the scrollbar thumb with the pointer on middle button |
172 |
press/drag. |
173 |
dit(bf(scrollTtyOutput:) em(boolean)) |
174 |
bf(True): scroll to bottom when tty receives output; |
175 |
option(+si). |
176 |
bf(False): do not scroll to bottom when tty receives output; |
177 |
option(-si). |
178 |
dit(bf(scrollWithBuffer:) em(boolean)) |
179 |
bf(True): scroll with scrollback buffer when tty recieves |
180 |
new lines (and bf(scrollTtyOutput) is False); |
181 |
option(+sw). |
182 |
bf(False): do not scroll with scrollback buffer when tty |
183 |
recieves new lines; |
184 |
option(-sw). |
185 |
dit(bf(scrollTtyKeypress:) em(boolean)) |
186 |
bf(True): scroll to bottom when a non-special key is pressed. |
187 |
Special keys are those which are intercepted by rxvt for special |
188 |
handling and are not passed onto the shell; |
189 |
option(-sk). |
190 |
bf(False): do not scroll to bottom when a non-special key is pressed; |
191 |
option(+sk). |
192 |
dit(bf(smallfont_key:) em(keysym)) |
193 |
If enabled, use bf(HOTKEY()-)em(keysym) to toggle to a smaller font |
194 |
[default bf(HOTKEY()-SMALLFONT())] |
195 |
dit(bf(bigfont_key:) em(keysym)) |
196 |
If enabled, use bf(HOTKEY()-)em(keysym) to toggle to a bigger font |
197 |
[default bf(HOTKEY()-BIGFONT())] |
198 |
dit(bf(saveLines:) em(number)) |
199 |
Save em(number) lines in the scrollback buffer [default 64]. This |
200 |
resource is limited on most machines to 65535; |
201 |
option bf(-sl). |
202 |
dit(bf(internalBorder:) em(number)) |
203 |
Internal border of em(number) pixels. This resource is limited to 100; |
204 |
option bf(-b). |
205 |
dit(bf(externalBorder:) em(number)) |
206 |
External border of em(number) pixels. This resource is limited to 100; |
207 |
option bf(-w), bf(-bw), bf(-borderwidth). |
208 |
dit(bf(termName:) em(termname)) |
209 |
Specifies the terminal type name to be set in the bf(TERM) |
210 |
environment variable; |
211 |
option bf(-tn). |
212 |
dit(bf(linespace:) em(number)) |
213 |
Specifies number of lines (pixel height) to insert between each row |
214 |
of the display [default 0]; |
215 |
option bf(-lsp). |
216 |
dit(bf(meta8:) em(boolean)) |
217 |
bf(True): handle Meta (Alt) + keypress to set the 8th bit. |
218 |
bf(False): handle Meta (Alt) + keypress as an escape prefix [default]. |
219 |
dit(bf(mouseWheelScrollPage:) em(boolean)) |
220 |
bf(True): the mouse wheel scrolls a page full. |
221 |
bf(False): the mouse wheel scrolls five lines [default]. |
222 |
dit(bf(cursorBlink:) em(boolean)) |
223 |
bf(True): blink the cursor. |
224 |
bf(False): do not blink the cursor [default]; |
225 |
option bf(-bc). |
226 |
dit(bf(pointerBlank:) em(boolean)) |
227 |
bf(True): blank the pointer when a key is pressed or after a set number |
228 |
of seconds of inactivity. |
229 |
bf(False): the pointer is always visible [default]. |
230 |
dit(bf(pointerBlankDelay:) em(number)) |
231 |
Specifies number of seconds before blanking the pointer [default 2]. |
232 |
dit(bf(multibyte_cursor:) em(boolean)) |
233 |
bf(True): consider multibyte glyphs as single character for backspace, |
234 |
delete and cursor movement keys; |
235 |
option bf(-mcc). |
236 |
bf(False): move through all components of all glyphs; |
237 |
option bf(+mcc). |
238 |
dit(bf(backspacekey:) em(string)) |
239 |
The string to send when the backspace key is pressed. If set to |
240 |
bf(DEC) or unset it will send bf(Delete) (code 127) or, if shifted, |
241 |
bf(Backspace) (code 8) - which can be reversed with the appropriate |
242 |
DEC private mode escape sequence. |
243 |
dit(bf(deletekey:) em(string)) |
244 |
The string to send when the delete key (not the keypad delete key) is |
245 |
pressed. If unset it will send the sequence traditionally associated |
246 |
with the bf(Execute) key. |
247 |
dit(bf(cutchars:) em(string)) |
248 |
The characters used as delimiters for double-click word selection. |
249 |
The built-in default: nl()\ |
250 |
bf(BACKSLASH `"'&()*,;<=>?@[]{|}) |
251 |
dit(bf(preeditType:) em(style)) |
252 |
bf(OverTheSpot), bf(OffTheSpot), bf(Root); |
253 |
option bf(-pt). |
254 |
dit(bf(inputMethod:) em(name)) |
255 |
em(name) of inputMethod to use; |
256 |
option bf(-im). |
257 |
dit(bf(imLocale:) em(name)) |
258 |
The locale to use for opening the IM. You can use an LC_CTYPE |
259 |
of e.g. de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP |
260 |
for the input extension to be able to input japanese characters |
261 |
while staying in another locale. |
262 |
option bf(-imlocale). |
263 |
dit(bf(modifier:) em(modifier)) |
264 |
Set the key to be interpreted as the Meta key to: |
265 |
bf(alt), bf(meta), bf(hyper), bf(super), bf(mod1), bf(mod2), bf(mod3), |
266 |
bf(mod4), bf(mod5); |
267 |
option bf(-mod). |
268 |
dit(bf(answerbackString:) em(string)) |
269 |
Specify the reply rxvt sends to the shell when an ENQ (control-E) |
270 |
character is passed through. It may contain escape values as |
271 |
described in the entry on bf(keysym) following. |
272 |
dit(bf(keysym.)em(sym): em(string)) |
273 |
Associate em(string) with keysym em(sym) (bf(0xFF00 - 0xFFFF)). It |
274 |
may contain escape values (\a: bell, \b: backspace, \e, \E: escape, |
275 |
\n: newline, \r: return, \t: tab, \000: octal number) or control |
276 |
characters (^?: delete, ^@: null, ^A ...) and may enclosed with |
277 |
double quotes so that it can start or end with whitespace. The |
278 |
intervening resource name bf(keysym.) cannot be omitted. This |
279 |
resource is only available when compiled with KEYSYM_RESOURCE. |
280 |
enddit() |