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

Comparing rxvt-unicode/doc/rxvt.1 (file contents):
Revision 1.2 by pcg, Thu Dec 18 00:38:07 2003 UTC vs.
Revision 1.23 by root, Sun Aug 8 16:43:55 2004 UTC

1.if !\n(.g .ab GNU tbl requires GNU troff. 1.if !\n(.g .ab GNU tbl requires GNU troff.
2.if !dTS .ds TS 2.if !dTS .ds TS
3.if !dTE .ds TE 3.if !dTE .ds TE
4.TH "RXVT" "1" "RXVTDATE()" "X Version 11" "X Tools" 4.TH "RXVT" "1" "2004-08-06" "X Version 11" "X Tools"
5.SH "NAME" 5.SH "NAME"
6rxvt (ouR XVT) \- a VT102 emulator for the X window system 6rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system
7.PP 7.PP
8.SH "SYNOPSIS" 8.SH "SYNOPSIS"
9.PP 9.PP
10\fBrxvt\fP [options] [-e command [ args ]] 10\fBrxvt\fP [options] [-e command [ args ]]
11.PP 11.PP
12.SH "DESCRIPTION" 12.SH "DESCRIPTION"
13.PP 13.PP
14\fBrxvt\fP, version \fBRXVTVERSION()\fP, is a colour vt102 terminal emulator 14\fBrxvt-unicode\fP, version \fB3\&.4\fP, is a colour vt102 terminal emulator
15intended as an \fIxterm\fP(1) replacement for users who do not require 15intended as an \fIxterm\fP(1) replacement for users who do not require
16features such as Tektronix 4014 emulation and toolkit-style configurability\&. 16features such as Tektronix 4014 emulation and toolkit-style configurability\&.
17As a result, \fBrxvt\fP uses much less swap space -- a significant 17As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant
18advantage on a machine serving many X sessions\&. 18advantage on a machine serving many X sessions\&.
19.PP 19.PP
20.PP 20.PP
21.SH "OPTIONS" 21.SH "OPTIONS"
22.PP 22.PP
54resource \fBjumpScroll\fP\&. 54resource \fBjumpScroll\fP\&.
55.IP "\fB-ip\fP|\fB+ip\fP" 55.IP "\fB-ip\fP|\fB+ip\fP"
56Turn on/off inheriting parent window\&'s pixmap\&. Alternative form 56Turn on/off inheriting parent window\&'s pixmap\&. Alternative form
57is \fB-tr\fP; 57is \fB-tr\fP;
58resource \fBinheritPixmap\fP\&. 58resource \fBinheritPixmap\fP\&.
59.IP "\fB-fade\fP \fInumber\fP"
60Fade the text by the given percentage when focus is lost\&.
61.IP "\fB-tint\fP \fIcolour\fP"
62Tint the transparent background pixmap with the given colour when
63transparency is enabled with \fB-tr\fP or \fB-ip\fP\&. See also
64the \fB-sh\fP option that can be used to brighten or darken
65the image in addition to tinting it\&.
66.IP "\fB-sh\fP"
67\fInumber\fP
68Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background
69image in addition to tinting it (i\&.e\&. \fB-tint\fP must be specified, too)\&.
59.IP "\fB-bg\fP \fIcolour\fP" 70.IP "\fB-bg\fP \fIcolour\fP"
60Window background colour; 71Window background colour;
61resource \fBbackground\fP\&. 72resource \fBbackground\fP\&.
62.IP "\fB-fg\fP \fIcolour\fP" 73.IP "\fB-fg\fP \fIcolour\fP"
63Window foreground colour; 74Window foreground colour;
64resource \fBforeground\fP\&. 75resource \fBforeground\fP\&.
65.IP "\fB-pixmap:\fP \fIfile[;geom]\fP" 76.IP "\fB-pixmap\fP \fIfile[;geom]\fP"
66Compile \fIXPM\fP: Specify XPM file for the background and also 77Compile \fIXPM\fP: Specify XPM file for the background and also
67optionally specify its scaling with a geometry string\&. Note you 78optionally specify its scaling with a geometry string\&. Note you
68may need to add quotes to avoid special shell interpretation of 79may need to add quotes to avoid special shell interpretation of
69the `;\&' in the command-line; 80the `;\&' in the command-line;
70resource \fBbackgroundPixmap\fP\&. 81resource \fBbackgroundPixmap\fP\&.
71.IP "\fB-cr\fP \fIcolour\fP" 82.IP "\fB-cr\fP \fIcolour\fP"
72The cursor colour; 83The cursor colour;
73resource \fBcursorColor\fP\&. 84resource \fBcursorColor\fP\&.
74.IP "\fB-pr\fP \fIcolour\fP" 85.IP "\fB-pr\fP \fIcolour\fP"
75The mouse pointer colour; 86The mouse pointer foreground colour;
76resource \fBpointerColor\fP\&. 87resource \fBpointerColor\fP\&.
88.IP "\fB-pr2\fP \fIcolour\fP"
89The mouse pointer background colour;
90resource \fBpointerColor2\fP\&.
77.IP "\fB-bd\fP \fIcolour\fP" 91.IP "\fB-bd\fP \fIcolour\fP"
78The colour of the border between the xterm scrollbar and the text; 92The colour of the border between the xterm scrollbar and the text;
79resource \fBborderColor\fP\&. 93resource \fBborderColor\fP\&.
80.IP "\fB-fn\fP \fIfontname\fP" 94.IP "\fB-fn\fP \fIfontname\fP"
81Select the fonts to be used used\&. This is a comma seperated 95Select the fonts to be used\&.
82list of font names that are used in turn when trying to display 96This is a comma seperated list of font names that are used in turn when
83unicode characters\&. The first font defines the cell size for characters, 97trying to display Unicode characters\&.
84pther fonts might be smaller, but not larger\&. A reasonable default list 98The first font defines the cell size for characters; other fonts might
85is appended\&. 99be smaller, but not larger\&.
100A reasonable default font list is always appended to it\&.
86resource \fBfont\fP\&. 101resource \fBfont\fP\&.
87.IP "\fB-grk\fP \fImode\fP" 102.IP "\fB-rb\fP|\fB+rb\fP"
88Compile \fIGreek\fP: Greek keyboard translation; 103Enable "real bold" support\&.
89\fBiso\fP: ISO-8859 mapping\&. 104When this option is on, bold text will be displayed using the first
90\fBibm\fP: IBM-437 mapping; 105available bold font in the font list\&.
106Bold fonts should thus be specified in the font list after their
107corresponding regular fonts\&.
108If no bold font can be found, a regular font will be used\&.
91resource \fBgreek_keyboard\fP\&. 109resource \fBrealBold\fP\&.
92.IP "\fB-name\fP \fIname\fP" 110.IP "\fB-name\fP \fIname\fP"
93Specify the application name under which resources 111Specify the application name under which resources
94are to be obtained, rather than the default executable file name\&. 112are to be obtained, rather than the default executable file name\&.
95Name should not contain `\&.\&' or `*\&' characters\&. 113Name should not contain `\&.\&' or `*\&' characters\&.
96Also sets the icon and title name\&. 114Also sets the icon and title name\&.
120Put scrollbar on right/left; 138Put scrollbar on right/left;
121resource \fBscrollBar_right\fP\&. 139resource \fBscrollBar_right\fP\&.
122.IP "\fB-st\fP|\fB+st\fP" 140.IP "\fB-st\fP|\fB+st\fP"
123Display normal (non XTerm/NeXT) scrollbar without/with a trough; 141Display normal (non XTerm/NeXT) scrollbar without/with a trough;
124resource \fBscrollBar_floating\fP\&. 142resource \fBscrollBar_floating\fP\&.
125.IP "\fB-mcc\fP|\fB+mcc\fP"
126Compile \fImultichar_languages\fP: treat multibyte glyphs as single
127character for backspace, delete and cursor movement keys;
128resource \fBmultibyte_cursor\fP\&.
129.IP "\fB-bc\fP|\fB+bc\fP" 143.IP "\fB-bc\fP|\fB+bc\fP"
130Blink the cursor; resource \fBcursorBlink\fP\&. 144Blink the cursor; resource \fBcursorBlink\fP\&.
131.IP "\fB-iconic\fP" 145.IP "\fB-iconic\fP"
132Start iconified, if the window manager supports that option\&. 146Start iconified, if the window manager supports that option\&.
133Alternative form is \fB-ic\fP\&. 147Alternative form is \fB-ic\fP\&.
141resource \fBinternalBorder\fP\&. 155resource \fBinternalBorder\fP\&.
142.IP "\fB-w\fP \fInumber\fP" 156.IP "\fB-w\fP \fInumber\fP"
143Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. 157Compile \fIfrills\fP: External border of \fInumber\fP pixels\&.
144Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits; 158Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits;
145resource \fBexternalBorder\fP\&. 159resource \fBexternalBorder\fP\&.
160.IP "\fB-bl\fP"
161Compile \fIfrills\fP: Set MWM hints to request a borderless window,
162i\&.e\&. if honoured by the WM, the rxvt window will not have window
163decorations; resource \fBborderLess\fP\&.
146.IP "\fB-lsp\fP \fInumber\fP" 164.IP "\fB-lsp\fP \fInumber\fP"
147Compile \fIlinespace\fP: Lines (pixel height) to insert between each 165Compile \fIlinespace\fP: Lines (pixel height) to insert between each
148row of the display; 166row of the display;
149resource \fBlinespace\fP\&. 167resource \fBlinespace\fP\&.
150.IP "\fB-tn\fP \fItermname\fP" 168.IP "\fB-tn\fP \fItermname\fP"
181.IP "\fB-imlocale\fP \fIstring\fP" 199.IP "\fB-imlocale\fP \fIstring\fP"
182The locale to use for opening the IM\&. You can use an LC_CTYPE 200The locale to use for opening the IM\&. You can use an LC_CTYPE
183of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP 201of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
184for the input extension to be able to input japanese characters 202for the input extension to be able to input japanese characters
185while staying in another locale\&. 203while staying in another locale\&.
204.IP "\fB-insecure\fP"
205Enable "insecure" mode, which currently enables most of the escape
206sequences that echo strings\&. See the resource \fBinsecure\fP for
207more info\&.
186.IP "\fB-mod\fP \fImodifier\fP" 208.IP "\fB-mod\fP \fImodifier\fP"
187Override detection of Meta modifier with specified key: 209Override detection of Meta modifier with specified key:
188\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 210\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
189\fBmod4\fP, \fBmod5\fP; 211\fBmod4\fP, \fBmod5\fP;
190resource \fImodifier\fP\&. 212resource \fImodifier\fP\&.
213.IP "\fB-ssc\fP|\fB+ssc\fP"
214Turn on/off secondary screen (default enabled);
215resource \fBsecondaryScreen\fP\&.
216.IP "\fB-ssr\fP|\fB+ssr\fP"
217Turn on/off secondary screen scroll (default enabled);
218resource \fBsecondaryScroll\fP\&.
191.IP "\fB-xrm\fP \fIresourcestring\fP" 219.IP "\fB-xrm\fP \fIresourcestring\fP"
192No effect on rxvt\&. Simply passes through an argument to be made 220No effect on rxvt\&. Simply passes through an argument to be made
193available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP 221available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP
194in some window managers\&. 222in some window managers\&.
195.SH "RESOURCES (available also as long-options)" 223.SH "RESOURCES (available also as long-options)"
196.PP 224.PP
197Note: `rxvt --help\&' gives a list of all resources (long options) compiled 225Note: `rxvt --help\&' gives a list of all resources (long options) compiled
198into your version\&. 226into your version\&.
227.PP
228There are two different methods that rxvt can use to get the
229Xresource data: using the X libraries (Xrm*-functions) or internal Xresources
230reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists
231\fBXGetDefaults\fP), you can set and change the resources using X11
232tools like \fBxset\fP\&. Many distribution do also load settings from the
233\fB~/\&.Xresources\fP file when X starts\&.
234.PP
199If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists 235If compiled with internal Xresources support (i\&.e\&. \fBrxvt
200\fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in 236-h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application
201XAPPLOADDIR/Rxvt (compile-time defined: usually 237defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually
202\fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, 238\fB/usr/lib/X11/app-defaults/URxvt\fP) and resources set in
203or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when 239\fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&.
204reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and 240Note that when reading X resources, \fBrxvt\fP recognizes two class
205\fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both 241names: \fBXTerm\fP and \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources
206\fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name 242common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured,
207\fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and 243while the class name \fBURxvt\fP allows resources unique to \fBrxvt\fP,
208key-handling, to be shared between different \fBrxvt\fP configurations\&. 244notably colours and key-handling, to be shared between different
209If no resources are specified, suitable defaults will be used\&. 245\fBrxvt\fP configurations\&. If no resources are specified, suitable
210Command-line arguments can be used to override resource settings\&. The 246defaults will be used\&. Command-line arguments can be used to override
211following resources are allowed: 247resource settings\&. The following resources are allowed:
212.PP 248.PP
213.IP "\fBgeometry:\fP \fIgeom\fP" 249.IP "\fBgeometry:\fP \fIgeom\fP"
214Create the window with the specified X window geometry [default 250Create the window with the specified X window geometry [default
21580x24]; 25180x24];
216option \fB-geometry\fP\&. 252option \fB-geometry\fP\&.
231but the actual colour names used are listed in the 267but the actual colour names used are listed in the
232\fBCOLORS AND GRAPHICS\fP section\&. 268\fBCOLORS AND GRAPHICS\fP section\&.
233.IP "\fBcolorBD:\fP \fIcolour\fP" 269.IP "\fBcolorBD:\fP \fIcolour\fP"
234Use the specified colour to display bold characters when the 270Use the specified colour to display bold characters when the
235foreground colour is the default\&. 271foreground colour is the default\&.
272This option will be ignored if \fBrealBold\fP is enabled\&.
236.IP "\fBcolorUL:\fP \fIcolour\fP" 273.IP "\fBcolorUL:\fP \fIcolour\fP"
237Use the specified colour to display underlined characters when the 274Use the specified colour to display underlined characters when the
238foreground colour is the default\&. 275foreground colour is the default\&.
239.IP "\fBcolorRV:\fP \fIcolour\fP" 276.IP "\fBcolorRV:\fP \fIcolour\fP"
240Use the specified colour as the background for reverse video 277Use the specified colour as the background for reverse video
261option \fB+j\fP\&. 298option \fB+j\fP\&.
262.IP "\fBinheritPixmap:\fP \fIboolean\fP" 299.IP "\fBinheritPixmap:\fP \fIboolean\fP"
263\fBTrue\fP: make the background inherit the parent windows\&' pixmap, 300\fBTrue\fP: make the background inherit the parent windows\&' pixmap,
264giving artificial transparency\&. 301giving artificial transparency\&.
265\fBFalse\fP: do not inherit the parent windows\&' pixmap\&. 302\fBFalse\fP: do not inherit the parent windows\&' pixmap\&.
303.IP "\fBfading:\fP \fInumber\fP"
304Fade the text by the given percentage when focus is lost\&.
305.IP "\fBtintColor:\fP \fIcolour\fP"
306Tint the transparent background pixmap with the given colour\&.
307.IP "\fBshading:\fP \fInumber\fP"
308Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background
309image in addition to tinting it\&.
310.IP "\fBfading:\fP \fInumber\fP"
311Scale the tint colour by the given percentage\&.
266.IP "\fBscrollColor:\fP \fIcolour\fP" 312.IP "\fBscrollColor:\fP \fIcolour\fP"
267Use the specified colour for the scrollbar [default #B2B2B2]\&. 313Use the specified colour for the scrollbar [default #B2B2B2]\&.
268.IP "\fBtroughColor:\fP \fIcolour\fP" 314.IP "\fBtroughColor:\fP \fIcolour\fP"
269Use the specified colour for the scrollbar\&'s trough area [default 315Use the specified colour for the scrollbar\&'s trough area [default
270#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. 316#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&.
285.IP "\fBpath:\fP \fIpath\fP" 331.IP "\fBpath:\fP \fIpath\fP"
286Specify the colon-delimited search path for finding files (XPM and 332Specify the colon-delimited search path for finding files (XPM and
287menus), in addition to the paths specified by the \fBRXVTPATH\fP and 333menus), in addition to the paths specified by the \fBRXVTPATH\fP and
288\fBPATH\fP environment variables\&. 334\fBPATH\fP environment variables\&.
289.IP "\fBfont:\fP \fIfontname\fP" 335.IP "\fBfont:\fP \fIfontname\fP"
290Select the fonts to be used used\&. This is a comma seperated 336Select the fonts to be used\&.
291list of font names that are used in turn when trying to display 337This is a comma seperated list of font names that are used in turn when
292unicode characters\&. The first font defines the cell size for characters, 338trying to display Unicode characters\&.
293pther fonts might be smaller, but not larger\&. A reasonable default list 339The first font defines the cell size for characters; other fonts might
294is appended\&. 340be smaller, but not larger\&.
341A reasonable default font list is always appended to it\&.
295option \fB-fn\fP\&. 342option \fB-fn\fP\&.
296.IP "\fBgreek_keyboard:\fP \fImode\fP" 343.IP "\fBrealBold:\fP \fIboolean\fP"
297Set the Greek keyboard translation mode to be used; 344\fBTrue\fP: Enable "real bold" support\&.
298\fBiso\fP: ISO-8859 mapping (elot-928) [default]\&. 345When this option is on, bold text will be displayed using the first
299\fBibm\fP: IBM-437 mapping (DOS codepage 737); 346available bold font in the font list\&.
347Bold fonts should thus be specified in the font list after their
348corresponding regular fonts\&.
349If no bold font can be found, a regular font will be used\&.
300option \fB-grk\fP\&. 350option \fB-rb\fP\&.
301.IP "\fBgreektoggle_key:\fP \fIkeysym\fP" 351\fBFalse\fP: Display bold text in a regular font, using the color
302Set the key to toggle keyboard input between no translation and 352specified with \fBcolorBD\fP;
303Greek translation [default \fBMode_switch\fP]\&. 353option \fB+rb\fP\&.
304For more details, see the distributed file \fBREADME\&.greek\fP\&.
305.IP "\fBselectstyle:\fP \fImode\fP" 354.IP "\fBselectstyle:\fP \fImode\fP"
306Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which 355Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which
307is xterm style with 2\&.20 old word selection, or anything else which 356is xterm style with 2\&.20 old word selection, or anything else which
308gives xterm style selection\&. 357gives xterm style selection\&.
309.IP "\fBscrollstyle:\fP \fImode\fP" 358.IP "\fBscrollstyle:\fP \fImode\fP"
310Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP 359Set scrollbar style to \fBrxvt\fP, \fBrxvt\fP, \fBplain\fP, \fBnext\fP or \fBxterm\fP
311.IP "\fBtitle:\fP \fIstring\fP" 360.IP "\fBtitle:\fP \fIstring\fP"
312Set window title string, the default title is the command-line 361Set window title string, the default title is the command-line
313specified after the \fB-e\fP option, if any, otherwise the application 362specified after the \fB-e\fP option, if any, otherwise the application
314name; 363name;
315option \fB-title\fP\&. 364option \fB-title\fP\&.
394Internal border of \fInumber\fP pixels\&. This resource is limited to 100; 443Internal border of \fInumber\fP pixels\&. This resource is limited to 100;
395option \fB-b\fP\&. 444option \fB-b\fP\&.
396.IP "\fBexternalBorder:\fP \fInumber\fP" 445.IP "\fBexternalBorder:\fP \fInumber\fP"
397External border of \fInumber\fP pixels\&. This resource is limited to 100; 446External border of \fInumber\fP pixels\&. This resource is limited to 100;
398option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&. 447option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&.
448.IP "\fBborderLess:\fP \fIboolean\fP"
449Set MWM hints to request a borderless window,
450i\&.e\&. if honoured by the WM, the rxvt window will not have window
451decorations; option \fB-bl\fP\&.
399.IP "\fBtermName:\fP \fItermname\fP" 452.IP "\fBtermName:\fP \fItermname\fP"
400Specifies the terminal type name to be set in the \fBTERM\fP 453Specifies the terminal type name to be set in the \fBTERM\fP
401environment variable; 454environment variable;
402option \fB-tn\fP\&. 455option \fB-tn\fP\&.
403.IP "\fBlinespace:\fP \fInumber\fP" 456.IP "\fBlinespace:\fP \fInumber\fP"
416option \fB-bc\fP\&. 469option \fB-bc\fP\&.
417.IP "\fBpointerBlank:\fP \fIboolean\fP" 470.IP "\fBpointerBlank:\fP \fIboolean\fP"
418\fBTrue\fP: blank the pointer when a key is pressed or after a set number 471\fBTrue\fP: blank the pointer when a key is pressed or after a set number
419of seconds of inactivity\&. 472of seconds of inactivity\&.
420\fBFalse\fP: the pointer is always visible [default]\&. 473\fBFalse\fP: the pointer is always visible [default]\&.
474.IP "\fBpointerColor:\fP \fIcolour\fP"
475Mouse pointer foreground colour\&.
476.IP "\fBpointerColor2:\fP \fIcolour\fP"
477Mouse pointer background colour\&.
421.IP "\fBpointerBlankDelay:\fP \fInumber\fP" 478.IP "\fBpointerBlankDelay:\fP \fInumber\fP"
422Specifies number of seconds before blanking the pointer [default 2]\&. 479Specifies number of seconds before blanking the pointer [default 2]\&.
423.IP "\fBmultibyte_cursor:\fP \fIboolean\fP"
424\fBTrue\fP: consider multibyte glyphs as single character for backspace,
425delete and cursor movement keys;
426option \fB-mcc\fP\&.
427\fBFalse\fP: move through all components of all glyphs;
428option \fB+mcc\fP\&.
429.IP "\fBbackspacekey:\fP \fIstring\fP" 480.IP "\fBbackspacekey:\fP \fIstring\fP"
430The string to send when the backspace key is pressed\&. If set to 481The string to send when the backspace key is pressed\&. If set to
431\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, 482\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted,
432\fBBackspace\fP (code 8) - which can be reversed with the appropriate 483\fBBackspace\fP (code 8) - which can be reversed with the appropriate
433DEC private mode escape sequence\&. 484DEC private mode escape sequence\&.
450The locale to use for opening the IM\&. You can use an LC_CTYPE 501The locale to use for opening the IM\&. You can use an LC_CTYPE
451of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP 502of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP
452for the input extension to be able to input japanese characters 503for the input extension to be able to input japanese characters
453while staying in another locale\&. 504while staying in another locale\&.
454option \fB-imlocale\fP\&. 505option \fB-imlocale\fP\&.
506.IP "\fBinsecure\fP"
507Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences
508that echo arbitrary strings like the icon name or the locale\&. This
509could be abused if somebody gets 8-bit-clean access to your
510display, wether throuh a mail client displaying mail bodies
511unfiltered or though write(1)\&. Therefore, these sequences are
512disabled by default\&. (Note that other terminals, including xterm,
513have these sequences enabled by default)\&. You can enable them
514by setting this boolean resource or specifying \fB-insecure\fP as
515an option\&. At the moment, this enabled display-answer, locale,
516findfont, icon label and window title requests as well as dynamic
517menubar dispatch\&.
455.IP "\fBmodifier:\fP \fImodifier\fP" 518.IP "\fBmodifier:\fP \fImodifier\fP"
456Set the key to be interpreted as the Meta key to: 519Set the key to be interpreted as the Meta key to:
457\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 520\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
458\fBmod4\fP, \fBmod5\fP; 521\fBmod4\fP, \fBmod5\fP;
459option \fB-mod\fP\&. 522option \fB-mod\fP\&.
460.IP "\fBanswerbackString:\fP \fIstring\fP" 523.IP "\fBanswerbackString:\fP \fIstring\fP"
461Specify the reply rxvt sends to the shell when an ENQ (control-E) 524Specify the reply rxvt sends to the shell when an ENQ (control-E)
462character is passed through\&. It may contain escape values as 525character is passed through\&. It may contain escape values as
463described in the entry on \fBkeysym\fP following\&. 526described in the entry on \fBkeysym\fP following\&.
527.IP "\fBsecondaryScreen:\fP \fIbool\fP"
528Turn on/off secondary screen (default enabled)\&.
529.IP "\fBsecondaryScroll:\fP \fIbool\fP"
530Turn on/off secondary screen scroll (default enabled)\&. If
531the this option is enabled, scrolls on the secondary screen will
532change the scrollback buffer and switching to/from the secondary screen
533will instead scroll the screen up\&.
464.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" 534.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP"
465Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It 535Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It
466may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, 536may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape,
467\en: newline, \er: return, \et: tab, \e000: octal number) or control 537\en: newline, \er: return, \et: tab, \e000: octal number) or control
468characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with 538characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with
517.PP 587.PP
518\fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be 588\fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be
519seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this 589seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this
520feature, \fBrxvt\fP must be installed setuid root on some systems\&. 590feature, \fBrxvt\fP must be installed setuid root on some systems\&.
521.SH "COLORS AND GRAPHICS" 591.SH "COLORS AND GRAPHICS"
522.PP
523If graphics support was enabled at compile-time, \fBrxvt\fP can be queried
524with ANSI escape sequences and can address individual pixels instead of
525text characters\&. Note the graphics support is still considered beta code\&.
526.PP 592.PP
527In addition to the default foreground and background colours, \fBrxvt\fP 593In addition to the default foreground and background colours, \fBrxvt\fP
528can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink 594can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
529versions of the same)\&. 595versions of the same)\&.
530Here is a list of the colours with their \fBrgb\&.txt\fP names\&. 596Here is a list of the colours with their \fBrgb\&.txt\fP names\&.
1041.PP 1107.PP
1042Cursor change support is not yet implemented\&. 1108Cursor change support is not yet implemented\&.
1043.PP 1109.PP
1044Click-and-drag doesn\&'t work with X11 mouse report overriding\&. 1110Click-and-drag doesn\&'t work with X11 mouse report overriding\&.
1045.PP 1111.PP
1046Graphics support is fairly crude\&.
1047.PP
1048.SH "FTP LOCATION" 1112.SH "FTP LOCATION"
1049.PP 1113.PP
1050rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites 1114rxvt-3\&.4\&.tar\&.gz can be found at the following ftp sites
1051RXVTFTPSITE() 1115ftp://ftp\&.rxvt\&.org/pub/rxvt
1052.PP 1116.PP
1053.SH "CURRENT PROJECT COORDINATOR" 1117.SH "CURRENT PROJECT COORDINATOR"
1054.PP 1118.PP
1055.IP "Project Coordinator" 1119.IP "Project Coordinator"
1056RXVTMAINT() RXVTMAINTEMAIL() 1120Marc A\&. Lehmann <rxvt@schmorp\&.de>
1057.br 1121.br
1058.IP "Web page maintainter" 1122.IP "Web page maintainter"
1059RXVTWEBMAINT() RXVTWEBMAINTEMAIL() 1123Marc A\&. Lehmann <rxvt@schmorp\&.de>
1060.br 1124.br
1061RXVTWEBPAGE() 1125<http://www\&.sourceforge\&.net/projects/rxvt-unicode/>
1062.br 1126.br
1063.IP "Mailing list"
1064The Rxvt Workers <rxvt-workers@rxvt\&.org>
1065mailing list has also been established for rxvt development, to
1066subscribe, email to
1067<rxvt-workers-subscribe@rxvt\&.org>\&.
1068There is also a mailing list for announcements of new releases of
1069rxvt\&. To subscribe, email to
1070<rxvt-announce-subscribe@rxvt\&.org>\&.
1071.PP 1127.PP
1072.SH "AUTHORS" 1128.SH "AUTHORS"
1073.PP 1129.PP
1074.IP "John Bovey" 1130.IP "John Bovey"
1075University of Kent, 1992, wrote the original Xvt\&. 1131University of Kent, 1992, wrote the original Xvt\&.
1076.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" 1132.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>"
1077very heavily modified Xvt and came up with Rxvt 1133very heavily modified Xvt and came up with Rxvt
1078.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" 1134.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>"
1079wrote the Greek Keyboard Input 1135wrote the Greek Keyboard Input (no longer in code)
1080.IP "mj olesen <olesen@me\&.QueensU\&.CA>" 1136.IP "mj olesen <olesen@me\&.QueensU\&.CA>"
1081Wrote the menu system\&. 1137Wrote the menu system\&.
1082.br 1138.br
1083Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) 1139Project Coordinator (changes\&.txt 2\&.11 to 2\&.21)
1084.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" 1140.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
1085Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) 1141Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
1086.IP "Geoff Wing <gcw@pobox\&.com>" 1142.IP "Geoff Wing <gcw@pobox\&.com>"
1087Rewrote screen display and text selection routines\&. 1143Rewrote screen display and text selection routines\&.
1144Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
1145.IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>"
1146Forked rxvt-unicode, rewrote most of the display code and
1147internal character handling to store text in unicode,
1148improve xterm compatibility and apply numerous other bugfixes
1149and extensions\&.
1088.br 1150.br
1089Project Coordinator (changes\&.txt 2\&.4\&.6 - ) 1151Project Coordinator (Changes 1\&.0 - )
1152.PP

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines