| 1 |
COMMENT(-- $Id: rxvt-resources.yo,v 1.4 2004/02/22 08:36:11 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(selectstyle:) em(mode)) |
| 106 |
Set mouse selection style to bf(old) which is 2.20, bf(oldword) which |
| 107 |
is xterm style with 2.20 old word selection, or anything else which |
| 108 |
gives xterm style selection. |
| 109 |
dit(bf(scrollstyle:) em(mode)) |
| 110 |
Set scrollbar style to bf(rxvt), bf(next) or bf(xterm) |
| 111 |
dit(bf(title:) em(string)) |
| 112 |
Set window title string, the default title is the command-line |
| 113 |
specified after the bf(-e) option, if any, otherwise the application |
| 114 |
name; |
| 115 |
option bf(-title). |
| 116 |
dit(bf(iconName:) em(string)) |
| 117 |
Set the name used to label the window's icon or displayed in an icon |
| 118 |
manager window, it also sets the window's title unless it is |
| 119 |
explicitly set; |
| 120 |
option bf(-n). |
| 121 |
dit(bf(mapAlert:) em(boolean)) |
| 122 |
bf(True): de-iconify (map) on receipt of a bell character. |
| 123 |
bf(False): no de-iconify (map) on receipt of a bell character |
| 124 |
[default]. |
| 125 |
dit(bf(visualBell:) em(boolean)) |
| 126 |
bf(True): use visual bell on receipt of a bell character; |
| 127 |
option bf(-vb). |
| 128 |
bf(False): no visual bell [default]; |
| 129 |
option bf(+vb). |
| 130 |
dit(bf(loginShell:) em(boolean)) |
| 131 |
bf(True): start as a login shell by prepending a `-' to bf(argv[0]) |
| 132 |
of the shell; |
| 133 |
option bf(-ls). |
| 134 |
bf(False): start as a normal sub-shell [default]; |
| 135 |
option bf(+ls). |
| 136 |
dit(bf(utmpInhibit:) em(boolean)) |
| 137 |
bf(True): inhibit writing record into the system log file bf(utmp); |
| 138 |
option bf(-ut). |
| 139 |
bf(False): write record into the system log file bf(utmp) [default]; |
| 140 |
option bf(+ut). |
| 141 |
dit(bf(print-pipe:) em(string)) |
| 142 |
Specify a command pipe for vt100 printer [default em(lpr(1))]. Use |
| 143 |
bf(Print) to initiate a screen dump to the printer and bf(Ctrl-Print) |
| 144 |
or bf(Shift-Print) to include the scrollback as well. |
| 145 |
dit(bf(scrollBar:) em(boolean)) |
| 146 |
bf(True): enable the scrollbar [default]; |
| 147 |
option bf(-sb). |
| 148 |
bf(False): disable the scrollbar; |
| 149 |
option bf(+sb). |
| 150 |
dit(bf(scrollBar_right:) em(boolean)) |
| 151 |
bf(True): place the scrollbar on the right of the window; |
| 152 |
option bf(-sr). |
| 153 |
bf(False): place the scrollbar on the left of the window; |
| 154 |
option bf(+sr). |
| 155 |
dit(bf(scrollBar_floating:) em(boolean)) |
| 156 |
bf(True): display an rxvt scrollbar without a trough; |
| 157 |
option bf(-st). |
| 158 |
bf(False): display an rxvt scrollbar with a trough; |
| 159 |
option bf(+st). |
| 160 |
dit(bf(scrollBar_align:) em(mode)) |
| 161 |
Align the bf(top), bf(bottom) or bf(centre) [default] of |
| 162 |
the scrollbar thumb with the pointer on middle button |
| 163 |
press/drag. |
| 164 |
dit(bf(scrollTtyOutput:) em(boolean)) |
| 165 |
bf(True): scroll to bottom when tty receives output; |
| 166 |
option(+si). |
| 167 |
bf(False): do not scroll to bottom when tty receives output; |
| 168 |
option(-si). |
| 169 |
dit(bf(scrollWithBuffer:) em(boolean)) |
| 170 |
bf(True): scroll with scrollback buffer when tty recieves |
| 171 |
new lines (and bf(scrollTtyOutput) is False); |
| 172 |
option(+sw). |
| 173 |
bf(False): do not scroll with scrollback buffer when tty |
| 174 |
recieves new lines; |
| 175 |
option(-sw). |
| 176 |
dit(bf(scrollTtyKeypress:) em(boolean)) |
| 177 |
bf(True): scroll to bottom when a non-special key is pressed. |
| 178 |
Special keys are those which are intercepted by rxvt for special |
| 179 |
handling and are not passed onto the shell; |
| 180 |
option(-sk). |
| 181 |
bf(False): do not scroll to bottom when a non-special key is pressed; |
| 182 |
option(+sk). |
| 183 |
dit(bf(smallfont_key:) em(keysym)) |
| 184 |
If enabled, use bf(HOTKEY()-)em(keysym) to toggle to a smaller font |
| 185 |
[default bf(HOTKEY()-SMALLFONT())] |
| 186 |
dit(bf(bigfont_key:) em(keysym)) |
| 187 |
If enabled, use bf(HOTKEY()-)em(keysym) to toggle to a bigger font |
| 188 |
[default bf(HOTKEY()-BIGFONT())] |
| 189 |
dit(bf(saveLines:) em(number)) |
| 190 |
Save em(number) lines in the scrollback buffer [default 64]. This |
| 191 |
resource is limited on most machines to 65535; |
| 192 |
option bf(-sl). |
| 193 |
dit(bf(internalBorder:) em(number)) |
| 194 |
Internal border of em(number) pixels. This resource is limited to 100; |
| 195 |
option bf(-b). |
| 196 |
dit(bf(externalBorder:) em(number)) |
| 197 |
External border of em(number) pixels. This resource is limited to 100; |
| 198 |
option bf(-w), bf(-bw), bf(-borderwidth). |
| 199 |
dit(bf(termName:) em(termname)) |
| 200 |
Specifies the terminal type name to be set in the bf(TERM) |
| 201 |
environment variable; |
| 202 |
option bf(-tn). |
| 203 |
dit(bf(linespace:) em(number)) |
| 204 |
Specifies number of lines (pixel height) to insert between each row |
| 205 |
of the display [default 0]; |
| 206 |
option bf(-lsp). |
| 207 |
dit(bf(meta8:) em(boolean)) |
| 208 |
bf(True): handle Meta (Alt) + keypress to set the 8th bit. |
| 209 |
bf(False): handle Meta (Alt) + keypress as an escape prefix [default]. |
| 210 |
dit(bf(mouseWheelScrollPage:) em(boolean)) |
| 211 |
bf(True): the mouse wheel scrolls a page full. |
| 212 |
bf(False): the mouse wheel scrolls five lines [default]. |
| 213 |
dit(bf(cursorBlink:) em(boolean)) |
| 214 |
bf(True): blink the cursor. |
| 215 |
bf(False): do not blink the cursor [default]; |
| 216 |
option bf(-bc). |
| 217 |
dit(bf(pointerBlank:) em(boolean)) |
| 218 |
bf(True): blank the pointer when a key is pressed or after a set number |
| 219 |
of seconds of inactivity. |
| 220 |
bf(False): the pointer is always visible [default]. |
| 221 |
dit(bf(pointerBlankDelay:) em(number)) |
| 222 |
Specifies number of seconds before blanking the pointer [default 2]. |
| 223 |
dit(bf(backspacekey:) em(string)) |
| 224 |
The string to send when the backspace key is pressed. If set to |
| 225 |
bf(DEC) or unset it will send bf(Delete) (code 127) or, if shifted, |
| 226 |
bf(Backspace) (code 8) - which can be reversed with the appropriate |
| 227 |
DEC private mode escape sequence. |
| 228 |
dit(bf(deletekey:) em(string)) |
| 229 |
The string to send when the delete key (not the keypad delete key) is |
| 230 |
pressed. If unset it will send the sequence traditionally associated |
| 231 |
with the bf(Execute) key. |
| 232 |
dit(bf(cutchars:) em(string)) |
| 233 |
The characters used as delimiters for double-click word selection. |
| 234 |
The built-in default: nl()\ |
| 235 |
bf(BACKSLASH `"'&()*,;<=>?@[]{|}) |
| 236 |
dit(bf(preeditType:) em(style)) |
| 237 |
bf(OverTheSpot), bf(OffTheSpot), bf(Root); |
| 238 |
option bf(-pt). |
| 239 |
dit(bf(inputMethod:) em(name)) |
| 240 |
em(name) of inputMethod to use; |
| 241 |
option bf(-im). |
| 242 |
dit(bf(imLocale:) em(name)) |
| 243 |
The locale to use for opening the IM. You can use an LC_CTYPE |
| 244 |
of e.g. de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP |
| 245 |
for the input extension to be able to input japanese characters |
| 246 |
while staying in another locale. |
| 247 |
option bf(-imlocale). |
| 248 |
dit(bf(modifier:) em(modifier)) |
| 249 |
Set the key to be interpreted as the Meta key to: |
| 250 |
bf(alt), bf(meta), bf(hyper), bf(super), bf(mod1), bf(mod2), bf(mod3), |
| 251 |
bf(mod4), bf(mod5); |
| 252 |
option bf(-mod). |
| 253 |
dit(bf(answerbackString:) em(string)) |
| 254 |
Specify the reply rxvt sends to the shell when an ENQ (control-E) |
| 255 |
character is passed through. It may contain escape values as |
| 256 |
described in the entry on bf(keysym) following. |
| 257 |
dit(bf(keysym.)em(sym): em(string)) |
| 258 |
Associate em(string) with keysym em(sym) (bf(0xFF00 - 0xFFFF)). It |
| 259 |
may contain escape values (\a: bell, \b: backspace, \e, \E: escape, |
| 260 |
\n: newline, \r: return, \t: tab, \000: octal number) or control |
| 261 |
characters (^?: delete, ^@: null, ^A ...) and may enclosed with |
| 262 |
double quotes so that it can start or end with whitespace. The |
| 263 |
intervening resource name bf(keysym.) cannot be omitted. This |
| 264 |
resource is only available when compiled with KEYSYM_RESOURCE. |
| 265 |
enddit() |
