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.9 by pcg, Fri Apr 2 18:00:00 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-04-02" "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 \fB2\&.6\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-tint\fP \fIcolour\fP"
60Tint the transparent background pixmap with the given colour\&.
59.IP "\fB-bg\fP \fIcolour\fP" 61.IP "\fB-bg\fP \fIcolour\fP"
60Window background colour; 62Window background colour;
61resource \fBbackground\fP\&. 63resource \fBbackground\fP\&.
62.IP "\fB-fg\fP \fIcolour\fP" 64.IP "\fB-fg\fP \fIcolour\fP"
63Window foreground colour; 65Window foreground colour;
79resource \fBborderColor\fP\&. 81resource \fBborderColor\fP\&.
80.IP "\fB-fn\fP \fIfontname\fP" 82.IP "\fB-fn\fP \fIfontname\fP"
81Select the fonts to be used used\&. This is a comma seperated 83Select the fonts to be used used\&. This is a comma seperated
82list of font names that are used in turn when trying to display 84list of font names that are used in turn when trying to display
83unicode characters\&. The first font defines the cell size for characters, 85unicode characters\&. The first font defines the cell size for characters,
84pther fonts might be smaller, but not larger\&. A reasonable default list 86other fonts might be smaller, but not larger\&. A reasonable default font list
85is appended\&. 87is always appended to it\&.
86resource \fBfont\fP\&. 88resource \fBfont\fP\&.
87.IP "\fB-grk\fP \fImode\fP"
88Compile \fIGreek\fP: Greek keyboard translation;
89\fBiso\fP: ISO-8859 mapping\&.
90\fBibm\fP: IBM-437 mapping;
91resource \fBgreek_keyboard\fP\&.
92.IP "\fB-name\fP \fIname\fP" 89.IP "\fB-name\fP \fIname\fP"
93Specify the application name under which resources 90Specify the application name under which resources
94are to be obtained, rather than the default executable file name\&. 91are to be obtained, rather than the default executable file name\&.
95Name should not contain `\&.\&' or `*\&' characters\&. 92Name should not contain `\&.\&' or `*\&' characters\&.
96Also sets the icon and title name\&. 93Also sets the icon and title name\&.
120Put scrollbar on right/left; 117Put scrollbar on right/left;
121resource \fBscrollBar_right\fP\&. 118resource \fBscrollBar_right\fP\&.
122.IP "\fB-st\fP|\fB+st\fP" 119.IP "\fB-st\fP|\fB+st\fP"
123Display normal (non XTerm/NeXT) scrollbar without/with a trough; 120Display normal (non XTerm/NeXT) scrollbar without/with a trough;
124resource \fBscrollBar_floating\fP\&. 121resource \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" 122.IP "\fB-bc\fP|\fB+bc\fP"
130Blink the cursor; resource \fBcursorBlink\fP\&. 123Blink the cursor; resource \fBcursorBlink\fP\&.
131.IP "\fB-iconic\fP" 124.IP "\fB-iconic\fP"
132Start iconified, if the window manager supports that option\&. 125Start iconified, if the window manager supports that option\&.
133Alternative form is \fB-ic\fP\&. 126Alternative form is \fB-ic\fP\&.
181.IP "\fB-imlocale\fP \fIstring\fP" 174.IP "\fB-imlocale\fP \fIstring\fP"
182The locale to use for opening the IM\&. You can use an LC_CTYPE 175The 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 176of 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 177for the input extension to be able to input japanese characters
185while staying in another locale\&. 178while staying in another locale\&.
179.IP "\fB-insecure\fP"
180Enable "insecure" mode, which currently enables most of the escape
181sequences that echo strings\&. See the resource \fBinsecure\fP for
182more info\&.
186.IP "\fB-mod\fP \fImodifier\fP" 183.IP "\fB-mod\fP \fImodifier\fP"
187Override detection of Meta modifier with specified key: 184Override detection of Meta modifier with specified key:
188\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 185\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
189\fBmod4\fP, \fBmod5\fP; 186\fBmod4\fP, \fBmod5\fP;
190resource \fImodifier\fP\&. 187resource \fImodifier\fP\&.
188.IP "\fB-ssc\fP|\fB+ssc\fP"
189Turn on/off secondary screen (default enabled);
190resource \fBsecondaryScreen\fP\&.
191.IP "\fB-ssr\fP|\fB+ssr\fP"
192Turn on/off secondary screen scroll (default enabled);
193resource \fBsecondaryScroll\fP\&.
191.IP "\fB-xrm\fP \fIresourcestring\fP" 194.IP "\fB-xrm\fP \fIresourcestring\fP"
192No effect on rxvt\&. Simply passes through an argument to be made 195No effect on rxvt\&. Simply passes through an argument to be made
193available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP 196available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP
194in some window managers\&. 197in some window managers\&.
195.SH "RESOURCES (available also as long-options)" 198.SH "RESOURCES (available also as long-options)"
261option \fB+j\fP\&. 264option \fB+j\fP\&.
262.IP "\fBinheritPixmap:\fP \fIboolean\fP" 265.IP "\fBinheritPixmap:\fP \fIboolean\fP"
263\fBTrue\fP: make the background inherit the parent windows\&' pixmap, 266\fBTrue\fP: make the background inherit the parent windows\&' pixmap,
264giving artificial transparency\&. 267giving artificial transparency\&.
265\fBFalse\fP: do not inherit the parent windows\&' pixmap\&. 268\fBFalse\fP: do not inherit the parent windows\&' pixmap\&.
269.IP "\fBtintColor\fP \fIcolour\fP"
270Tint the transparent background pixmap with the given colour\&.
266.IP "\fBscrollColor:\fP \fIcolour\fP" 271.IP "\fBscrollColor:\fP \fIcolour\fP"
267Use the specified colour for the scrollbar [default #B2B2B2]\&. 272Use the specified colour for the scrollbar [default #B2B2B2]\&.
268.IP "\fBtroughColor:\fP \fIcolour\fP" 273.IP "\fBtroughColor:\fP \fIcolour\fP"
269Use the specified colour for the scrollbar\&'s trough area [default 274Use the specified colour for the scrollbar\&'s trough area [default
270#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. 275#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&.
288\fBPATH\fP environment variables\&. 293\fBPATH\fP environment variables\&.
289.IP "\fBfont:\fP \fIfontname\fP" 294.IP "\fBfont:\fP \fIfontname\fP"
290Select the fonts to be used used\&. This is a comma seperated 295Select the fonts to be used used\&. This is a comma seperated
291list of font names that are used in turn when trying to display 296list of font names that are used in turn when trying to display
292unicode characters\&. The first font defines the cell size for characters, 297unicode characters\&. The first font defines the cell size for characters,
293pther fonts might be smaller, but not larger\&. A reasonable default list 298other fonts might be smaller, but not larger\&. A reasonable default font list
294is appended\&. 299is always appended to this list\&.
295option \fB-fn\fP\&. 300option \fB-fn\fP\&.
296.IP "\fBgreek_keyboard:\fP \fImode\fP"
297Set the Greek keyboard translation mode to be used;
298\fBiso\fP: ISO-8859 mapping (elot-928) [default]\&.
299\fBibm\fP: IBM-437 mapping (DOS codepage 737);
300option \fB-grk\fP\&.
301.IP "\fBgreektoggle_key:\fP \fIkeysym\fP"
302Set the key to toggle keyboard input between no translation and
303Greek translation [default \fBMode_switch\fP]\&.
304For more details, see the distributed file \fBREADME\&.greek\fP\&.
305.IP "\fBselectstyle:\fP \fImode\fP" 301.IP "\fBselectstyle:\fP \fImode\fP"
306Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which 302Set 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 303is xterm style with 2\&.20 old word selection, or anything else which
308gives xterm style selection\&. 304gives xterm style selection\&.
309.IP "\fBscrollstyle:\fP \fImode\fP" 305.IP "\fBscrollstyle:\fP \fImode\fP"
418\fBTrue\fP: blank the pointer when a key is pressed or after a set number 414\fBTrue\fP: blank the pointer when a key is pressed or after a set number
419of seconds of inactivity\&. 415of seconds of inactivity\&.
420\fBFalse\fP: the pointer is always visible [default]\&. 416\fBFalse\fP: the pointer is always visible [default]\&.
421.IP "\fBpointerBlankDelay:\fP \fInumber\fP" 417.IP "\fBpointerBlankDelay:\fP \fInumber\fP"
422Specifies number of seconds before blanking the pointer [default 2]\&. 418Specifies 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" 419.IP "\fBbackspacekey:\fP \fIstring\fP"
430The string to send when the backspace key is pressed\&. If set to 420The 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, 421\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 422\fBBackspace\fP (code 8) - which can be reversed with the appropriate
433DEC private mode escape sequence\&. 423DEC private mode escape sequence\&.
450The locale to use for opening the IM\&. You can use an LC_CTYPE 440The 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 441of 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 442for the input extension to be able to input japanese characters
453while staying in another locale\&. 443while staying in another locale\&.
454option \fB-imlocale\fP\&. 444option \fB-imlocale\fP\&.
445.IP "\fBinsecure\fP"
446Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences
447that echo arbitrary strings like the icon name or the locale\&. This
448could be abused if somebody gets 8-bit-clean access to your
449display, wether throuh a mail client displaying mail bodies
450unfiltered or though write(1)\&. Therefore, these sequences are
451disabled by default\&. (Note that other terminals, including xterm,
452have these sequences enabled by default)\&. You can enable them
453by setting this boolean resource or specifying \fB-insecure\fP as
454an option\&. At the moment, this enabled display-answer, locale,
455findfont, icon label and window title requests as well as dynamic
456menubar dispatch\&.
455.IP "\fBmodifier:\fP \fImodifier\fP" 457.IP "\fBmodifier:\fP \fImodifier\fP"
456Set the key to be interpreted as the Meta key to: 458Set 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, 459\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
458\fBmod4\fP, \fBmod5\fP; 460\fBmod4\fP, \fBmod5\fP;
459option \fB-mod\fP\&. 461option \fB-mod\fP\&.
460.IP "\fBanswerbackString:\fP \fIstring\fP" 462.IP "\fBanswerbackString:\fP \fIstring\fP"
461Specify the reply rxvt sends to the shell when an ENQ (control-E) 463Specify the reply rxvt sends to the shell when an ENQ (control-E)
462character is passed through\&. It may contain escape values as 464character is passed through\&. It may contain escape values as
463described in the entry on \fBkeysym\fP following\&. 465described in the entry on \fBkeysym\fP following\&.
466.IP "\fBsecondaryScreen:\fP \fIbool\fP"
467Turn on/off secondary screen (default enabled)\&.
468.IP "\fBsecondaryScroll:\fP \fIbool\fP"
469Turn on/off secondary screen scroll (default enabled)\&. If
470the this option is enabled, scrolls on the secondary screen will
471change the scrollback buffer and switching to/from the secondary screen
472will instead scroll the screen up\&.
464.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" 473.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP"
465Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It 474Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It
466may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, 475may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape,
467\en: newline, \er: return, \et: tab, \e000: octal number) or control 476\en: newline, \er: return, \et: tab, \e000: octal number) or control
468characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with 477characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with
517.PP 526.PP
518\fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be 527\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 528seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this
520feature, \fBrxvt\fP must be installed setuid root on some systems\&. 529feature, \fBrxvt\fP must be installed setuid root on some systems\&.
521.SH "COLORS AND GRAPHICS" 530.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 531.PP
527In addition to the default foreground and background colours, \fBrxvt\fP 532In addition to the default foreground and background colours, \fBrxvt\fP
528can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink 533can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
529versions of the same)\&. 534versions of the same)\&.
530Here is a list of the colours with their \fBrgb\&.txt\fP names\&. 535Here is a list of the colours with their \fBrgb\&.txt\fP names\&.
1041.PP 1046.PP
1042Cursor change support is not yet implemented\&. 1047Cursor change support is not yet implemented\&.
1043.PP 1048.PP
1044Click-and-drag doesn\&'t work with X11 mouse report overriding\&. 1049Click-and-drag doesn\&'t work with X11 mouse report overriding\&.
1045.PP 1050.PP
1046Graphics support is fairly crude\&.
1047.PP
1048.SH "FTP LOCATION" 1051.SH "FTP LOCATION"
1049.PP 1052.PP
1050rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites 1053rxvt-2\&.6\&.tar\&.gz can be found at the following ftp sites
1051RXVTFTPSITE() 1054ftp://ftp\&.rxvt\&.org/pub/rxvt
1052.PP 1055.PP
1053.SH "CURRENT PROJECT COORDINATOR" 1056.SH "CURRENT PROJECT COORDINATOR"
1054.PP 1057.PP
1055.IP "Project Coordinator" 1058.IP "Project Coordinator"
1056RXVTMAINT() RXVTMAINTEMAIL() 1059Marc A\&. Lehmann <rxvt@schmorp\&.de>
1057.br 1060.br
1058.IP "Web page maintainter" 1061.IP "Web page maintainter"
1059RXVTWEBMAINT() RXVTWEBMAINTEMAIL() 1062Marc A\&. Lehmann <rxvt@schmorp\&.de>
1060.br 1063.br
1061RXVTWEBPAGE() 1064<http://www\&.sourceforge\&.net/projects/rxvt-unicode/>
1062.br 1065.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 1066.PP
1072.SH "AUTHORS" 1067.SH "AUTHORS"
1073.PP 1068.PP
1074.IP "John Bovey" 1069.IP "John Bovey"
1075University of Kent, 1992, wrote the original Xvt\&. 1070University of Kent, 1992, wrote the original Xvt\&.
1076.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" 1071.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>"
1077very heavily modified Xvt and came up with Rxvt 1072very heavily modified Xvt and came up with Rxvt
1078.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" 1073.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>"
1079wrote the Greek Keyboard Input 1074wrote the Greek Keyboard Input (no longer in code)
1080.IP "mj olesen <olesen@me\&.QueensU\&.CA>" 1075.IP "mj olesen <olesen@me\&.QueensU\&.CA>"
1081Wrote the menu system\&. 1076Wrote the menu system\&.
1082.br 1077.br
1083Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) 1078Project Coordinator (changes\&.txt 2\&.11 to 2\&.21)
1084.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" 1079.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
1085Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) 1080Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
1086.IP "Geoff Wing <gcw@pobox\&.com>" 1081.IP "Geoff Wing <gcw@pobox\&.com>"
1087Rewrote screen display and text selection routines\&. 1082Rewrote screen display and text selection routines\&.
1083Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
1084.IP "Marc Alexander Lehman <rxvt@schmorp\&.de>"
1085Rewrote most of the display code and internal character handling
1086to store text in unicode\&. Numerous other fixes and extensions\&.
1088.br 1087.br
1089Project Coordinator (changes\&.txt 2\&.4\&.6 - ) 1088Project Coordinator (Changes 1\&.0 - )
1089.PP

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines