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.7 by pcg, Mon Mar 29 16:52:06 2004 UTC vs.
Revision 1.17 by root, Fri Jul 30 19:51:49 2004 UTC

1.TH "RXVT" "1" "2004-03-28" "X Version 11" "X Tools" 1.TH "RXVT" "1" "2004-07-26" "X Version 11" "X Tools"
2.SH "NAME" 2.SH "NAME"
3rxvt-unicode (ouR XVT, unicode) \- 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-unicode\fP, version \fB2\&.5\fP, is a colour vt102 terminal emulator 11\fBrxvt-unicode\fP, version \fB3\&.3\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-unicode\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
… …
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-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\&.
56.IP "\fB-bg\fP \fIcolour\fP" 61.IP "\fB-bg\fP \fIcolour\fP"
57Window background colour; 62Window background colour;
58resource \fBbackground\fP\&. 63resource \fBbackground\fP\&.
59.IP "\fB-fg\fP \fIcolour\fP" 64.IP "\fB-fg\fP \fIcolour\fP"
60Window foreground colour; 65Window foreground colour;
… …
67resource \fBbackgroundPixmap\fP\&. 72resource \fBbackgroundPixmap\fP\&.
68.IP "\fB-cr\fP \fIcolour\fP" 73.IP "\fB-cr\fP \fIcolour\fP"
69The cursor colour; 74The cursor colour;
70resource \fBcursorColor\fP\&. 75resource \fBcursorColor\fP\&.
71.IP "\fB-pr\fP \fIcolour\fP" 76.IP "\fB-pr\fP \fIcolour\fP"
72The mouse pointer colour; 77The mouse pointer foreground colour;
73resource \fBpointerColor\fP\&. 78resource \fBpointerColor\fP\&.
79.IP "\fB-pr2\fP \fIcolour\fP"
80The mouse pointer background colour;
81resource \fBpointerColor2\fP\&.
74.IP "\fB-bd\fP \fIcolour\fP" 82.IP "\fB-bd\fP \fIcolour\fP"
75The colour of the border between the xterm scrollbar and the text; 83The colour of the border between the xterm scrollbar and the text;
76resource \fBborderColor\fP\&. 84resource \fBborderColor\fP\&.
77.IP "\fB-fn\fP \fIfontname\fP" 85.IP "\fB-fn\fP \fIfontname\fP"
78Select the fonts to be used used\&. This is a comma seperated 86Select the fonts to be used\&.
79list of font names that are used in turn when trying to display 87This 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, 88trying to display Unicode characters\&.
81other fonts might be smaller, but not larger\&. A reasonable default font list 89The first font defines the cell size for characters; other fonts might
82is always appended to it\&. 90be smaller, but not larger\&.
91A reasonable default font list is always appended to it\&.
83resource \fBfont\fP\&. 92resource \fBfont\fP\&.
93.IP "\fB-rb\fP|\fB+rb\fP"
94Enable "real bold" support\&.
95When this option is on, bold text will be displayed using the first
96available bold font in the font list\&.
97Bold fonts should thus be specified in the font list after their
98corresponding regular fonts\&.
99If no bold font can be found, a regular font will be used\&.
100resource \fBrealBold\fP\&.
84.IP "\fB-name\fP \fIname\fP" 101.IP "\fB-name\fP \fIname\fP"
85Specify the application name under which resources 102Specify the application name under which resources
86are to be obtained, rather than the default executable file name\&. 103are to be obtained, rather than the default executable file name\&.
87Name should not contain `\&.\&' or `*\&' characters\&. 104Name should not contain `\&.\&' or `*\&' characters\&.
88Also sets the icon and title name\&. 105Also sets the icon and title name\&.
… …
178.IP "\fB-mod\fP \fImodifier\fP" 195.IP "\fB-mod\fP \fImodifier\fP"
179Override detection of Meta modifier with specified key: 196Override detection of Meta modifier with specified key:
180\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 197\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
181\fBmod4\fP, \fBmod5\fP; 198\fBmod4\fP, \fBmod5\fP;
182resource \fImodifier\fP\&. 199resource \fImodifier\fP\&.
200.IP "\fB-ssc\fP|\fB+ssc\fP"
201Turn on/off secondary screen (default enabled);
202resource \fBsecondaryScreen\fP\&.
203.IP "\fB-ssr\fP|\fB+ssr\fP"
204Turn on/off secondary screen scroll (default enabled);
205resource \fBsecondaryScroll\fP\&.
183.IP "\fB-xrm\fP \fIresourcestring\fP" 206.IP "\fB-xrm\fP \fIresourcestring\fP"
184No effect on rxvt\&. Simply passes through an argument to be made 207No effect on rxvt\&. Simply passes through an argument to be made
185available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP 208available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP
186in some window managers\&. 209in some window managers\&.
187.SH "RESOURCES (available also as long-options)" 210.SH "RESOURCES (available also as long-options)"
… …
223but the actual colour names used are listed in the 246but the actual colour names used are listed in the
224\fBCOLORS AND GRAPHICS\fP section\&. 247\fBCOLORS AND GRAPHICS\fP section\&.
225.IP "\fBcolorBD:\fP \fIcolour\fP" 248.IP "\fBcolorBD:\fP \fIcolour\fP"
226Use the specified colour to display bold characters when the 249Use the specified colour to display bold characters when the
227foreground colour is the default\&. 250foreground colour is the default\&.
251This option will be ignored if \fBrealBold\fP is enabled\&.
228.IP "\fBcolorUL:\fP \fIcolour\fP" 252.IP "\fBcolorUL:\fP \fIcolour\fP"
229Use the specified colour to display underlined characters when the 253Use the specified colour to display underlined characters when the
230foreground colour is the default\&. 254foreground colour is the default\&.
231.IP "\fBcolorRV:\fP \fIcolour\fP" 255.IP "\fBcolorRV:\fP \fIcolour\fP"
232Use the specified colour as the background for reverse video 256Use the specified colour as the background for reverse video
… …
253option \fB+j\fP\&. 277option \fB+j\fP\&.
254.IP "\fBinheritPixmap:\fP \fIboolean\fP" 278.IP "\fBinheritPixmap:\fP \fIboolean\fP"
255\fBTrue\fP: make the background inherit the parent windows\&' pixmap, 279\fBTrue\fP: make the background inherit the parent windows\&' pixmap,
256giving artificial transparency\&. 280giving artificial transparency\&.
257\fBFalse\fP: do not inherit the parent windows\&' pixmap\&. 281\fBFalse\fP: do not inherit the parent windows\&' pixmap\&.
282.IP "\fBtintColor:\fP \fIcolour\fP"
283Tint the transparent background pixmap with the given colour\&.
258.IP "\fBscrollColor:\fP \fIcolour\fP" 284.IP "\fBscrollColor:\fP \fIcolour\fP"
259Use the specified colour for the scrollbar [default #B2B2B2]\&. 285Use the specified colour for the scrollbar [default #B2B2B2]\&.
260.IP "\fBtroughColor:\fP \fIcolour\fP" 286.IP "\fBtroughColor:\fP \fIcolour\fP"
261Use the specified colour for the scrollbar\&'s trough area [default 287Use the specified colour for the scrollbar\&'s trough area [default
262#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. 288#969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&.
… …
277.IP "\fBpath:\fP \fIpath\fP" 303.IP "\fBpath:\fP \fIpath\fP"
278Specify the colon-delimited search path for finding files (XPM and 304Specify the colon-delimited search path for finding files (XPM and
279menus), in addition to the paths specified by the \fBRXVTPATH\fP and 305menus), in addition to the paths specified by the \fBRXVTPATH\fP and
280\fBPATH\fP environment variables\&. 306\fBPATH\fP environment variables\&.
281.IP "\fBfont:\fP \fIfontname\fP" 307.IP "\fBfont:\fP \fIfontname\fP"
282Select the fonts to be used used\&. This is a comma seperated 308Select the fonts to be used\&.
283list of font names that are used in turn when trying to display 309This 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, 310trying to display Unicode characters\&.
285other fonts might be smaller, but not larger\&. A reasonable default font list 311The first font defines the cell size for characters; other fonts might
286is always appended to this list\&. 312be smaller, but not larger\&.
313A reasonable default font list is always appended to it\&.
287option \fB-fn\fP\&. 314option \fB-fn\fP\&.
315.IP "\fBrealBold:\fP \fIboolean\fP"
316\fBTrue\fP: Enable "real bold" support\&.
317When this option is on, bold text will be displayed using the first
318available bold font in the font list\&.
319Bold fonts should thus be specified in the font list after their
320corresponding regular fonts\&.
321If no bold font can be found, a regular font will be used\&.
322option \fB-rb\fP\&.
323\fBFalse\fP: Display bold text in a regular font, using the color
324specified with \fBcolorBD\fP;
325option \fB+rb\fP\&.
288.IP "\fBselectstyle:\fP \fImode\fP" 326.IP "\fBselectstyle:\fP \fImode\fP"
289Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which 327Set 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 328is xterm style with 2\&.20 old word selection, or anything else which
291gives xterm style selection\&. 329gives xterm style selection\&.
292.IP "\fBscrollstyle:\fP \fImode\fP" 330.IP "\fBscrollstyle:\fP \fImode\fP"
293Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP 331Set scrollbar style to \fBrxvt\fP, \fBrxvt\fP, \fBplain\fP, \fBnext\fP or \fBxterm\fP
294.IP "\fBtitle:\fP \fIstring\fP" 332.IP "\fBtitle:\fP \fIstring\fP"
295Set window title string, the default title is the command-line 333Set window title string, the default title is the command-line
296specified after the \fB-e\fP option, if any, otherwise the application 334specified after the \fB-e\fP option, if any, otherwise the application
297name; 335name;
298option \fB-title\fP\&. 336option \fB-title\fP\&.
… …
399option \fB-bc\fP\&. 437option \fB-bc\fP\&.
400.IP "\fBpointerBlank:\fP \fIboolean\fP" 438.IP "\fBpointerBlank:\fP \fIboolean\fP"
401\fBTrue\fP: blank the pointer when a key is pressed or after a set number 439\fBTrue\fP: blank the pointer when a key is pressed or after a set number
402of seconds of inactivity\&. 440of seconds of inactivity\&.
403\fBFalse\fP: the pointer is always visible [default]\&. 441\fBFalse\fP: the pointer is always visible [default]\&.
442.IP "\fBpointerColor:\fP \fIcolour\fP"
443Mouse pointer foreground colour\&.
444.IP "\fBpointerColor2:\fP \fIcolour\fP"
445Mouse pointer background colour\&.
404.IP "\fBpointerBlankDelay:\fP \fInumber\fP" 446.IP "\fBpointerBlankDelay:\fP \fInumber\fP"
405Specifies number of seconds before blanking the pointer [default 2]\&. 447Specifies number of seconds before blanking the pointer [default 2]\&.
406.IP "\fBbackspacekey:\fP \fIstring\fP" 448.IP "\fBbackspacekey:\fP \fIstring\fP"
407The string to send when the backspace key is pressed\&. If set to 449The string to send when the backspace key is pressed\&. If set to
408\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, 450\fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted,
… …
430while staying in another locale\&. 472while staying in another locale\&.
431option \fB-imlocale\fP\&. 473option \fB-imlocale\fP\&.
432.IP "\fBinsecure\fP" 474.IP "\fBinsecure\fP"
433Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences 475Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences
434that echo arbitrary strings like the icon name or the locale\&. This 476that echo arbitrary strings like the icon name or the locale\&. This
435could be abused if somebody gets 8-bit-clean access to your display, 477could be abused if somebody gets 8-bit-clean access to your
436wether throuh a mail client displaying mail bodies unfiltered or 478display, wether throuh a mail client displaying mail bodies
437though write(1)\&. Therefore, these sequences are disabled by default\&. 479unfiltered or though write(1)\&. Therefore, these sequences are
438You can enable them by setting this boolean resource or specifying 480disabled by default\&. (Note that other terminals, including xterm,
481have these sequences enabled by default)\&. You can enable them
482by setting this boolean resource or specifying \fB-insecure\fP as
439\fB-insecure\fP as an option\&. At the moment, this enabled display-answer, 483an option\&. At the moment, this enabled display-answer, locale,
440locale, findfont, icon label and window title requests as well as 484findfont, icon label and window title requests as well as dynamic
441dynamic menubar dispatch\&. 485menubar dispatch\&.
442.IP "\fBmodifier:\fP \fImodifier\fP" 486.IP "\fBmodifier:\fP \fImodifier\fP"
443Set the key to be interpreted as the Meta key to: 487Set the key to be interpreted as the Meta key to:
444\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, 488\fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP,
445\fBmod4\fP, \fBmod5\fP; 489\fBmod4\fP, \fBmod5\fP;
446option \fB-mod\fP\&. 490option \fB-mod\fP\&.
447.IP "\fBanswerbackString:\fP \fIstring\fP" 491.IP "\fBanswerbackString:\fP \fIstring\fP"
448Specify the reply rxvt sends to the shell when an ENQ (control-E) 492Specify the reply rxvt sends to the shell when an ENQ (control-E)
449character is passed through\&. It may contain escape values as 493character is passed through\&. It may contain escape values as
450described in the entry on \fBkeysym\fP following\&. 494described in the entry on \fBkeysym\fP following\&.
495.IP "\fBsecondaryScreen:\fP \fIbool\fP"
496Turn on/off secondary screen (default enabled)\&.
497.IP "\fBsecondaryScroll:\fP \fIbool\fP"
498Turn on/off secondary screen scroll (default enabled)\&. If
499the this option is enabled, scrolls on the secondary screen will
500change the scrollback buffer and switching to/from the secondary screen
501will instead scroll the screen up\&.
451.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" 502.IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP"
452Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It 503Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It
453may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, 504may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape,
454\en: newline, \er: return, \et: tab, \e000: octal number) or control 505\en: newline, \er: return, \et: tab, \e000: octal number) or control
455characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with 506characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with
… …
579.PP 630.PP
580Click-and-drag doesn\&'t work with X11 mouse report overriding\&. 631Click-and-drag doesn\&'t work with X11 mouse report overriding\&.
581.PP 632.PP
582.SH "FTP LOCATION" 633.SH "FTP LOCATION"
583.PP 634.PP
584rxvt-2\&.5\&.tar\&.gz can be found at the following ftp sites 635rxvt-3\&.3\&.tar\&.gz can be found at the following ftp sites
585ftp://ftp\&.rxvt\&.org/pub/rxvt 636ftp://ftp\&.rxvt\&.org/pub/rxvt
586.PP 637.PP
587.SH "CURRENT PROJECT COORDINATOR" 638.SH "CURRENT PROJECT COORDINATOR"
588.PP 639.PP
589.IP "Project Coordinator" 640.IP "Project Coordinator"
… …
610.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" 661.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
611Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) 662Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
612.IP "Geoff Wing <gcw@pobox\&.com>" 663.IP "Geoff Wing <gcw@pobox\&.com>"
613Rewrote screen display and text selection routines\&. 664Rewrote screen display and text selection routines\&.
614Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) 665Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
615.IP "Marc Alexander Lehman <rxvt@schmorp\&.de>" 666.IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>"
616Rewrote most of the display code and internal character handling 667Forked rxvt-unicode, rewrote most of the display code and
617to store text in unicode\&. Numerous other fixes and extensions\&. 668internal character handling to store text in unicode,
669improve xterm compatibility and apply numerous other bugfixes
670and extensions\&.
618.br 671.br
619Project Coordinator (Changes 1\&.0 - ) 672Project Coordinator (Changes 1\&.0 - )
620.PP 673.PP

Diff Legend

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