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.1 by pcg, Mon Nov 24 17:28:08 2003 UTC vs.
Revision 1.21 by root, Sat Jul 31 16:05:45 2004 UTC

1.TH "RXVT" "1" "RXVTDATE()" "X Version 11" "X Tools" 1.TH "RXVT" "1" "2004-07-31" "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\fBrxvt\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\&.4\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
… …
29.PP 29.PP
30Note that \fBrxvt\fP permits the resource name to be used as a long-option 30Note 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 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
35Also note that if you do not explictly specify a font (\fB-fn\fP and \fB-fm\fP)
36or a multichar encoding method (\fB-km\fP), rxvt will select a font for the
37preferable encoding according to your locale\&. Supported encodings are:
38\fBISO-8859-\fPn (n=\fB1\fP\&.\&.\&.\fB15\fP), \fBKOI8-R\fP, \fBKOI8-U\fP, \fBEUC-JP\fP,
39\fBShift_JIS\fP, \fBEUC-KR\fP, \fBEUC-CN\fP (aka \fBGB\fP), and \fBBig5\fP\&.
40.PP 34.PP
41The following options are available: 35The following options are available:
42.PP 36.PP
43.IP "\fB-help\fP, \fB--help\fP" 37.IP "\fB-help\fP, \fB--help\fP"
44Print out a message describing available options\&. 38Print out a message describing available options\&.
… …
57resource \fBjumpScroll\fP\&. 51resource \fBjumpScroll\fP\&.
58.IP "\fB-ip\fP|\fB+ip\fP" 52.IP "\fB-ip\fP|\fB+ip\fP"
59Turn on/off inheriting parent window\&'s pixmap\&. Alternative form 53Turn on/off inheriting parent window\&'s pixmap\&. Alternative form
60is \fB-tr\fP; 54is \fB-tr\fP;
61resource \fBinheritPixmap\fP\&. 55resource \fBinheritPixmap\fP\&.
56.IP "\fB-fade\fP \fInumber\fP"
57Fade the text by the given percentage when focus is lost\&.
58.IP "\fB-tint\fP \fIcolour\fP"
59Tint the transparent background pixmap with the given colour when
60transparency is enabled with \fB-tr\fP or \fB-ip\fP\&. See also
61the \fB-sh\fP option that cna be used to brighten or darken
62the image in addition to tinting it\&.
63dot(\fB-sh\fP) \fInumber\fP
64Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background
65image in addition to tinting it\&.
62.IP "\fB-bg\fP \fIcolour\fP" 66.IP "\fB-bg\fP \fIcolour\fP"
63Window background colour; 67Window background colour;
64resource \fBbackground\fP\&. 68resource \fBbackground\fP\&.
65.IP "\fB-fg\fP \fIcolour\fP" 69.IP "\fB-fg\fP \fIcolour\fP"
66Window foreground colour; 70Window foreground colour;
67resource \fBforeground\fP\&. 71resource \fBforeground\fP\&.
68.IP "\fB-pixmap:\fP \fIfile[;geom]\fP" 72.IP "\fB-pixmap\fP \fIfile[;geom]\fP"
69Compile \fIXPM\fP: Specify XPM file for the background and also 73Compile \fIXPM\fP: Specify XPM file for the background and also
70optionally specify its scaling with a geometry string\&. Note you 74optionally specify its scaling with a geometry string\&. Note you
71may need to add quotes to avoid special shell interpretation of 75may need to add quotes to avoid special shell interpretation of
72the `;\&' in the command-line; 76the `;\&' in the command-line;
73resource \fBbackgroundPixmap\fP\&. 77resource \fBbackgroundPixmap\fP\&.
74.IP "\fB-cr\fP \fIcolour\fP" 78.IP "\fB-cr\fP \fIcolour\fP"
75The cursor colour; 79The cursor colour;
76resource \fBcursorColor\fP\&. 80resource \fBcursorColor\fP\&.
77.IP "\fB-pr\fP \fIcolour\fP" 81.IP "\fB-pr\fP \fIcolour\fP"
78The mouse pointer colour; 82The mouse pointer foreground colour;
79resource \fBpointerColor\fP\&. 83resource \fBpointerColor\fP\&.
84.IP "\fB-pr2\fP \fIcolour\fP"
85The mouse pointer background colour;
86resource \fBpointerColor2\fP\&.
80.IP "\fB-bd\fP \fIcolour\fP" 87.IP "\fB-bd\fP \fIcolour\fP"
81The colour of the border between the xterm scrollbar and the text; 88The colour of the border between the xterm scrollbar and the text;
82resource \fBborderColor\fP\&. 89resource \fBborderColor\fP\&.
83.IP "\fB-fn\fP \fIfontname\fP" 90.IP "\fB-fn\fP \fIfontname\fP"
84Main normal text font; 91Select the fonts to be used\&.
92This is a comma seperated list of font names that are used in turn when
93trying to display Unicode characters\&.
94The first font defines the cell size for characters; other fonts might
95be smaller, but not larger\&.
96A reasonable default font list is always appended to it\&.
85resource \fBfont\fP\&. 97resource \fBfont\fP\&.
86.IP "\fB-fb\fP \fIfontname\fP" 98.IP "\fB-rb\fP|\fB+rb\fP"
87Main bold text font; 99Enable "real bold" support\&.
100When this option is on, bold text will be displayed using the first
101available bold font in the font list\&.
102Bold fonts should thus be specified in the font list after their
103corresponding regular fonts\&.
104If no bold font can be found, a regular font will be used\&.
88resource \fBboldFont\fP\&. 105resource \fBrealBold\fP\&.
89.IP "\fB-fm\fP \fIfontname\fP"
90Main multicharacter font;
91resource \fBmfont\fP\&.
92.IP "\fB-km\fP \fImode\fP"
93Compile \fImultichar_languages\fP:
94Multiple-character font-set encoding mode;
95\fBeucj\fP: EUC Japanese encoding\&.
96\fBsjis\fP: Shift JIS encoding\&.
97\fBbig5\fP: BIG5 encoding\&.
98\fBgb\fP: GB encoding\&.
99\fBkr\fP: EUC Korean encoding\&.
100\fBnoenc\fP: no encoding;
101resource \fBmultichar_encoding\fP\&.
102.IP "\fB-grk\fP \fImode\fP"
103Compile \fIGreek\fP: Greek keyboard translation;
104\fBiso\fP: ISO-8859 mapping\&.
105\fBibm\fP: IBM-437 mapping;
106resource \fBgreek_keyboard\fP\&.
107.IP "\fB-name\fP \fIname\fP" 106.IP "\fB-name\fP \fIname\fP"
108Specify the application name under which resources 107Specify the application name under which resources
109are to be obtained, rather than the default executable file name\&. 108are to be obtained, rather than the default executable file name\&.
110Name should not contain `\&.\&' or `*\&' characters\&. 109Name should not contain `\&.\&' or `*\&' characters\&.
111Also sets the icon and title name\&. 110Also sets the icon and title name\&.
… …
135Put scrollbar on right/left; 134Put scrollbar on right/left;
136resource \fBscrollBar_right\fP\&. 135resource \fBscrollBar_right\fP\&.
137.IP "\fB-st\fP|\fB+st\fP" 136.IP "\fB-st\fP|\fB+st\fP"
138Display normal (non XTerm/NeXT) scrollbar without/with a trough; 137Display normal (non XTerm/NeXT) scrollbar without/with a trough;
139resource \fBscrollBar_floating\fP\&. 138resource \fBscrollBar_floating\fP\&.
140.IP "\fB-mcc\fP|\fB+mcc\fP"
141Compile \fImultichar_languages\fP: treat multibyte glyphs as single
142character for backspace, delete and cursor movement keys;
143resource \fBmultibyte_cursor\fP\&.
144.IP "\fB-bc\fP|\fB+bc\fP" 139.IP "\fB-bc\fP|\fB+bc\fP"
145Blink the cursor; resource \fBcursorBlink\fP\&. 140Blink the cursor; resource \fBcursorBlink\fP\&.
146.IP "\fB-iconic\fP" 141.IP "\fB-iconic\fP"
147Start iconified, if the window manager supports that option\&. 142Start iconified, if the window manager supports that option\&.
148Alternative form is \fB-ic\fP\&. 143Alternative form is \fB-ic\fP\&.
… …
191\fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; 186\fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP;
192resource \fBpreeditType\fP\&. 187resource \fBpreeditType\fP\&.
193.IP "\fB-im\fP \fItext\fP" 188.IP "\fB-im\fP \fItext\fP"
194Compile \fIXIM\fP: input method name\&. 189Compile \fIXIM\fP: input method name\&.
195resource \fBinputMethod\fP\&. 190resource \fBinputMethod\fP\&.
191.IP "\fB-imlocale\fP \fIstring\fP"
192The locale to use for opening the IM\&. You can use an LC_CTYPE
193of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
194for the input extension to be able to input japanese characters
195while staying in another locale\&.
196.IP "\fB-insecure\fP"
197Enable "insecure" mode, which currently enables most of the escape
198sequences that echo strings\&. See the resource \fBinsecure\fP for
199more info\&.
196.IP "\fB-mod\fP \fImodifier\fP" 200.IP "\fB-mod\fP \fImodifier\fP"
197Override detection of Meta modifier with specified key: 201Override detection of Meta modifier with specified key:
198\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 202\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
199\fBmod4\fP, \fBmod5\fP; 203\fBmod4\fP, \fBmod5\fP;
200resource \fImodifier\fP\&. 204resource \fImodifier\fP\&.
205.IP "\fB-ssc\fP|\fB+ssc\fP"
206Turn on/off secondary screen (default enabled);
207resource \fBsecondaryScreen\fP\&.
208.IP "\fB-ssr\fP|\fB+ssr\fP"
209Turn on/off secondary screen scroll (default enabled);
210resource \fBsecondaryScroll\fP\&.
201.IP "\fB-xrm\fP \fIresourcestring\fP" 211.IP "\fB-xrm\fP \fIresourcestring\fP"
202No effect on rxvt\&. Simply passes through an argument to be made 212No effect on rxvt\&. Simply passes through an argument to be made
203available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP 213available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP
204in some window managers\&. 214in some window managers\&.
205.SH "RESOURCES (available also as long-options)" 215.SH "RESOURCES (available also as long-options)"
206.PP 216.PP
207Note: `rxvt --help\&' gives a list of all resources (long options) compiled 217Note: `rxvt --help\&' gives a list of all resources (long options) compiled
208into your version\&. 218into your version\&.
219.PP
220There are two different methods that rxvt can use to get the
221Xresource data: using the X libraries (Xrm*-functions) or internal Xresources
222reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists
223\fBXGetDefaults\fP), you can set and change the resources using X11
224tools like \fBxset\fP\&. Many distribution do also load settings from the
225\fB~/\&.Xresources\fP file when X starts\&.
226.PP
209If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists 227If compiled with internal Xresources support (i\&.e\&. \fBrxvt
210\fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in 228-h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application
211XAPPLOADDIR/Rxvt (compile-time defined: usually 229defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually
212\fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, 230\fB/usr/lib/X11/app-defaults/URxvt\fP) and resources set in
213or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when 231\fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&.
214reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and 232Note that when reading X resources, \fBrxvt\fP recognizes two class
215\fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both 233names: \fBXTerm\fP and \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources
216\fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name 234common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured,
217\fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and 235while the class name \fBURxvt\fP allows resources unique to \fBrxvt\fP,
218key-handling, to be shared between different \fBrxvt\fP configurations\&. 236notably colours and key-handling, to be shared between different
219If no resources are specified, suitable defaults will be used\&. 237\fBrxvt\fP configurations\&. If no resources are specified, suitable
220Command-line arguments can be used to override resource settings\&. The 238defaults will be used\&. Command-line arguments can be used to override
221following resources are allowed: 239resource settings\&. The following resources are allowed:
222.PP 240.PP
223.IP "\fBgeometry:\fP \fIgeom\fP" 241.IP "\fBgeometry:\fP \fIgeom\fP"
224Create the window with the specified X window geometry [default 242Create the window with the specified X window geometry [default
22580x24]; 24380x24];
226option \fB-geometry\fP\&. 244option \fB-geometry\fP\&.
… …
241but the actual colour names used are listed in the 259but the actual colour names used are listed in the
242\fBCOLORS AND GRAPHICS\fP section\&. 260\fBCOLORS AND GRAPHICS\fP section\&.
243.IP "\fBcolorBD:\fP \fIcolour\fP" 261.IP "\fBcolorBD:\fP \fIcolour\fP"
244Use the specified colour to display bold characters when the 262Use the specified colour to display bold characters when the
245foreground colour is the default\&. 263foreground colour is the default\&.
264This option will be ignored if \fBrealBold\fP is enabled\&.
246.IP "\fBcolorUL:\fP \fIcolour\fP" 265.IP "\fBcolorUL:\fP \fIcolour\fP"
247Use the specified colour to display underlined characters when the 266Use the specified colour to display underlined characters when the
248foreground colour is the default\&. 267foreground colour is the default\&.
249.IP "\fBcolorRV:\fP \fIcolour\fP" 268.IP "\fBcolorRV:\fP \fIcolour\fP"
250Use the specified colour as the background for reverse video 269Use the specified colour as the background for reverse video
… …
271option \fB+j\fP\&. 290option \fB+j\fP\&.
272.IP "\fBinheritPixmap:\fP \fIboolean\fP" 291.IP "\fBinheritPixmap:\fP \fIboolean\fP"
273\fBTrue\fP: make the background inherit the parent windows\&' pixmap, 292\fBTrue\fP: make the background inherit the parent windows\&' pixmap,
274giving artificial transparency\&. 293giving artificial transparency\&.
275\fBFalse\fP: do not inherit the parent windows\&' pixmap\&. 294\fBFalse\fP: do not inherit the parent windows\&' pixmap\&.
295.IP "\fBfading:\fP \fInumber\fP"
296Fade the text by the given percentage when focus is lost\&.
297.IP "\fBtintColor:\fP \fIcolour\fP"
298Tint the transparent background pixmap with the given colour\&.
299.IP "\fBshading:\fP \fInumber\fP"
300Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background
301image in addition to tinting it\&.
302.IP "\fBfading:\fP \fInumber\fP"
303Scale the tint colour by the given percentage\&.
276.IP "\fBscrollColor:\fP \fIcolour\fP" 304.IP "\fBscrollColor:\fP \fIcolour\fP"
277Use the specified colour for the scrollbar [default #B2B2B2]\&. 305Use the specified colour for the scrollbar [default #B2B2B2]\&.
278.IP "\fBtroughColor:\fP \fIcolour\fP" 306.IP "\fBtroughColor:\fP \fIcolour\fP"
279Use the specified colour for the scrollbar\&'s trough area [default 307Use the specified colour for the scrollbar\&'s trough area [default
280#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. 308#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&.
… …
295.IP "\fBpath:\fP \fIpath\fP" 323.IP "\fBpath:\fP \fIpath\fP"
296Specify the colon-delimited search path for finding files (XPM and 324Specify the colon-delimited search path for finding files (XPM and
297menus), in addition to the paths specified by the \fBRXVTPATH\fP and 325menus), in addition to the paths specified by the \fBRXVTPATH\fP and
298\fBPATH\fP environment variables\&. 326\fBPATH\fP environment variables\&.
299.IP "\fBfont:\fP \fIfontname\fP" 327.IP "\fBfont:\fP \fIfontname\fP"
300Select the main text font used [default 7x14]; 328Select the fonts to be used\&.
329This is a comma seperated list of font names that are used in turn when
330trying to display Unicode characters\&.
331The first font defines the cell size for characters; other fonts might
332be smaller, but not larger\&.
333A reasonable default font list is always appended to it\&.
301option \fB-fn\fP\&. 334option \fB-fn\fP\&.
302.IP "\fBfont\fP\fIn\fP\fB:\fP \fIfontname\fP" 335.IP "\fBrealBold:\fP \fIboolean\fP"
303Specify the alternative font \fIn\fP\&. The default font values: 336\fBTrue\fP: Enable "real bold" support\&.
304.br 337When this option is on, bold text will be displayed using the first
305.RS 338available bold font in the font list\&.
306.HP 339Bold fonts should thus be specified in the font list after their
307.TS 340corresponding regular fonts\&.
308tab(`); 341If no bold font can be found, a regular font will be used\&.
309l l .
310\fBfont\fP: `\ 7x14
311\fBfont1\fP: `\ 6x10
312\fBfont2\fP: `\ 6x13
313\fBfont3\fP: `\ 8x13
314\fBfont4\fP: `\ 9x15
315.TE
316.RE
317.IP "\fBboldFont:\fP \fIfontname\fP"
318Specify the name of the bold font to use if \fBcolorBD\fP has not been
319specified and it is not possible to map the default foreground colour
320to colour 8-15 [default NONE]\&. This font must be the same height and
321width as the normal font;
322option \fB-fb\fP\&. 342option \fB-rb\fP\&.
323.IP "\fBmfont:\fP \fIfontname\fP" 343\fBFalse\fP: Display bold text in a regular font, using the color
324Select the main multiple-character text font used [default k14]; 344specified with \fBcolorBD\fP;
325option \fB-fk\fP\&.
326.IP "\fBmfont\fP\fIn\fP\fB:\fP \fIfontname\fP"
327Specify the alternative multiple-character font \fIn\fP\&. If compiled
328for multiple-character fonts, the Roman and multiple-character font
329sizes should match\&.
330.IP "\fBmultichar_encoding:\fP \fImode\fP"
331Set the encoding mode to be used when multicharacter encoding is
332received;
333\fBeucj\fP: EUC Japanese encoding [default for Kanji]\&.
334\fBsjis\fP: Shift JIS encoding\&.
335\fBbig5\fP: BIG5 encoding\&.
336\fBgb\fP: GB encoding\&.
337\fBkr\fP: EUC Korean encoding\&.
338\fBnoenc\fP: no encoding;
339option \fB-km\fP\&.
340.IP "\fBgreek_keyboard:\fP \fImode\fP"
341Set the Greek keyboard translation mode to be used;
342\fBiso\fP: ISO-8859 mapping (elot-928) [default]\&.
343\fBibm\fP: IBM-437 mapping (DOS codepage 737);
344option \fB-grk\fP\&. 345option \fB+rb\fP\&.
345.IP "\fBgreektoggle_key:\fP \fIkeysym\fP"
346Set the key to toggle keyboard input between no translation and
347Greek translation [default \fBMode_switch\fP]\&.
348For more details, see the distributed file \fBREADME\&.greek\fP\&.
349.IP "\fBselectstyle:\fP \fImode\fP" 346.IP "\fBselectstyle:\fP \fImode\fP"
350Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which 347Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which
351is xterm style with 2\&.20 old word selection, or anything else which 348is xterm style with 2\&.20 old word selection, or anything else which
352gives xterm style selection\&. 349gives xterm style selection\&.
353.IP "\fBscrollstyle:\fP \fImode\fP" 350.IP "\fBscrollstyle:\fP \fImode\fP"
354Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP 351Set scrollbar style to \fBrxvt\fP, \fBrxvt\fP, \fBplain\fP, \fBnext\fP or \fBxterm\fP
355.IP "\fBtitle:\fP \fIstring\fP" 352.IP "\fBtitle:\fP \fIstring\fP"
356Set window title string, the default title is the command-line 353Set window title string, the default title is the command-line
357specified after the \fB-e\fP option, if any, otherwise the application 354specified after the \fB-e\fP option, if any, otherwise the application
358name; 355name;
359option \fB-title\fP\&. 356option \fB-title\fP\&.
… …
460option \fB-bc\fP\&. 457option \fB-bc\fP\&.
461.IP "\fBpointerBlank:\fP \fIboolean\fP" 458.IP "\fBpointerBlank:\fP \fIboolean\fP"
462\fBTrue\fP: blank the pointer when a key is pressed or after a set number 459\fBTrue\fP: blank the pointer when a key is pressed or after a set number
463of seconds of inactivity\&. 460of seconds of inactivity\&.
464\fBFalse\fP: the pointer is always visible [default]\&. 461\fBFalse\fP: the pointer is always visible [default]\&.
462.IP "\fBpointerColor:\fP \fIcolour\fP"
463Mouse pointer foreground colour\&.
464.IP "\fBpointerColor2:\fP \fIcolour\fP"
465Mouse pointer background colour\&.
465.IP "\fBpointerBlankDelay:\fP \fInumber\fP" 466.IP "\fBpointerBlankDelay:\fP \fInumber\fP"
466Specifies number of seconds before blanking the pointer [default 2]\&. 467Specifies number of seconds before blanking the pointer [default 2]\&.
467.IP "\fBmultibyte_cursor:\fP \fIboolean\fP"
468\fBTrue\fP: consider multibyte glyphs as single character for backspace,
469delete and cursor movement keys;
470option \fB-mcc\fP\&.
471\fBFalse\fP: move through all components of all glyphs;
472option \fB+mcc\fP\&.
473.IP "\fBbackspacekey:\fP \fIstring\fP" 468.IP "\fBbackspacekey:\fP \fIstring\fP"
474The string to send when the backspace key is pressed\&. If set to 469The string to send when the backspace key is pressed\&. If set to
475\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, 470\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted,
476\fBBackspace\fP (code 8) - which can be reversed with the appropriate 471\fBBackspace\fP (code 8) - which can be reversed with the appropriate
477DEC private mode escape sequence\&. 472DEC private mode escape sequence\&.
… …
488\fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; 483\fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP;
489option \fB-pt\fP\&. 484option \fB-pt\fP\&.
490.IP "\fBinputMethod:\fP \fIname\fP" 485.IP "\fBinputMethod:\fP \fIname\fP"
491\fIname\fP of inputMethod to use; 486\fIname\fP of inputMethod to use;
492option \fB-im\fP\&. 487option \fB-im\fP\&.
488.IP "\fBimLocale:\fP \fIname\fP"
489The locale to use for opening the IM\&. You can use an LC_CTYPE
490of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
491for the input extension to be able to input japanese characters
492while staying in another locale\&.
493option \fB-imlocale\fP\&.
494.IP "\fBinsecure\fP"
495Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences
496that echo arbitrary strings like the icon name or the locale\&. This
497could be abused if somebody gets 8-bit-clean access to your
498display, wether throuh a mail client displaying mail bodies
499unfiltered or though write(1)\&. Therefore, these sequences are
500disabled by default\&. (Note that other terminals, including xterm,
501have these sequences enabled by default)\&. You can enable them
502by setting this boolean resource or specifying \fB-insecure\fP as
503an option\&. At the moment, this enabled display-answer, locale,
504findfont, icon label and window title requests as well as dynamic
505menubar dispatch\&.
493.IP "\fBmodifier:\fP \fImodifier\fP" 506.IP "\fBmodifier:\fP \fImodifier\fP"
494Set the key to be interpreted as the Meta key to: 507Set the key to be interpreted as the Meta key to:
495\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 508\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
496\fBmod4\fP, \fBmod5\fP; 509\fBmod4\fP, \fBmod5\fP;
497option \fB-mod\fP\&. 510option \fB-mod\fP\&.
498.IP "\fBanswerbackString:\fP \fIstring\fP" 511.IP "\fBanswerbackString:\fP \fIstring\fP"
499Specify the reply rxvt sends to the shell when an ENQ (control-E) 512Specify the reply rxvt sends to the shell when an ENQ (control-E)
500character is passed through\&. It may contain escape values as 513character is passed through\&. It may contain escape values as
501described in the entry on \fBkeysym\fP following\&. 514described in the entry on \fBkeysym\fP following\&.
515.IP "\fBsecondaryScreen:\fP \fIbool\fP"
516Turn on/off secondary screen (default enabled)\&.
517.IP "\fBsecondaryScroll:\fP \fIbool\fP"
518Turn on/off secondary screen scroll (default enabled)\&. If
519the this option is enabled, scrolls on the secondary screen will
520change the scrollback buffer and switching to/from the secondary screen
521will instead scroll the screen up\&.
502.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" 522.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP"
503Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It 523Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It
504may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, 524may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape,
505\en: newline, \er: return, \et: tab, \e000: octal number) or control 525\en: newline, \er: return, \et: tab, \e000: octal number) or control
506characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with 526characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with
… …
555.PP 575.PP
556\fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be 576\fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be
557seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this 577seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this
558feature, \fBrxvt\fP must be installed setuid root on some systems\&. 578feature, \fBrxvt\fP must be installed setuid root on some systems\&.
559.SH "COLORS AND GRAPHICS" 579.SH "COLORS AND GRAPHICS"
560.PP
561If graphics support was enabled at compile-time, \fBrxvt\fP can be queried
562with ANSI escape sequences and can address individual pixels instead of
563text characters\&. Note the graphics support is still considered beta code\&.
564.PP 580.PP
565In addition to the default foreground and background colours, \fBrxvt\fP 581In addition to the default foreground and background colours, \fBrxvt\fP
566can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink 582can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
567versions of the same)\&. 583versions of the same)\&.
568Here is a list of the colours with their \fBrgb\&.txt\fP names\&. 584Here is a list of the colours with their \fBrgb\&.txt\fP names\&.
… …
632.PP 648.PP
633Cursor change support is not yet implemented\&. 649Cursor change support is not yet implemented\&.
634.PP 650.PP
635Click-and-drag doesn\&'t work with X11 mouse report overriding\&. 651Click-and-drag doesn\&'t work with X11 mouse report overriding\&.
636.PP 652.PP
637Graphics support is fairly crude\&.
638.PP
639.SH "FTP LOCATION" 653.SH "FTP LOCATION"
640.PP 654.PP
641rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites 655rxvt-3\&.4\&.tar\&.gz can be found at the following ftp sites
642RXVTFTPSITE() 656ftp://ftp\&.rxvt\&.org/pub/rxvt
643.PP 657.PP
644.SH "CURRENT PROJECT COORDINATOR" 658.SH "CURRENT PROJECT COORDINATOR"
645.PP 659.PP
646.IP "Project Coordinator" 660.IP "Project Coordinator"
647RXVTMAINT() RXVTMAINTEMAIL() 661Marc A\&. Lehmann <rxvt@schmorp\&.de>
648.br 662.br
649.IP "Web page maintainter" 663.IP "Web page maintainter"
650RXVTWEBMAINT() RXVTWEBMAINTEMAIL() 664Marc A\&. Lehmann <rxvt@schmorp\&.de>
651.br 665.br
652RXVTWEBPAGE() 666<http://www\&.sourceforge\&.net/projects/rxvt-unicode/>
653.br 667.br
654.IP "Mailing list"
655The Rxvt Workers <rxvt-workers@rxvt\&.org>
656mailing list has also been established for rxvt development, to
657subscribe, email to
658<rxvt-workers-subscribe@rxvt\&.org>\&.
659There is also a mailing list for announcements of new releases of
660rxvt\&. To subscribe, email to
661<rxvt-announce-subscribe@rxvt\&.org>\&.
662.PP 668.PP
663.SH "AUTHORS" 669.SH "AUTHORS"
664.PP 670.PP
665.IP "John Bovey" 671.IP "John Bovey"
666University of Kent, 1992, wrote the original Xvt\&. 672University of Kent, 1992, wrote the original Xvt\&.
667.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" 673.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>"
668very heavily modified Xvt and came up with Rxvt 674very heavily modified Xvt and came up with Rxvt
669.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" 675.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>"
670wrote the Greek Keyboard Input 676wrote the Greek Keyboard Input (no longer in code)
671.IP "mj olesen <olesen@me\&.QueensU\&.CA>" 677.IP "mj olesen <olesen@me\&.QueensU\&.CA>"
672Wrote the menu system\&. 678Wrote the menu system\&.
673.br 679.br
674Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) 680Project Coordinator (changes\&.txt 2\&.11 to 2\&.21)
675.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" 681.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
676Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) 682Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
677.IP "Geoff Wing <gcw@pobox\&.com>" 683.IP "Geoff Wing <gcw@pobox\&.com>"
678Rewrote screen display and text selection routines\&. 684Rewrote screen display and text selection routines\&.
685Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
686.IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>"
687Forked rxvt-unicode, rewrote most of the display code and
688internal character handling to store text in unicode,
689improve xterm compatibility and apply numerous other bugfixes
690and extensions\&.
679.br 691.br
680Project Coordinator (changes\&.txt 2\&.4\&.6 - ) 692Project Coordinator (Changes 1\&.0 - )
693.PP

Diff Legend

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