ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.tbl
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.tbl (file contents):
Revision 1.3 by pcg, Sun Feb 22 10:37:54 2004 UTC vs.
Revision 1.13 by root, Mon Jul 26 14:57:11 2004 UTC

1.TH "RXVT" "1" "RXVTDATE()" "X Version 11" "X Tools" 1.TH "RXVT" "1" "2004-06-26" "X Version 11" "X Tools"
2.SH "NAME" 2.SH "NAME"
3rxvt (ouR XVT) \- a VT102 emulator for the X window system 3rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system
4.PP 4.PP
5.SH "SYNOPSIS" 5.SH "SYNOPSIS"
6.PP 6.PP
7\fBrxvt\fP [options] [-e command [ args ]] 7\fBurxvt\fP [options] [-e command [ args ]]
8.PP 8.PP
9.SH "DESCRIPTION" 9.SH "DESCRIPTION"
10.PP 10.PP
11\fBrxvt\fP, version \fBRXVTVERSION()\fP, is a colour vt102 terminal emulator 11\fBrxvt-unicode\fP, version \fB3\&.1\fP, is a colour vt102 terminal emulator
12intended as an \fIxterm\fP(1) replacement for users who do not require 12intended as an \fIxterm\fP(1) replacement for users who do not require
13features such as Tektronix 4014 emulation and toolkit-style configurability\&. 13features such as Tektronix 4014 emulation and toolkit-style configurability\&.
14As a result, \fBrxvt\fP uses much less swap space -- a significant 14As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant
15advantage on a machine serving many X sessions\&. 15advantage on a machine serving many X sessions\&.
16.PP 16.PP
17.PP 17.PP
18.SH "OPTIONS" 18.SH "OPTIONS"
19.PP 19.PP
20The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. 20The \fBurxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&.
21In keeping with the smaller-is-better philosophy, options may be eliminated 21In keeping with the smaller-is-better philosophy, options may be eliminated
22or default values chosen at compile-time, so options and defaults listed 22or default values chosen at compile-time, so options and defaults listed
23may not accurately reflect the version installed on your system\&. 23may 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\&. 24`rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&.
25Option descriptions may be prefixed with which compile option each is 25Option descriptions may be prefixed with which compile option each is
26dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP 26dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP
27line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled 27line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled
28into your version\&. 28into your version\&.
29.PP 29.PP
30Note that \fBrxvt\fP permits the resource name to be used as a long-option 30Note that \fBurxvt\fP permits the resource name to be used as a long-option
31(--/++ option) so the potential command-line options are far greater than 31(--/++ option) so the potential command-line options are far greater than
32those listed\&. 32those listed\&.
33For example: `rxvt --loginShell --color1 Orange\&'\&. 33For example: `rxvt --loginShell --color1 Orange\&'\&.
34.PP 34.PP
35The following options are available: 35The following options are available:
… …
51resource \fBjumpScroll\fP\&. 51resource \fBjumpScroll\fP\&.
52.IP "\fB-ip\fP|\fB+ip\fP" 52.IP "\fB-ip\fP|\fB+ip\fP"
53Turn on/off inheriting parent window\&'s pixmap\&. Alternative form 53Turn on/off inheriting parent window\&'s pixmap\&. Alternative form
54is \fB-tr\fP; 54is \fB-tr\fP;
55resource \fBinheritPixmap\fP\&. 55resource \fBinheritPixmap\fP\&.
56.IP "\fB-tint\fP \fIcolour\fP"
57Tint the transparent background pixmap with the given colour\&.
56.IP "\fB-bg\fP \fIcolour\fP" 58.IP "\fB-bg\fP \fIcolour\fP"
57Window background colour; 59Window background colour;
58resource \fBbackground\fP\&. 60resource \fBbackground\fP\&.
59.IP "\fB-fg\fP \fIcolour\fP" 61.IP "\fB-fg\fP \fIcolour\fP"
60Window foreground colour; 62Window foreground colour;
… …
67resource \fBbackgroundPixmap\fP\&. 69resource \fBbackgroundPixmap\fP\&.
68.IP "\fB-cr\fP \fIcolour\fP" 70.IP "\fB-cr\fP \fIcolour\fP"
69The cursor colour; 71The cursor colour;
70resource \fBcursorColor\fP\&. 72resource \fBcursorColor\fP\&.
71.IP "\fB-pr\fP \fIcolour\fP" 73.IP "\fB-pr\fP \fIcolour\fP"
72The mouse pointer colour; 74The mouse pointer foreground colour;
73resource \fBpointerColor\fP\&. 75resource \fBpointerColor\fP\&.
76.IP "\fB-pr2\fP \fIcolour\fP"
77The mouse pointer background colour;
78resource \fBpointerColor2\fP\&.
74.IP "\fB-bd\fP \fIcolour\fP" 79.IP "\fB-bd\fP \fIcolour\fP"
75The colour of the border between the xterm scrollbar and the text; 80The colour of the border between the xterm scrollbar and the text;
76resource \fBborderColor\fP\&. 81resource \fBborderColor\fP\&.
77.IP "\fB-fn\fP \fIfontname\fP" 82.IP "\fB-fn\fP \fIfontname\fP"
78Select the fonts to be used used\&. This is a comma seperated 83Select the fonts to be used\&.
79list of font names that are used in turn when trying to display 84This is a comma seperated list of font names that are used in turn when
80unicode characters\&. The first font defines the cell size for characters, 85trying to display Unicode characters\&.
81pther fonts might be smaller, but not larger\&. A reasonable default list 86The first font defines the cell size for characters; other fonts might
82is appended\&. 87be smaller, but not larger\&.
88A reasonable default font list is always appended to it\&.
83resource \fBfont\fP\&. 89resource \fBfont\fP\&.
90.IP "\fB-rb\fP|\fB+rb\fP"
91Enable "real bold" support\&.
92When this option is on, bold text will be displayed using the first
93available bold font in the font list\&.
94Bold fonts should thus be specified in the font list after their
95corresponding regular fonts\&.
96If no bold font can be found, a regular font will be used\&.
97resource \fBrealBold\fP\&.
84.IP "\fB-name\fP \fIname\fP" 98.IP "\fB-name\fP \fIname\fP"
85Specify the application name under which resources 99Specify the application name under which resources
86are to be obtained, rather than the default executable file name\&. 100are to be obtained, rather than the default executable file name\&.
87Name should not contain `\&.\&' or `*\&' characters\&. 101Name should not contain `\&.\&' or `*\&' characters\&.
88Also sets the icon and title name\&. 102Also sets the icon and title name\&.
… …
112Put scrollbar on right/left; 126Put scrollbar on right/left;
113resource \fBscrollBar_right\fP\&. 127resource \fBscrollBar_right\fP\&.
114.IP "\fB-st\fP|\fB+st\fP" 128.IP "\fB-st\fP|\fB+st\fP"
115Display normal (non XTerm/NeXT) scrollbar without/with a trough; 129Display normal (non XTerm/NeXT) scrollbar without/with a trough;
116resource \fBscrollBar_floating\fP\&. 130resource \fBscrollBar_floating\fP\&.
117.IP "\fB-mcc\fP|\fB+mcc\fP"
118Compile \fImultichar_languages\fP: treat multibyte glyphs as single
119character for backspace, delete and cursor movement keys;
120resource \fBmultibyte_cursor\fP\&.
121.IP "\fB-bc\fP|\fB+bc\fP" 131.IP "\fB-bc\fP|\fB+bc\fP"
122Blink the cursor; resource \fBcursorBlink\fP\&. 132Blink the cursor; resource \fBcursorBlink\fP\&.
123.IP "\fB-iconic\fP" 133.IP "\fB-iconic\fP"
124Start iconified, if the window manager supports that option\&. 134Start iconified, if the window manager supports that option\&.
125Alternative form is \fB-ic\fP\&. 135Alternative form is \fB-ic\fP\&.
… …
143This option specifies the name of the terminal type to be set in the 153This option specifies the name of the terminal type to be set in the
144\fBTERM\fP environment variable\&. This terminal type must exist in the 154\fBTERM\fP environment variable\&. This terminal type must exist in the
145\fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; 155\fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries;
146resource \fBtermName\fP\&. 156resource \fBtermName\fP\&.
147.IP "\fB-e\fP \fIcommand [arguments]\fP" 157.IP "\fB-e\fP \fIcommand [arguments]\fP"
148Run the command with its command-line arguments in the \fBrxvt\fP 158Run the command with its command-line arguments in the \fBurxvt\fP
149window; also sets the window title and icon name to be the basename 159window; also sets the window title and icon name to be the basename
150of the program being executed if neither \fI-title\fP (\fI-T\fP) nor 160of the program being executed if neither \fI-title\fP (\fI-T\fP) nor
151\fI-n\fP are given on the command line\&. If this option is used, it 161\fI-n\fP are given on the command line\&. If this option is used, it
152must be the last on the command-line\&. If there is no \fB-e\fP option 162must be the last on the command-line\&. If there is no \fB-e\fP option
153then the default is to run the program specified by the \fBSHELL\fP 163then the default is to run the program specified by the \fBSHELL\fP
… …
173.IP "\fB-imlocale\fP \fIstring\fP" 183.IP "\fB-imlocale\fP \fIstring\fP"
174The locale to use for opening the IM\&. You can use an LC_CTYPE 184The locale to use for opening the IM\&. You can use an LC_CTYPE
175of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP 185of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
176for the input extension to be able to input japanese characters 186for the input extension to be able to input japanese characters
177while staying in another locale\&. 187while staying in another locale\&.
188.IP "\fB-insecure\fP"
189Enable "insecure" mode, which currently enables most of the escape
190sequences that echo strings\&. See the resource \fBinsecure\fP for
191more info\&.
178.IP "\fB-mod\fP \fImodifier\fP" 192.IP "\fB-mod\fP \fImodifier\fP"
179Override detection of Meta modifier with specified key: 193Override detection of Meta modifier with specified key:
180\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 194\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
181\fBmod4\fP, \fBmod5\fP; 195\fBmod4\fP, \fBmod5\fP;
182resource \fImodifier\fP\&. 196resource \fImodifier\fP\&.
197.IP "\fB-ssc\fP|\fB+ssc\fP"
198Turn on/off secondary screen (default enabled);
199resource \fBsecondaryScreen\fP\&.
200.IP "\fB-ssr\fP|\fB+ssr\fP"
201Turn on/off secondary screen scroll (default enabled);
202resource \fBsecondaryScroll\fP\&.
183.IP "\fB-xrm\fP \fIresourcestring\fP" 203.IP "\fB-xrm\fP \fIresourcestring\fP"
184No effect on rxvt\&. Simply passes through an argument to be made 204No effect on rxvt\&. Simply passes through an argument to be made
185available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP 205available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP
186in some window managers\&. 206in some window managers\&.
187.SH "RESOURCES (available also as long-options)" 207.SH "RESOURCES (available also as long-options)"
188.PP 208.PP
189Note: `rxvt --help\&' gives a list of all resources (long options) compiled 209Note: `rxvt --help\&' gives a list of all resources (long options) compiled
190into your version\&. 210into your version\&.
191If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists 211If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists
192\fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in 212\fB\&.Xdefaults\fP) then \fBurxvt\fP accepts application defaults set in
193XAPPLOADDIR/Rxvt (compile-time defined: usually 213XAPPLOADDIR/Rxvt (compile-time defined: usually
194\fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, 214\fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP,
195or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when 215or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when
196reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and 216reading X resources, \fBurxvt\fP recognizes two class names: \fBXTerm\fP and
197\fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both 217\fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both
198\fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name 218\fBurxvt\fP and \fIxterm\fP to be easily configured, while the class name
199\fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and 219\fBRxvt\fP allows resources unique to \fBurxvt\fP, notably colours and
200key-handling, to be shared between different \fBrxvt\fP configurations\&. 220key-handling, to be shared between different \fBurxvt\fP configurations\&.
201If no resources are specified, suitable defaults will be used\&. 221If no resources are specified, suitable defaults will be used\&.
202Command-line arguments can be used to override resource settings\&. The 222Command-line arguments can be used to override resource settings\&. The
203following resources are allowed: 223following resources are allowed:
204.PP 224.PP
205.IP "\fBgeometry:\fP \fIgeom\fP" 225.IP "\fBgeometry:\fP \fIgeom\fP"
… …
223but the actual colour names used are listed in the 243but the actual colour names used are listed in the
224\fBCOLORS AND GRAPHICS\fP section\&. 244\fBCOLORS AND GRAPHICS\fP section\&.
225.IP "\fBcolorBD:\fP \fIcolour\fP" 245.IP "\fBcolorBD:\fP \fIcolour\fP"
226Use the specified colour to display bold characters when the 246Use the specified colour to display bold characters when the
227foreground colour is the default\&. 247foreground colour is the default\&.
248This option will be ignored if \fBrealBold\fP is enabled\&.
228.IP "\fBcolorUL:\fP \fIcolour\fP" 249.IP "\fBcolorUL:\fP \fIcolour\fP"
229Use the specified colour to display underlined characters when the 250Use the specified colour to display underlined characters when the
230foreground colour is the default\&. 251foreground colour is the default\&.
231.IP "\fBcolorRV:\fP \fIcolour\fP" 252.IP "\fBcolorRV:\fP \fIcolour\fP"
232Use the specified colour as the background for reverse video 253Use the specified colour as the background for reverse video
… …
253option \fB+j\fP\&. 274option \fB+j\fP\&.
254.IP "\fBinheritPixmap:\fP \fIboolean\fP" 275.IP "\fBinheritPixmap:\fP \fIboolean\fP"
255\fBTrue\fP: make the background inherit the parent windows\&' pixmap, 276\fBTrue\fP: make the background inherit the parent windows\&' pixmap,
256giving artificial transparency\&. 277giving artificial transparency\&.
257\fBFalse\fP: do not inherit the parent windows\&' pixmap\&. 278\fBFalse\fP: do not inherit the parent windows\&' pixmap\&.
279.IP "\fBtintColor\fP \fIcolour\fP"
280Tint the transparent background pixmap with the given colour\&.
258.IP "\fBscrollColor:\fP \fIcolour\fP" 281.IP "\fBscrollColor:\fP \fIcolour\fP"
259Use the specified colour for the scrollbar [default #B2B2B2]\&. 282Use the specified colour for the scrollbar [default #B2B2B2]\&.
260.IP "\fBtroughColor:\fP \fIcolour\fP" 283.IP "\fBtroughColor:\fP \fIcolour\fP"
261Use the specified colour for the scrollbar\&'s trough area [default 284Use the specified colour for the scrollbar\&'s trough area [default
262#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. 285#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&.
… …
277.IP "\fBpath:\fP \fIpath\fP" 300.IP "\fBpath:\fP \fIpath\fP"
278Specify the colon-delimited search path for finding files (XPM and 301Specify the colon-delimited search path for finding files (XPM and
279menus), in addition to the paths specified by the \fBRXVTPATH\fP and 302menus), in addition to the paths specified by the \fBRXVTPATH\fP and
280\fBPATH\fP environment variables\&. 303\fBPATH\fP environment variables\&.
281.IP "\fBfont:\fP \fIfontname\fP" 304.IP "\fBfont:\fP \fIfontname\fP"
282Select the fonts to be used used\&. This is a comma seperated 305Select the fonts to be used\&.
283list of font names that are used in turn when trying to display 306This is a comma seperated list of font names that are used in turn when
284unicode characters\&. The first font defines the cell size for characters, 307trying to display Unicode characters\&.
285pther fonts might be smaller, but not larger\&. A reasonable default list 308The first font defines the cell size for characters; other fonts might
286is appended\&. 309be smaller, but not larger\&.
310A reasonable default font list is always appended to it\&.
287option \fB-fn\fP\&. 311option \fB-fn\fP\&.
312.IP "\fBrealBold:\fP \fIboolean\fP"
313\fBTrue\fP: Enable "real bold" support\&.
314When this option is on, bold text will be displayed using the first
315available bold font in the font list\&.
316Bold fonts should thus be specified in the font list after their
317corresponding regular fonts\&.
318If no bold font can be found, a regular font will be used\&.
319option \fB-rb\fP\&.
320\fBFalse\fP: Display bold text in a regular font, using the color
321specified with \fBcolorBD\fP;
322option \fB+rb\fP\&.
288.IP "\fBselectstyle:\fP \fImode\fP" 323.IP "\fBselectstyle:\fP \fImode\fP"
289Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which 324Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which
290is xterm style with 2\&.20 old word selection, or anything else which 325is xterm style with 2\&.20 old word selection, or anything else which
291gives xterm style selection\&. 326gives xterm style selection\&.
292.IP "\fBscrollstyle:\fP \fImode\fP" 327.IP "\fBscrollstyle:\fP \fImode\fP"
293Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP 328Set scrollbar style to \fBurxvt\fP, \fBrxvt\fP, \fBplain\fP, \fBnext\fP or \fBxterm\fP
294.IP "\fBtitle:\fP \fIstring\fP" 329.IP "\fBtitle:\fP \fIstring\fP"
295Set window title string, the default title is the command-line 330Set window title string, the default title is the command-line
296specified after the \fB-e\fP option, if any, otherwise the application 331specified after the \fB-e\fP option, if any, otherwise the application
297name; 332name;
298option \fB-title\fP\&. 333option \fB-title\fP\&.
… …
399option \fB-bc\fP\&. 434option \fB-bc\fP\&.
400.IP "\fBpointerBlank:\fP \fIboolean\fP" 435.IP "\fBpointerBlank:\fP \fIboolean\fP"
401\fBTrue\fP: blank the pointer when a key is pressed or after a set number 436\fBTrue\fP: blank the pointer when a key is pressed or after a set number
402of seconds of inactivity\&. 437of seconds of inactivity\&.
403\fBFalse\fP: the pointer is always visible [default]\&. 438\fBFalse\fP: the pointer is always visible [default]\&.
439.IP "\fBpointerColor:\fP \fIcolour\fP"
440Mouse pointer foreground colour\&.
441.IP "\fBpointerColor2:\fP \fIcolour\fP"
442Mouse pointer background colour\&.
404.IP "\fBpointerBlankDelay:\fP \fInumber\fP" 443.IP "\fBpointerBlankDelay:\fP \fInumber\fP"
405Specifies number of seconds before blanking the pointer [default 2]\&. 444Specifies number of seconds before blanking the pointer [default 2]\&.
406.IP "\fBmultibyte_cursor:\fP \fIboolean\fP"
407\fBTrue\fP: consider multibyte glyphs as single character for backspace,
408delete and cursor movement keys;
409option \fB-mcc\fP\&.
410\fBFalse\fP: move through all components of all glyphs;
411option \fB+mcc\fP\&.
412.IP "\fBbackspacekey:\fP \fIstring\fP" 445.IP "\fBbackspacekey:\fP \fIstring\fP"
413The string to send when the backspace key is pressed\&. If set to 446The string to send when the backspace key is pressed\&. If set to
414\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, 447\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted,
415\fBBackspace\fP (code 8) - which can be reversed with the appropriate 448\fBBackspace\fP (code 8) - which can be reversed with the appropriate
416DEC private mode escape sequence\&. 449DEC private mode escape sequence\&.
… …
433The locale to use for opening the IM\&. You can use an LC_CTYPE 466The locale to use for opening the IM\&. You can use an LC_CTYPE
434of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP 467of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
435for the input extension to be able to input japanese characters 468for the input extension to be able to input japanese characters
436while staying in another locale\&. 469while staying in another locale\&.
437option \fB-imlocale\fP\&. 470option \fB-imlocale\fP\&.
471.IP "\fBinsecure\fP"
472Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences
473that echo arbitrary strings like the icon name or the locale\&. This
474could be abused if somebody gets 8-bit-clean access to your
475display, wether throuh a mail client displaying mail bodies
476unfiltered or though write(1)\&. Therefore, these sequences are
477disabled by default\&. (Note that other terminals, including xterm,
478have these sequences enabled by default)\&. You can enable them
479by setting this boolean resource or specifying \fB-insecure\fP as
480an option\&. At the moment, this enabled display-answer, locale,
481findfont, icon label and window title requests as well as dynamic
482menubar dispatch\&.
438.IP "\fBmodifier:\fP \fImodifier\fP" 483.IP "\fBmodifier:\fP \fImodifier\fP"
439Set the key to be interpreted as the Meta key to: 484Set the key to be interpreted as the Meta key to:
440\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 485\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
441\fBmod4\fP, \fBmod5\fP; 486\fBmod4\fP, \fBmod5\fP;
442option \fB-mod\fP\&. 487option \fB-mod\fP\&.
443.IP "\fBanswerbackString:\fP \fIstring\fP" 488.IP "\fBanswerbackString:\fP \fIstring\fP"
444Specify the reply rxvt sends to the shell when an ENQ (control-E) 489Specify the reply rxvt sends to the shell when an ENQ (control-E)
445character is passed through\&. It may contain escape values as 490character is passed through\&. It may contain escape values as
446described in the entry on \fBkeysym\fP following\&. 491described in the entry on \fBkeysym\fP following\&.
492.IP "\fBsecondaryScreen:\fP \fIbool\fP"
493Turn on/off secondary screen (default enabled)\&.
494.IP "\fBsecondaryScroll:\fP \fIbool\fP"
495Turn on/off secondary screen scroll (default enabled)\&. If
496the this option is enabled, scrolls on the secondary screen will
497change the scrollback buffer and switching to/from the secondary screen
498will instead scroll the screen up\&.
447.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" 499.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP"
448Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It 500Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It
449may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, 501may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape,
450\en: newline, \er: return, \et: tab, \e000: octal number) or control 502\en: newline, \er: return, \et: tab, \e000: octal number) or control
451characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with 503characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with
452double quotes so that it can start or end with whitespace\&. The 504double quotes so that it can start or end with whitespace\&. The
453intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This 505intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This
454resource is only available when compiled with KEYSYM_RESOURCE\&. 506resource is only available when compiled with KEYSYM_RESOURCE\&.
455.SH "THE SCROLLBAR" 507.SH "THE SCROLLBAR"
456.PP 508.PP
457Lines of text that scroll off the top of the \fBrxvt\fP window (resource: 509Lines of text that scroll off the top of the \fBurxvt\fP window (resource:
458\fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. 510\fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&.
459The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly 511The normal \fBurxvt\fP scrollbar has arrows and its behaviour is fairly
460intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour 512intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour
461mimics that of \fIxterm\fP 513mimics that of \fIxterm\fP
462.PP 514.PP
463Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. 515Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&.
464Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. 516Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&.
… …
485region and release; Right click to extend the marked region; 537region and release; Right click to extend the marked region;
486Left double-click to select a word; Left triple-click to select 538Left double-click to select a word; Left triple-click to select
487the entire line\&. 539the entire line\&.
488.IP "\fBInsertion\fP:" 540.IP "\fBInsertion\fP:"
489Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) 541Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP)
490in an \fBrxvt\fP window causes the current text selection to be inserted 542in an \fBurxvt\fP window causes the current text selection to be inserted
491as if it had been typed on the keyboard\&. 543as if it had been typed on the keyboard\&.
492.SH "CHANGING FONTS" 544.SH "CHANGING FONTS"
493.PP 545.PP
494You can change fonts on-the-fly, which is to say cycle through the default 546You can change fonts on-the-fly, which is to say cycle through the default
495font and others of various sizes, by using \fBShift-KP_Add\fP and 547font and others of various sizes, by using \fBShift-KP_Add\fP and
496\fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with 548\fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with
497\fBAlt->\fP and \fBAlt-<\fP, where the actual key 549\fBAlt->\fP and \fBAlt-<\fP, where the actual key
498can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. 550can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&.
499.SH "LOGIN STAMP" 551.SH "LOGIN STAMP"
500.PP 552.PP
501\fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be 553\fBurxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be
502seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this 554seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this
503feature, \fBrxvt\fP must be installed setuid root on some systems\&. 555feature, \fBurxvt\fP must be installed setuid root on some systems\&.
504.SH "COLORS AND GRAPHICS" 556.SH "COLORS AND GRAPHICS"
505.PP 557.PP
506In addition to the default foreground and background colours, \fBrxvt\fP 558In addition to the default foreground and background colours, \fBurxvt\fP
507can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink 559can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
508versions of the same)\&. 560versions of the same)\&.
509Here is a list of the colours with their \fBrgb\&.txt\fP names\&. 561Here is a list of the colours with their \fBrgb\&.txt\fP names\&.
510.PP 562.PP
511.TS 563.TS
… …
545.IP "\fBrxvt -fg Black -bg White -rv\fP" 597.IP "\fBrxvt -fg Black -bg White -rv\fP"
546would yield White on Black, while on \fIxterm\fP(1) it would yield 598would yield White on Black, while on \fIxterm\fP(1) it would yield
547Black on White\&. 599Black on White\&.
548.SH "ENVIRONMENT" 600.SH "ENVIRONMENT"
549.PP 601.PP
550\fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and 602\fBurxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and
551\fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window 603\fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window
552id number of the \fBrxvt\fP window and it also uses and sets the environment 604id number of the \fBurxvt\fP window and it also uses and sets the environment
553variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses 605variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBurxvt\fP uses
554the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. 606the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&.
555.SH "FILES" 607.SH "FILES"
556.PP 608.PP
557.IP "\fB/etc/utmp\fP" 609.IP "\fB/etc/utmp\fP"
558System file for login records\&. 610System file for login records\&.
… …
573.PP 625.PP
574Cursor change support is not yet implemented\&. 626Cursor change support is not yet implemented\&.
575.PP 627.PP
576Click-and-drag doesn\&'t work with X11 mouse report overriding\&. 628Click-and-drag doesn\&'t work with X11 mouse report overriding\&.
577.PP 629.PP
578Graphics support is fairly crude\&.
579.PP
580.SH "FTP LOCATION" 630.SH "FTP LOCATION"
581.PP 631.PP
582rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites 632rxvt-3\&.1\&.tar\&.gz can be found at the following ftp sites
583RXVTFTPSITE() 633ftp://ftp\&.rxvt\&.org/pub/rxvt
584.PP 634.PP
585.SH "CURRENT PROJECT COORDINATOR" 635.SH "CURRENT PROJECT COORDINATOR"
586.PP 636.PP
587.IP "Project Coordinator" 637.IP "Project Coordinator"
588RXVTMAINT() RXVTMAINTEMAIL() 638Marc A\&. Lehmann <rxvt@schmorp\&.de>
589.br 639.br
590.IP "Web page maintainter" 640.IP "Web page maintainter"
591RXVTWEBMAINT() RXVTWEBMAINTEMAIL() 641Marc A\&. Lehmann <rxvt@schmorp\&.de>
592.br 642.br
593RXVTWEBPAGE() 643<http://www\&.sourceforge\&.net/projects/rxvt-unicode/>
594.br 644.br
595.IP "Mailing list"
596The Rxvt Workers <rxvt-workers@rxvt\&.org>
597mailing list has also been established for rxvt development, to
598subscribe, email to
599<rxvt-workers-subscribe@rxvt\&.org>\&.
600There is also a mailing list for announcements of new releases of
601rxvt\&. To subscribe, email to
602<rxvt-announce-subscribe@rxvt\&.org>\&.
603.PP 645.PP
604.SH "AUTHORS" 646.SH "AUTHORS"
605.PP 647.PP
606.IP "John Bovey" 648.IP "John Bovey"
607University of Kent, 1992, wrote the original Xvt\&. 649University of Kent, 1992, wrote the original Xvt\&.
… …
616.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" 658.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
617Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) 659Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
618.IP "Geoff Wing <gcw@pobox\&.com>" 660.IP "Geoff Wing <gcw@pobox\&.com>"
619Rewrote screen display and text selection routines\&. 661Rewrote screen display and text selection routines\&.
620Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) 662Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
621.IP "Marc Alexander Lehman <rxvt@schmorp\&.de>" 663.IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>"
622Rewrote most of the display code and internal character handling 664Forked rxvt-unicode, rewrote most of the display code and
623to store text in unicode\&. Numerous other fixes and extensions\&. 665internal character handling to store text in unicode,
666improve xterm compatibility and apply numerous other bugfixes
667and extensions\&.
624.br 668.br
625Project Coordinator (Changes 1\&.0 - ) 669Project Coordinator (Changes 1\&.0 - )
626.PP 670.PP

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines