| 1 |
.TH "RXVT" "1" "2004-08-11" "X Version 11" "X Tools" |
| 2 |
.SH "NAME" |
| 3 |
rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
| 4 |
.PP |
| 5 |
.SH "SYNOPSIS" |
| 6 |
.PP |
| 7 |
\fBrxvt\fP [options] [-e command [ args ]] |
| 8 |
.PP |
| 9 |
.SH "DESCRIPTION" |
| 10 |
.PP |
| 11 |
\fBrxvt-unicode\fP, version \fB3\&.5\fP, is a colour vt102 terminal emulator |
| 12 |
intended as an \fIxterm\fP(1) replacement for users who do not require |
| 13 |
features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
| 14 |
As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
| 15 |
advantage on a machine serving many X sessions\&. |
| 16 |
.PP |
| 17 |
.PP |
| 18 |
.SH "OPTIONS" |
| 19 |
.PP |
| 20 |
The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. |
| 21 |
In keeping with the smaller-is-better philosophy, options may be eliminated |
| 22 |
or default values chosen at compile-time, so options and defaults listed |
| 23 |
may not accurately reflect the version installed on your system\&. |
| 24 |
`rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. |
| 25 |
Option descriptions may be prefixed with which compile option each is |
| 26 |
dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP |
| 27 |
line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled |
| 28 |
into your version\&. |
| 29 |
.PP |
| 30 |
Note that \fBrxvt\fP permits the resource name to be used as a long-option |
| 31 |
(--/++ option) so the potential command-line options are far greater than |
| 32 |
those listed\&. |
| 33 |
For example: `rxvt --loginShell --color1 Orange\&'\&. |
| 34 |
.PP |
| 35 |
The following options are available: |
| 36 |
.PP |
| 37 |
.IP "\fB-help\fP, \fB--help\fP" |
| 38 |
Print out a message describing available options\&. |
| 39 |
.IP "\fB-display\fP \fIdisplayname\fP" |
| 40 |
Attempt to open a window on the named X display (\fB-d\fP still |
| 41 |
respected)\&. In the absence of this option, the display specified |
| 42 |
by the \fBDISPLAY\fP environment variable is used\&. |
| 43 |
.IP "\fB-geometry\fP \fIgeom\fP" |
| 44 |
Window geometry (\fB-g\fP still respected); |
| 45 |
resource \fBgeometry\fP\&. |
| 46 |
.IP "\fB-rv\fP|\fB+rv\fP" |
| 47 |
Turn on/off simulated reverse video; |
| 48 |
resource \fBreverseVideo\fP\&. |
| 49 |
.IP "\fB-j\fP|\fB+j\fP" |
| 50 |
Turn on/off jump scrolling; |
| 51 |
resource \fBjumpScroll\fP\&. |
| 52 |
.IP "\fB-ip\fP|\fB+ip\fP" |
| 53 |
Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
| 54 |
is \fB-tr\fP; |
| 55 |
resource \fBinheritPixmap\fP\&. |
| 56 |
.IP "\fB-fade\fP \fInumber\fP" |
| 57 |
Fade the text by the given percentage when focus is lost\&. |
| 58 |
.IP "\fB-tint\fP \fIcolour\fP" |
| 59 |
Tint the transparent background pixmap with the given colour when |
| 60 |
transparency is enabled with \fB-tr\fP or \fB-ip\fP\&. See also |
| 61 |
the \fB-sh\fP option that can be used to brighten or darken |
| 62 |
the image in addition to tinting it\&. |
| 63 |
.IP "\fB-sh\fP" |
| 64 |
\fInumber\fP |
| 65 |
Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background |
| 66 |
image in addition to tinting it (i\&.e\&. \fB-tint\fP must be specified, too)\&. |
| 67 |
.IP "\fB-bg\fP \fIcolour\fP" |
| 68 |
Window background colour; |
| 69 |
resource \fBbackground\fP\&. |
| 70 |
.IP "\fB-fg\fP \fIcolour\fP" |
| 71 |
Window foreground colour; |
| 72 |
resource \fBforeground\fP\&. |
| 73 |
.IP "\fB-pixmap\fP \fIfile[;geom]\fP" |
| 74 |
Compile \fIXPM\fP: Specify XPM file for the background and also |
| 75 |
optionally specify its scaling with a geometry string\&. Note you |
| 76 |
may need to add quotes to avoid special shell interpretation of |
| 77 |
the `;\&' in the command-line; |
| 78 |
resource \fBbackgroundPixmap\fP\&. |
| 79 |
.IP "\fB-cr\fP \fIcolour\fP" |
| 80 |
The cursor colour; |
| 81 |
resource \fBcursorColor\fP\&. |
| 82 |
.IP "\fB-pr\fP \fIcolour\fP" |
| 83 |
The mouse pointer foreground colour; |
| 84 |
resource \fBpointerColor\fP\&. |
| 85 |
.IP "\fB-pr2\fP \fIcolour\fP" |
| 86 |
The mouse pointer background colour; |
| 87 |
resource \fBpointerColor2\fP\&. |
| 88 |
.IP "\fB-bd\fP \fIcolour\fP" |
| 89 |
The colour of the border between the xterm scrollbar and the text; |
| 90 |
resource \fBborderColor\fP\&. |
| 91 |
.IP "\fB-fn\fP \fIfontname\fP" |
| 92 |
Select the fonts to be used\&. |
| 93 |
This is a comma seperated list of font names that are used in turn when |
| 94 |
trying to display Unicode characters\&. |
| 95 |
The first font defines the cell size for characters; other fonts might |
| 96 |
be smaller, but not larger\&. |
| 97 |
A reasonable default font list is always appended to it\&. |
| 98 |
resource \fBfont\fP\&. |
| 99 |
.IP "\fB-rb\fP|\fB+rb\fP" |
| 100 |
Enable "real bold" support\&. |
| 101 |
When this option is on, bold text will be displayed using the first |
| 102 |
available bold font in the font list\&. |
| 103 |
Bold fonts should thus be specified in the font list after their |
| 104 |
corresponding regular fonts\&. |
| 105 |
If no bold font can be found, a regular font will be used\&. |
| 106 |
resource \fBrealBold\fP\&. |
| 107 |
.IP "\fB-name\fP \fIname\fP" |
| 108 |
Specify the application name under which resources |
| 109 |
are to be obtained, rather than the default executable file name\&. |
| 110 |
Name should not contain `\&.\&' or `*\&' characters\&. |
| 111 |
Also sets the icon and title name\&. |
| 112 |
.IP "\fB-ls\fP|\fB+ls\fP" |
| 113 |
Start as a login-shell/sub-shell; |
| 114 |
resource \fBloginShell\fP\&. |
| 115 |
.IP "\fB-ut\fP|\fB+ut\fP" |
| 116 |
Compile \fIutmp\fP: Inhibit/enable writing a utmp entry; |
| 117 |
resource \fButmpInhibit\fP\&. |
| 118 |
.IP "\fB-vb\fP|\fB+vb\fP" |
| 119 |
Turn on/off visual bell on receipt of a bell character; |
| 120 |
resource \fBvisualBell\fP\&. |
| 121 |
.IP "\fB-sb\fP|\fB+sb\fP" |
| 122 |
Turn on/off scrollbar; |
| 123 |
resource \fBscrollBar\fP\&. |
| 124 |
.IP "\fB-si\fP|\fB+si\fP" |
| 125 |
Turn on/off scroll-to-bottom on TTY output inhibit; |
| 126 |
resource \fBscrollTtyOutput\fP has opposite effect\&. |
| 127 |
.IP "\fB-sk\fP|\fB+sk\fP" |
| 128 |
Turn on/off scroll-to-bottom on keypress; |
| 129 |
resource \fBscrollTtyKeypress\fP\&. |
| 130 |
.IP "\fB-sw\fP|\fB+sw\fP" |
| 131 |
Turn on/off scrolling with the scrollback buffer as new |
| 132 |
lines appear\&. This only takes effect if \fB-si\fP is also given; |
| 133 |
resource \fBscrollWithBuffer\fP\&. |
| 134 |
.IP "\fB-sr\fP|\fB+sr\fP" |
| 135 |
Put scrollbar on right/left; |
| 136 |
resource \fBscrollBar_right\fP\&. |
| 137 |
.IP "\fB-st\fP|\fB+st\fP" |
| 138 |
Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
| 139 |
resource \fBscrollBar_floating\fP\&. |
| 140 |
.IP "\fB-bc\fP|\fB+bc\fP" |
| 141 |
Blink the cursor; resource \fBcursorBlink\fP\&. |
| 142 |
.IP "\fB-iconic\fP" |
| 143 |
Start iconified, if the window manager supports that option\&. |
| 144 |
Alternative form is \fB-ic\fP\&. |
| 145 |
.IP "\fB-sl\fP \fInumber\fP" |
| 146 |
Save \fInumber\fP lines in the scrollback buffer\&. See resource entry |
| 147 |
for limits; |
| 148 |
resource \fBsaveLines\fP\&. |
| 149 |
.IP "\fB-b\fP \fInumber\fP" |
| 150 |
Compile \fIfrills\fP: Internal border of \fInumber\fP pixels\&. See |
| 151 |
resource entry for limits; |
| 152 |
resource \fBinternalBorder\fP\&. |
| 153 |
.IP "\fB-w\fP \fInumber\fP" |
| 154 |
Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. |
| 155 |
Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits; |
| 156 |
resource \fBexternalBorder\fP\&. |
| 157 |
.IP "\fB-bl\fP" |
| 158 |
Compile \fIfrills\fP: Set MWM hints to request a borderless window, |
| 159 |
i\&.e\&. if honoured by the WM, the rxvt window will not have window |
| 160 |
decorations; resource \fBborderLess\fP\&. |
| 161 |
.IP "\fB-lsp\fP \fInumber\fP" |
| 162 |
Compile \fIlinespace\fP: Lines (pixel height) to insert between each |
| 163 |
row of the display; |
| 164 |
resource \fBlinespace\fP\&. |
| 165 |
.IP "\fB-tn\fP \fItermname\fP" |
| 166 |
This option specifies the name of the terminal type to be set in the |
| 167 |
\fBTERM\fP environment variable\&. This terminal type must exist in the |
| 168 |
\fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; |
| 169 |
resource \fBtermName\fP\&. |
| 170 |
.IP "\fB-e\fP \fIcommand [arguments]\fP" |
| 171 |
Run the command with its command-line arguments in the \fBrxvt\fP |
| 172 |
window; also sets the window title and icon name to be the basename |
| 173 |
of the program being executed if neither \fI-title\fP (\fI-T\fP) nor |
| 174 |
\fI-n\fP are given on the command line\&. If this option is used, it |
| 175 |
must be the last on the command-line\&. If there is no \fB-e\fP option |
| 176 |
then the default is to run the program specified by the \fBSHELL\fP |
| 177 |
environment variable or, failing that, \fIsh(1)\fP\&. |
| 178 |
.IP "\fB-title\fP \fItext\fP" |
| 179 |
Window title (\fB-T\fP still respected); the default title is the |
| 180 |
basename of the program specified after the \fB-e\fP option, if |
| 181 |
any, otherwise the application name; |
| 182 |
resource \fBtitle\fP\&. |
| 183 |
.IP "\fB-n\fP \fItext\fP" |
| 184 |
Icon name; the default name is the basename of the program specified |
| 185 |
after the \fB-e\fP option, if any, otherwise the application name; |
| 186 |
resource \fBiconName\fP\&. |
| 187 |
.IP "\fB-C\fP" |
| 188 |
Capture system console messages\&. |
| 189 |
.IP "\fB-pt\fP \fIstyle\fP" |
| 190 |
Compile \fIXIM\fP: input style for input method; |
| 191 |
\fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; |
| 192 |
resource \fBpreeditType\fP\&. |
| 193 |
.IP "\fB-im\fP \fItext\fP" |
| 194 |
Compile \fIXIM\fP: input method name\&. |
| 195 |
resource \fBinputMethod\fP\&. |
| 196 |
.IP "\fB-imlocale\fP \fIstring\fP" |
| 197 |
The locale to use for opening the IM\&. You can use an LC_CTYPE |
| 198 |
of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
| 199 |
for the input extension to be able to input japanese characters |
| 200 |
while staying in another locale\&. |
| 201 |
.IP "\fB-insecure\fP" |
| 202 |
Enable "insecure" mode, which currently enables most of the escape |
| 203 |
sequences that echo strings\&. See the resource \fBinsecure\fP for |
| 204 |
more info\&. |
| 205 |
.IP "\fB-mod\fP \fImodifier\fP" |
| 206 |
Override detection of Meta modifier with specified key: |
| 207 |
\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
| 208 |
\fBmod4\fP, \fBmod5\fP; |
| 209 |
resource \fImodifier\fP\&. |
| 210 |
.IP "\fB-ssc\fP|\fB+ssc\fP" |
| 211 |
Turn on/off secondary screen (default enabled); |
| 212 |
resource \fBsecondaryScreen\fP\&. |
| 213 |
.IP "\fB-ssr\fP|\fB+ssr\fP" |
| 214 |
Turn on/off secondary screen scroll (default enabled); |
| 215 |
resource \fBsecondaryScroll\fP\&. |
| 216 |
.IP "\fB-xrm\fP \fIresourcestring\fP" |
| 217 |
No effect on rxvt\&. Simply passes through an argument to be made |
| 218 |
available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
| 219 |
in some window managers\&. |
| 220 |
.SH "RESOURCES (available also as long-options)" |
| 221 |
.PP |
| 222 |
Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
| 223 |
into your version\&. |
| 224 |
.PP |
| 225 |
There are two different methods that rxvt can use to get the |
| 226 |
Xresource data: using the X libraries (Xrm*-functions) or internal Xresources |
| 227 |
reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists |
| 228 |
\fBXGetDefaults\fP), you can set and change the resources using X11 |
| 229 |
tools like \fBxset\fP\&. Many distribution do also load settings from the |
| 230 |
\fB~/\&.Xresources\fP file when X starts\&. |
| 231 |
.PP |
| 232 |
If compiled with internal Xresources support (i\&.e\&. \fBrxvt |
| 233 |
-h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application |
| 234 |
defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually |
| 235 |
\fB/usr/lib/X11/app-defaults/URxvt\fP) and resources set in |
| 236 |
\fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. |
| 237 |
Note that when reading X resources, \fBrxvt\fP recognizes two class |
| 238 |
names: \fBXTerm\fP and \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources |
| 239 |
common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured, |
| 240 |
while the class name \fBURxvt\fP allows resources unique to \fBrxvt\fP, |
| 241 |
notably colours and key-handling, to be shared between different |
| 242 |
\fBrxvt\fP configurations\&. If no resources are specified, suitable |
| 243 |
defaults will be used\&. Command-line arguments can be used to override |
| 244 |
resource settings\&. The following resources are allowed: |
| 245 |
.PP |
| 246 |
.IP "\fBgeometry:\fP \fIgeom\fP" |
| 247 |
Create the window with the specified X window geometry [default |
| 248 |
80x24]; |
| 249 |
option \fB-geometry\fP\&. |
| 250 |
.IP "\fBbackground:\fP \fIcolour\fP" |
| 251 |
Use the specified colour as the window\&'s background colour [default |
| 252 |
White]; |
| 253 |
option \fB-bg\fP\&. |
| 254 |
.IP "\fBforeground:\fP \fIcolour\fP" |
| 255 |
Use the specified colour as the window\&'s foreground colour [default |
| 256 |
Black]; |
| 257 |
option \fB-fg\fP\&. |
| 258 |
.IP "\fBcolor\fP\fIn\fP\fB:\fP \fIcolour\fP" |
| 259 |
Use the specified colour for the colour value \fIn\fP, where 0-7 |
| 260 |
corresponds to low-intensity (normal) colours and 8-15 corresponds to |
| 261 |
high-intensity (bold = bright foreground, blink = bright |
| 262 |
background) colours\&. The canonical names are as follows: |
| 263 |
0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, |
| 264 |
but the actual colour names used are listed in the |
| 265 |
\fBCOLORS AND GRAPHICS\fP section\&. |
| 266 |
.IP "\fBcolorBD:\fP \fIcolour\fP" |
| 267 |
Use the specified colour to display bold characters when the |
| 268 |
foreground colour is the default\&. |
| 269 |
This option will be ignored if \fBrealBold\fP is enabled\&. |
| 270 |
.IP "\fBcolorUL:\fP \fIcolour\fP" |
| 271 |
Use the specified colour to display underlined characters when the |
| 272 |
foreground colour is the default\&. |
| 273 |
.IP "\fBcolorRV:\fP \fIcolour\fP" |
| 274 |
Use the specified colour as the background for reverse video |
| 275 |
characters\&. |
| 276 |
.IP "\fBcursorColor:\fP \fIcolour\fP" |
| 277 |
Use the specified colour for the cursor\&. The default is to use the |
| 278 |
foreground colour; |
| 279 |
option \fB-cr\fP\&. |
| 280 |
.IP "\fBcursorColor2:\fP \fIcolour\fP" |
| 281 |
Use the specified colour for the colour of the cursor text\&. For this |
| 282 |
to take effect, \fBcursorColor\fP must also be specified\&. The default |
| 283 |
is to use the background colour\&. |
| 284 |
.IP "\fBreverseVideo:\fP \fIboolean\fP" |
| 285 |
\fBTrue\fP: simulate reverse video by foreground and background colours; |
| 286 |
option \fB-rv\fP\&. |
| 287 |
\fBFalse\fP: regular screen colours [default]; |
| 288 |
option \fB+rv\fP\&. |
| 289 |
See note in \fBCOLORS AND GRAPHICS\fP section\&. |
| 290 |
.IP "\fBjumpScroll:\fP \fIboolean\fP" |
| 291 |
\fBTrue\fP: specify that jump scrolling should be used\&. When scrolling |
| 292 |
quickly, fewer screen updates are performed [default]; |
| 293 |
option \fB-j\fP\&. |
| 294 |
\fBFalse\fP: specify that smooth scrolling should be used; |
| 295 |
option \fB+j\fP\&. |
| 296 |
.IP "\fBinheritPixmap:\fP \fIboolean\fP" |
| 297 |
\fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
| 298 |
giving artificial transparency\&. |
| 299 |
\fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
| 300 |
.IP "\fBfading:\fP \fInumber\fP" |
| 301 |
Fade the text by the given percentage when focus is lost\&. |
| 302 |
.IP "\fBtintColor:\fP \fIcolour\fP" |
| 303 |
Tint the transparent background pixmap with the given colour\&. |
| 304 |
.IP "\fBshading:\fP \fInumber\fP" |
| 305 |
Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background |
| 306 |
image in addition to tinting it\&. |
| 307 |
.IP "\fBfading:\fP \fInumber\fP" |
| 308 |
Scale the tint colour by the given percentage\&. |
| 309 |
.IP "\fBscrollColor:\fP \fIcolour\fP" |
| 310 |
Use the specified colour for the scrollbar [default #B2B2B2]\&. |
| 311 |
.IP "\fBtroughColor:\fP \fIcolour\fP" |
| 312 |
Use the specified colour for the scrollbar\&'s trough area [default |
| 313 |
#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
| 314 |
.IP "\fBbackgroundPixmap:\fP \fIfile[;geom]\fP" |
| 315 |
Use the specified XPM file (note the `\&.xpm\&' extension is optional) |
| 316 |
for the background and also optionally specify its scaling with a |
| 317 |
geometry string \fBWxH+X+Y\fP, in which \fB"W" / "H"\fP specify the |
| 318 |
horizontal/vertical scale (percent) and \fB"X" / "Y"\fP locate the |
| 319 |
image centre (percent)\&. A scale of 0 displays the image with tiling\&. |
| 320 |
A scale of 1 displays the image without any scaling\&. A scale of 2 to |
| 321 |
9 specifies an integer number of images in that direction\&. No image |
| 322 |
will be magnified beyond 10 times its original size\&. The maximum |
| 323 |
permitted scale is 1000\&. [default 0x0+50+50] |
| 324 |
.IP "\fBmenu:\fP \fIfile[;tag]\fP" |
| 325 |
Read in the specified menu file (note the `\&.menu\&' extension is |
| 326 |
optional) and also optionally specify a starting tag to find\&. See |
| 327 |
the reference documentation for details on the syntax for the menuBar\&. |
| 328 |
.IP "\fBpath:\fP \fIpath\fP" |
| 329 |
Specify the colon-delimited search path for finding files (XPM and |
| 330 |
menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
| 331 |
\fBPATH\fP environment variables\&. |
| 332 |
.IP "\fBfont:\fP \fIfontname\fP" |
| 333 |
Select the fonts to be used\&. |
| 334 |
This is a comma seperated list of font names that are used in turn when |
| 335 |
trying to display Unicode characters\&. |
| 336 |
The first font defines the cell size for characters; other fonts might |
| 337 |
be smaller, but not larger\&. |
| 338 |
A reasonable default font list is always appended to it\&. |
| 339 |
option \fB-fn\fP\&. |
| 340 |
.IP "\fBrealBold:\fP \fIboolean\fP" |
| 341 |
\fBTrue\fP: Enable "real bold" support\&. |
| 342 |
When this option is on, bold text will be displayed using the first |
| 343 |
available bold font in the font list\&. |
| 344 |
Bold fonts should thus be specified in the font list after their |
| 345 |
corresponding regular fonts\&. |
| 346 |
If no bold font can be found, a regular font will be used\&. |
| 347 |
option \fB-rb\fP\&. |
| 348 |
\fBFalse\fP: Display bold text in a regular font, using the color |
| 349 |
specified with \fBcolorBD\fP; |
| 350 |
option \fB+rb\fP\&. |
| 351 |
.IP "\fBselectstyle:\fP \fImode\fP" |
| 352 |
Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
| 353 |
is xterm style with 2\&.20 old word selection, or anything else which |
| 354 |
gives xterm style selection\&. |
| 355 |
.IP "\fBscrollstyle:\fP \fImode\fP" |
| 356 |
Set scrollbar style to \fBrxvt\fP, \fBrxvt\fP, \fBplain\fP, \fBnext\fP or \fBxterm\fP |
| 357 |
.IP "\fBtitle:\fP \fIstring\fP" |
| 358 |
Set window title string, the default title is the command-line |
| 359 |
specified after the \fB-e\fP option, if any, otherwise the application |
| 360 |
name; |
| 361 |
option \fB-title\fP\&. |
| 362 |
.IP "\fBiconName:\fP \fIstring\fP" |
| 363 |
Set the name used to label the window\&'s icon or displayed in an icon |
| 364 |
manager window, it also sets the window\&'s title unless it is |
| 365 |
explicitly set; |
| 366 |
option \fB-n\fP\&. |
| 367 |
.IP "\fBmapAlert:\fP \fIboolean\fP" |
| 368 |
\fBTrue\fP: de-iconify (map) on receipt of a bell character\&. |
| 369 |
\fBFalse\fP: no de-iconify (map) on receipt of a bell character |
| 370 |
[default]\&. |
| 371 |
.IP "\fBvisualBell:\fP \fIboolean\fP" |
| 372 |
\fBTrue\fP: use visual bell on receipt of a bell character; |
| 373 |
option \fB-vb\fP\&. |
| 374 |
\fBFalse\fP: no visual bell [default]; |
| 375 |
option \fB+vb\fP\&. |
| 376 |
.IP "\fBloginShell:\fP \fIboolean\fP" |
| 377 |
\fBTrue\fP: start as a login shell by prepending a `-\&' to \fBargv[0]\fP |
| 378 |
of the shell; |
| 379 |
option \fB-ls\fP\&. |
| 380 |
\fBFalse\fP: start as a normal sub-shell [default]; |
| 381 |
option \fB+ls\fP\&. |
| 382 |
.IP "\fButmpInhibit:\fP \fIboolean\fP" |
| 383 |
\fBTrue\fP: inhibit writing record into the system log file \fButmp\fP; |
| 384 |
option \fB-ut\fP\&. |
| 385 |
\fBFalse\fP: write record into the system log file \fButmp\fP [default]; |
| 386 |
option \fB+ut\fP\&. |
| 387 |
.IP "\fBprint-pipe:\fP \fIstring\fP" |
| 388 |
Specify a command pipe for vt100 printer [default \fIlpr(1)\fP]\&. Use |
| 389 |
\fBPrint\fP to initiate a screen dump to the printer and \fBCtrl-Print\fP |
| 390 |
or \fBShift-Print\fP to include the scrollback as well\&. |
| 391 |
.IP "\fBscrollBar:\fP \fIboolean\fP" |
| 392 |
\fBTrue\fP: enable the scrollbar [default]; |
| 393 |
option \fB-sb\fP\&. |
| 394 |
\fBFalse\fP: disable the scrollbar; |
| 395 |
option \fB+sb\fP\&. |
| 396 |
.IP "\fBscrollBar_right:\fP \fIboolean\fP" |
| 397 |
\fBTrue\fP: place the scrollbar on the right of the window; |
| 398 |
option \fB-sr\fP\&. |
| 399 |
\fBFalse\fP: place the scrollbar on the left of the window; |
| 400 |
option \fB+sr\fP\&. |
| 401 |
.IP "\fBscrollBar_floating:\fP \fIboolean\fP" |
| 402 |
\fBTrue\fP: display an rxvt scrollbar without a trough; |
| 403 |
option \fB-st\fP\&. |
| 404 |
\fBFalse\fP: display an rxvt scrollbar with a trough; |
| 405 |
option \fB+st\fP\&. |
| 406 |
.IP "\fBscrollBar_align:\fP \fImode\fP" |
| 407 |
Align the \fBtop\fP, \fBbottom\fP or \fBcentre\fP [default] of |
| 408 |
the scrollbar thumb with the pointer on middle button |
| 409 |
press/drag\&. |
| 410 |
.IP "\fBscrollTtyOutput:\fP \fIboolean\fP" |
| 411 |
\fBTrue\fP: scroll to bottom when tty receives output; |
| 412 |
option(+si)\&. |
| 413 |
\fBFalse\fP: do not scroll to bottom when tty receives output; |
| 414 |
option(-si)\&. |
| 415 |
.IP "\fBscrollWithBuffer:\fP \fIboolean\fP" |
| 416 |
\fBTrue\fP: scroll with scrollback buffer when tty recieves |
| 417 |
new lines (and \fBscrollTtyOutput\fP is False); |
| 418 |
option(+sw)\&. |
| 419 |
\fBFalse\fP: do not scroll with scrollback buffer when tty |
| 420 |
recieves new lines; |
| 421 |
option(-sw)\&. |
| 422 |
.IP "\fBscrollTtyKeypress:\fP \fIboolean\fP" |
| 423 |
\fBTrue\fP: scroll to bottom when a non-special key is pressed\&. |
| 424 |
Special keys are those which are intercepted by rxvt for special |
| 425 |
handling and are not passed onto the shell; |
| 426 |
option(-sk)\&. |
| 427 |
\fBFalse\fP: do not scroll to bottom when a non-special key is pressed; |
| 428 |
option(+sk)\&. |
| 429 |
.IP "\fBsmallfont_key:\fP \fIkeysym\fP" |
| 430 |
If enabled, use \fBAlt-\fP\fIkeysym\fP to toggle to a smaller font |
| 431 |
[default \fBAlt-<\fP] |
| 432 |
.IP "\fBbigfont_key:\fP \fIkeysym\fP" |
| 433 |
If enabled, use \fBAlt-\fP\fIkeysym\fP to toggle to a bigger font |
| 434 |
[default \fBAlt->\fP] |
| 435 |
.IP "\fBsaveLines:\fP \fInumber\fP" |
| 436 |
Save \fInumber\fP lines in the scrollback buffer [default 64]\&. This |
| 437 |
resource is limited on most machines to 65535; |
| 438 |
option \fB-sl\fP\&. |
| 439 |
.IP "\fBinternalBorder:\fP \fInumber\fP" |
| 440 |
Internal border of \fInumber\fP pixels\&. This resource is limited to 100; |
| 441 |
option \fB-b\fP\&. |
| 442 |
.IP "\fBexternalBorder:\fP \fInumber\fP" |
| 443 |
External border of \fInumber\fP pixels\&. This resource is limited to 100; |
| 444 |
option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&. |
| 445 |
.IP "\fBborderLess:\fP \fIboolean\fP" |
| 446 |
Set MWM hints to request a borderless window, |
| 447 |
i\&.e\&. if honoured by the WM, the rxvt window will not have window |
| 448 |
decorations; option \fB-bl\fP\&. |
| 449 |
.IP "\fBtermName:\fP \fItermname\fP" |
| 450 |
Specifies the terminal type name to be set in the \fBTERM\fP |
| 451 |
environment variable; |
| 452 |
option \fB-tn\fP\&. |
| 453 |
.IP "\fBlinespace:\fP \fInumber\fP" |
| 454 |
Specifies number of lines (pixel height) to insert between each row |
| 455 |
of the display [default 0]; |
| 456 |
option \fB-lsp\fP\&. |
| 457 |
.IP "\fBmeta8:\fP \fIboolean\fP" |
| 458 |
\fBTrue\fP: handle Meta (Alt) + keypress to set the 8th bit\&. |
| 459 |
\fBFalse\fP: handle Meta (Alt) + keypress as an escape prefix [default]\&. |
| 460 |
.IP "\fBmouseWheelScrollPage:\fP \fIboolean\fP" |
| 461 |
\fBTrue\fP: the mouse wheel scrolls a page full\&. |
| 462 |
\fBFalse\fP: the mouse wheel scrolls five lines [default]\&. |
| 463 |
.IP "\fBcursorBlink:\fP \fIboolean\fP" |
| 464 |
\fBTrue\fP: blink the cursor\&. |
| 465 |
\fBFalse\fP: do not blink the cursor [default]; |
| 466 |
option \fB-bc\fP\&. |
| 467 |
.IP "\fBpointerBlank:\fP \fIboolean\fP" |
| 468 |
\fBTrue\fP: blank the pointer when a key is pressed or after a set number |
| 469 |
of seconds of inactivity\&. |
| 470 |
\fBFalse\fP: the pointer is always visible [default]\&. |
| 471 |
.IP "\fBpointerColor:\fP \fIcolour\fP" |
| 472 |
Mouse pointer foreground colour\&. |
| 473 |
.IP "\fBpointerColor2:\fP \fIcolour\fP" |
| 474 |
Mouse pointer background colour\&. |
| 475 |
.IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
| 476 |
Specifies number of seconds before blanking the pointer [default 2]\&. |
| 477 |
.IP "\fBbackspacekey:\fP \fIstring\fP" |
| 478 |
The string to send when the backspace key is pressed\&. If set to |
| 479 |
\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
| 480 |
\fBBackspace\fP (code 8) - which can be reversed with the appropriate |
| 481 |
DEC private mode escape sequence\&. |
| 482 |
.IP "\fBdeletekey:\fP \fIstring\fP" |
| 483 |
The string to send when the delete key (not the keypad delete key) is |
| 484 |
pressed\&. If unset it will send the sequence traditionally associated |
| 485 |
with the \fBExecute\fP key\&. |
| 486 |
.IP "\fBcutchars:\fP \fIstring\fP" |
| 487 |
The characters used as delimiters for double-click word selection\&. |
| 488 |
The built-in default: |
| 489 |
.br |
| 490 |
\fBBACKSLASH `"\&'&()*,;<=>?@[]{|}\fP |
| 491 |
.IP "\fBpreeditType:\fP \fIstyle\fP" |
| 492 |
\fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; |
| 493 |
option \fB-pt\fP\&. |
| 494 |
.IP "\fBinputMethod:\fP \fIname\fP" |
| 495 |
\fIname\fP of inputMethod to use; |
| 496 |
option \fB-im\fP\&. |
| 497 |
.IP "\fBimLocale:\fP \fIname\fP" |
| 498 |
The locale to use for opening the IM\&. You can use an LC_CTYPE |
| 499 |
of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
| 500 |
for the input extension to be able to input japanese characters |
| 501 |
while staying in another locale\&. |
| 502 |
option \fB-imlocale\fP\&. |
| 503 |
.IP "\fBinsecure\fP" |
| 504 |
Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences |
| 505 |
that echo arbitrary strings like the icon name or the locale\&. This |
| 506 |
could be abused if somebody gets 8-bit-clean access to your |
| 507 |
display, wether throuh a mail client displaying mail bodies |
| 508 |
unfiltered or though write(1)\&. Therefore, these sequences are |
| 509 |
disabled by default\&. (Note that other terminals, including xterm, |
| 510 |
have these sequences enabled by default)\&. You can enable them |
| 511 |
by setting this boolean resource or specifying \fB-insecure\fP as |
| 512 |
an option\&. At the moment, this enabled display-answer, locale, |
| 513 |
findfont, icon label and window title requests as well as dynamic |
| 514 |
menubar dispatch\&. |
| 515 |
.IP "\fBmodifier:\fP \fImodifier\fP" |
| 516 |
Set the key to be interpreted as the Meta key to: |
| 517 |
\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
| 518 |
\fBmod4\fP, \fBmod5\fP; |
| 519 |
option \fB-mod\fP\&. |
| 520 |
.IP "\fBanswerbackString:\fP \fIstring\fP" |
| 521 |
Specify the reply rxvt sends to the shell when an ENQ (control-E) |
| 522 |
character is passed through\&. It may contain escape values as |
| 523 |
described in the entry on \fBkeysym\fP following\&. |
| 524 |
.IP "\fBsecondaryScreen:\fP \fIbool\fP" |
| 525 |
Turn on/off secondary screen (default enabled)\&. |
| 526 |
.IP "\fBsecondaryScroll:\fP \fIbool\fP" |
| 527 |
Turn on/off secondary screen scroll (default enabled)\&. If |
| 528 |
the this option is enabled, scrolls on the secondary screen will |
| 529 |
change the scrollback buffer and switching to/from the secondary screen |
| 530 |
will instead scroll the screen up\&. |
| 531 |
.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
| 532 |
Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
| 533 |
may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
| 534 |
\en: newline, \er: return, \et: tab, \e000: octal number) or control |
| 535 |
characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
| 536 |
double quotes so that it can start or end with whitespace\&. The |
| 537 |
intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This |
| 538 |
resource is only available when compiled with KEYSYM_RESOURCE\&. |
| 539 |
.SH "THE SCROLLBAR" |
| 540 |
.PP |
| 541 |
Lines of text that scroll off the top of the \fBrxvt\fP window (resource: |
| 542 |
\fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. |
| 543 |
The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly |
| 544 |
intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour |
| 545 |
mimics that of \fIxterm\fP |
| 546 |
.PP |
| 547 |
Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. |
| 548 |
Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. |
| 549 |
Continuous scroll with \fBButton2\fP\&. |
| 550 |
.SH "MOUSE REPORTING" |
| 551 |
.PP |
| 552 |
To temporarily override mouse reporting, for either the scrollbar or the |
| 553 |
normal text selection/insertion, hold either the Shift or the Meta (Alt) key |
| 554 |
while performing the desired mouse action\&. |
| 555 |
.PP |
| 556 |
If mouse reporting mode is active, the normal scrollbar actions are disabled |
| 557 |
-- on the assumption that we are using a fullscreen application\&. |
| 558 |
Instead, pressing Button1 and Button3 sends |
| 559 |
\fBESC[6~\fP (Next) and \fBESC[5~\fP (Prior), respectively\&. |
| 560 |
Similarly, clicking on the up and down arrows sends \fBESC[A\fP (Up) and |
| 561 |
\fBESC[B\fP (Down), respectively\&. |
| 562 |
.SH "TEXT SELECTION AND INSERTION" |
| 563 |
.PP |
| 564 |
The behaviour of text selection and insertion mechanism is similar to |
| 565 |
\fIxterm\fP(1)\&. |
| 566 |
.PP |
| 567 |
.IP "\fBSelection\fP:" |
| 568 |
Left click at the beginning of the region, drag to the end of the |
| 569 |
region and release; Right click to extend the marked region; |
| 570 |
Left double-click to select a word; Left triple-click to select |
| 571 |
the entire line\&. |
| 572 |
.IP "\fBInsertion\fP:" |
| 573 |
Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) |
| 574 |
in an \fBrxvt\fP window causes the current text selection to be inserted |
| 575 |
as if it had been typed on the keyboard\&. |
| 576 |
.SH "CHANGING FONTS" |
| 577 |
.PP |
| 578 |
You can change fonts on-the-fly, which is to say cycle through the default |
| 579 |
font and others of various sizes, by using \fBShift-KP_Add\fP and |
| 580 |
\fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with |
| 581 |
\fBAlt->\fP and \fBAlt-<\fP, where the actual key |
| 582 |
can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. |
| 583 |
.SH "LOGIN STAMP" |
| 584 |
.PP |
| 585 |
\fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
| 586 |
seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
| 587 |
feature, \fBrxvt\fP must be installed setuid root on some systems\&. |
| 588 |
.SH "COLORS AND GRAPHICS" |
| 589 |
.PP |
| 590 |
In addition to the default foreground and background colours, \fBrxvt\fP |
| 591 |
can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
| 592 |
versions of the same)\&. |
| 593 |
Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
| 594 |
.PP |
| 595 |
.TS |
| 596 |
tab(`); |
| 597 |
l l l . |
| 598 |
\fBcolor0\fP `\ (black) `\ = Black |
| 599 |
\fBcolor1\fP `\ (red) `\ = Red3 |
| 600 |
\fBcolor2\fP `\ (green) `\ = Green3 |
| 601 |
\fBcolor3\fP `\ (yellow) `\ = Yellow3 |
| 602 |
\fBcolor4\fP `\ (blue) `\ = Blue3 |
| 603 |
\fBcolor5\fP `\ (magenta) `\ = Magenta3 |
| 604 |
\fBcolor6\fP `\ (cyan) `\ = Cyan3 |
| 605 |
\fBcolor7\fP `\ (white) `\ = AntiqueWhite |
| 606 |
\fBcolor8\fP `\ (bright black) `\ = Grey25 |
| 607 |
\fBcolor9\fP `\ (bright red) `\ = Red |
| 608 |
\fBcolor10\fP `\ (bright green) `\ = Green |
| 609 |
\fBcolor11\fP `\ (bright yellow) `\ = Yellow |
| 610 |
\fBcolor12\fP `\ (bright blue) `\ = Blue |
| 611 |
\fBcolor13\fP `\ (bright magenta) `\ = Magenta |
| 612 |
\fBcolor14\fP `\ (bright cyan) `\ = Cyan |
| 613 |
\fBcolor15\fP `\ (bright white) `\ = White |
| 614 |
\fBforeground\fP `\ `\ = Black |
| 615 |
\fBbackground\fP `\ `\ = White |
| 616 |
.TE |
| 617 |
.PP |
| 618 |
It is also possible to specify the colour values of \fBforeground\fP, |
| 619 |
\fBbackground\fP, \fBcursorColor\fP, \fBcursorColor2\fP, \fBcolorBD\fP, \fBcolorUL\fP |
| 620 |
as a number 0-15, as a convenient shorthand to reference the colour name of |
| 621 |
color0-color15\&. |
| 622 |
.PP |
| 623 |
Note that \fB-rv\fP (\fB"reverseVideo: True"\fP) simulates reverse video by |
| 624 |
always swapping the foreground/background colours\&. This is in contrast to |
| 625 |
\fIxterm\fP(1) where the colours are only swapped if they have not otherwise been |
| 626 |
specified\&. |
| 627 |
For example, |
| 628 |
.PP |
| 629 |
.IP "\fBrxvt -fg Black -bg White -rv\fP" |
| 630 |
would yield White on Black, while on \fIxterm\fP(1) it would yield |
| 631 |
Black on White\&. |
| 632 |
.SH "ENVIRONMENT" |
| 633 |
.PP |
| 634 |
\fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and |
| 635 |
\fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window |
| 636 |
id number of the \fBrxvt\fP window and it also uses and sets the environment |
| 637 |
variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses |
| 638 |
the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. |
| 639 |
.SH "FILES" |
| 640 |
.PP |
| 641 |
.IP "\fB/etc/utmp\fP" |
| 642 |
System file for login records\&. |
| 643 |
.IP "\fB/usr/lib/X11/rgb\&.txt\fP" |
| 644 |
Color names\&. |
| 645 |
.PP |
| 646 |
.SH "SEE ALSO" |
| 647 |
.PP |
| 648 |
\fIxterm\fP(1), \fIsh\fP(1), \fIresize\fP(1), \fIX\fP(1), \fIpty\fP(4), \fItty\fP(4), |
| 649 |
\fIutmp\fP(5) |
| 650 |
.PP |
| 651 |
See rxvtRef\&.html rxvtRef\&.txt for detailed information on recognized escape |
| 652 |
sequences and menuBar syntax, etc\&. |
| 653 |
.PP |
| 654 |
.SH "BUGS" |
| 655 |
.PP |
| 656 |
Check the BUGS file for an up-to-date list\&. |
| 657 |
.PP |
| 658 |
Cursor change support is not yet implemented\&. |
| 659 |
.PP |
| 660 |
Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
| 661 |
.PP |
| 662 |
.SH "FTP LOCATION" |
| 663 |
.PP |
| 664 |
rxvt-3\&.5\&.tar\&.gz can be found at the following ftp sites |
| 665 |
ftp://ftp\&.rxvt\&.org/pub/rxvt |
| 666 |
.PP |
| 667 |
.SH "CURRENT PROJECT COORDINATOR" |
| 668 |
.PP |
| 669 |
.IP "Project Coordinator" |
| 670 |
Marc A\&. Lehmann <rxvt@schmorp\&.de> |
| 671 |
.br |
| 672 |
.IP "Web page maintainter" |
| 673 |
Marc A\&. Lehmann <rxvt@schmorp\&.de> |
| 674 |
.br |
| 675 |
<http://www\&.sourceforge\&.net/projects/rxvt-unicode/> |
| 676 |
.br |
| 677 |
.PP |
| 678 |
.SH "AUTHORS" |
| 679 |
.PP |
| 680 |
.IP "John Bovey" |
| 681 |
University of Kent, 1992, wrote the original Xvt\&. |
| 682 |
.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" |
| 683 |
very heavily modified Xvt and came up with Rxvt |
| 684 |
.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" |
| 685 |
wrote the Greek Keyboard Input (no longer in code) |
| 686 |
.IP "mj olesen <olesen@me\&.QueensU\&.CA>" |
| 687 |
Wrote the menu system\&. |
| 688 |
.br |
| 689 |
Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) |
| 690 |
.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
| 691 |
Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
| 692 |
.IP "Geoff Wing <gcw@pobox\&.com>" |
| 693 |
Rewrote screen display and text selection routines\&. |
| 694 |
Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) |
| 695 |
.IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>" |
| 696 |
Forked rxvt-unicode, rewrote most of the display code and |
| 697 |
internal character handling to store text in unicode, |
| 698 |
improve xterm compatibility and apply numerous other bugfixes |
| 699 |
and extensions\&. |
| 700 |
.br |
| 701 |
Project Coordinator (Changes 1\&.0 - ) |
| 702 |
.PP |
