.if !\n(.g .ab GNU tbl requires GNU troff. .if !dTS .ds TS .if !dTE .ds TE .TH "RXVT" "1" "2004-03-14" "X Version 11" "X Tools" .SH "NAME" rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system .PP .SH "SYNOPSIS" .PP \fBrxvt\fP [options] [-e command [ args ]] .PP .SH "DESCRIPTION" .PP \fBrxvt-unicode\fP, version \fB2\&.4\fP, is a colour vt102 terminal emulator intended as an \fIxterm\fP(1) replacement for users who do not require features such as Tektronix 4014 emulation and toolkit-style configurability\&. As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant advantage on a machine serving many X sessions\&. .PP .PP .SH "OPTIONS" .PP The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. In keeping with the smaller-is-better philosophy, options may be eliminated or default values chosen at compile-time, so options and defaults listed may not accurately reflect the version installed on your system\&. `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. Option descriptions may be prefixed with which compile option each is dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled into your version\&. .PP Note that \fBrxvt\fP permits the resource name to be used as a long-option (--/++ option) so the potential command-line options are far greater than those listed\&. For example: `rxvt --loginShell --color1 Orange\&'\&. .PP The following options are available: .PP .IP "\fB-help\fP, \fB--help\fP" Print out a message describing available options\&. .IP "\fB-display\fP \fIdisplayname\fP" Attempt to open a window on the named X display (\fB-d\fP still respected)\&. In the absence of this option, the display specified by the \fBDISPLAY\fP environment variable is used\&. .IP "\fB-geometry\fP \fIgeom\fP" Window geometry (\fB-g\fP still respected); resource \fBgeometry\fP\&. .IP "\fB-rv\fP|\fB+rv\fP" Turn on/off simulated reverse video; resource \fBreverseVideo\fP\&. .IP "\fB-j\fP|\fB+j\fP" Turn on/off jump scrolling; resource \fBjumpScroll\fP\&. .IP "\fB-ip\fP|\fB+ip\fP" Turn on/off inheriting parent window\&'s pixmap\&. Alternative form is \fB-tr\fP; resource \fBinheritPixmap\fP\&. .IP "\fB-bg\fP \fIcolour\fP" Window background colour; resource \fBbackground\fP\&. .IP "\fB-fg\fP \fIcolour\fP" Window foreground colour; resource \fBforeground\fP\&. .IP "\fB-pixmap:\fP \fIfile[;geom]\fP" Compile \fIXPM\fP: Specify XPM file for the background and also optionally specify its scaling with a geometry string\&. Note you may need to add quotes to avoid special shell interpretation of the `;\&' in the command-line; resource \fBbackgroundPixmap\fP\&. .IP "\fB-cr\fP \fIcolour\fP" The cursor colour; resource \fBcursorColor\fP\&. .IP "\fB-pr\fP \fIcolour\fP" The mouse pointer colour; resource \fBpointerColor\fP\&. .IP "\fB-bd\fP \fIcolour\fP" The colour of the border between the xterm scrollbar and the text; resource \fBborderColor\fP\&. .IP "\fB-fn\fP \fIfontname\fP" Select the fonts to be used used\&. This is a comma seperated list of font names that are used in turn when trying to display unicode characters\&. The first font defines the cell size for characters, pther fonts might be smaller, but not larger\&. A reasonable default list is appended\&. resource \fBfont\fP\&. .IP "\fB-name\fP \fIname\fP" Specify the application name under which resources are to be obtained, rather than the default executable file name\&. Name should not contain `\&.\&' or `*\&' characters\&. Also sets the icon and title name\&. .IP "\fB-ls\fP|\fB+ls\fP" Start as a login-shell/sub-shell; resource \fBloginShell\fP\&. .IP "\fB-ut\fP|\fB+ut\fP" Compile \fIutmp\fP: Inhibit/enable writing a utmp entry; resource \fButmpInhibit\fP\&. .IP "\fB-vb\fP|\fB+vb\fP" Turn on/off visual bell on receipt of a bell character; resource \fBvisualBell\fP\&. .IP "\fB-sb\fP|\fB+sb\fP" Turn on/off scrollbar; resource \fBscrollBar\fP\&. .IP "\fB-si\fP|\fB+si\fP" Turn on/off scroll-to-bottom on TTY output inhibit; resource \fBscrollTtyOutput\fP has opposite effect\&. .IP "\fB-sk\fP|\fB+sk\fP" Turn on/off scroll-to-bottom on keypress; resource \fBscrollTtyKeypress\fP\&. .IP "\fB-sw\fP|\fB+sw\fP" Turn on/off scrolling with the scrollback buffer as new lines appear\&. This only takes effect if \fB-si\fP is also given; resource \fBscrollWithBuffer\fP\&. .IP "\fB-sr\fP|\fB+sr\fP" Put scrollbar on right/left; resource \fBscrollBar_right\fP\&. .IP "\fB-st\fP|\fB+st\fP" Display normal (non XTerm/NeXT) scrollbar without/with a trough; resource \fBscrollBar_floating\fP\&. .IP "\fB-bc\fP|\fB+bc\fP" Blink the cursor; resource \fBcursorBlink\fP\&. .IP "\fB-iconic\fP" Start iconified, if the window manager supports that option\&. Alternative form is \fB-ic\fP\&. .IP "\fB-sl\fP \fInumber\fP" Save \fInumber\fP lines in the scrollback buffer\&. See resource entry for limits; resource \fBsaveLines\fP\&. .IP "\fB-b\fP \fInumber\fP" Compile \fIfrills\fP: Internal border of \fInumber\fP pixels\&. See resource entry for limits; resource \fBinternalBorder\fP\&. .IP "\fB-w\fP \fInumber\fP" Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits; resource \fBexternalBorder\fP\&. .IP "\fB-lsp\fP \fInumber\fP" Compile \fIlinespace\fP: Lines (pixel height) to insert between each row of the display; resource \fBlinespace\fP\&. .IP "\fB-tn\fP \fItermname\fP" This option specifies the name of the terminal type to be set in the \fBTERM\fP environment variable\&. This terminal type must exist in the \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; resource \fBtermName\fP\&. .IP "\fB-e\fP \fIcommand [arguments]\fP" Run the command with its command-line arguments in the \fBrxvt\fP window; also sets the window title and icon name to be the basename of the program being executed if neither \fI-title\fP (\fI-T\fP) nor \fI-n\fP are given on the command line\&. If this option is used, it must be the last on the command-line\&. If there is no \fB-e\fP option then the default is to run the program specified by the \fBSHELL\fP environment variable or, failing that, \fIsh(1)\fP\&. .IP "\fB-title\fP \fItext\fP" Window title (\fB-T\fP still respected); the default title is the basename of the program specified after the \fB-e\fP option, if any, otherwise the application name; resource \fBtitle\fP\&. .IP "\fB-n\fP \fItext\fP" Icon name; the default name is the basename of the program specified after the \fB-e\fP option, if any, otherwise the application name; resource \fBiconName\fP\&. .IP "\fB-C\fP" Capture system console messages\&. .IP "\fB-pt\fP \fIstyle\fP" Compile \fIXIM\fP: input style for input method; \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; resource \fBpreeditType\fP\&. .IP "\fB-im\fP \fItext\fP" Compile \fIXIM\fP: input method name\&. resource \fBinputMethod\fP\&. .IP "\fB-imlocale\fP \fIstring\fP" The locale to use for opening the IM\&. You can use an LC_CTYPE of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP for the input extension to be able to input japanese characters while staying in another locale\&. .IP "\fB-mod\fP \fImodifier\fP" Override detection of Meta modifier with specified key: \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, \fBmod4\fP, \fBmod5\fP; resource \fImodifier\fP\&. .IP "\fB-xrm\fP \fIresourcestring\fP" No effect on rxvt\&. Simply passes through an argument to be made available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP in some window managers\&. .SH "RESOURCES (available also as long-options)" .PP Note: `rxvt --help\&' gives a list of all resources (long options) compiled into your version\&. If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in XAPPLOADDIR/Rxvt (compile-time defined: usually \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and key-handling, to be shared between different \fBrxvt\fP configurations\&. If no resources are specified, suitable defaults will be used\&. Command-line arguments can be used to override resource settings\&. The following resources are allowed: .PP .IP "\fBgeometry:\fP \fIgeom\fP" Create the window with the specified X window geometry [default 80x24]; option \fB-geometry\fP\&. .IP "\fBbackground:\fP \fIcolour\fP" Use the specified colour as the window\&'s background colour [default White]; option \fB-bg\fP\&. .IP "\fBforeground:\fP \fIcolour\fP" Use the specified colour as the window\&'s foreground colour [default Black]; option \fB-fg\fP\&. .IP "\fBcolor\fP\fIn\fP\fB:\fP \fIcolour\fP" Use the specified colour for the colour value \fIn\fP, where 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity (bold = bright foreground, blink = bright background) colours\&. The canonical names are as follows: 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour names used are listed in the \fBCOLORS AND GRAPHICS\fP section\&. .IP "\fBcolorBD:\fP \fIcolour\fP" Use the specified colour to display bold characters when the foreground colour is the default\&. .IP "\fBcolorUL:\fP \fIcolour\fP" Use the specified colour to display underlined characters when the foreground colour is the default\&. .IP "\fBcolorRV:\fP \fIcolour\fP" Use the specified colour as the background for reverse video characters\&. .IP "\fBcursorColor:\fP \fIcolour\fP" Use the specified colour for the cursor\&. The default is to use the foreground colour; option \fB-cr\fP\&. .IP "\fBcursorColor2:\fP \fIcolour\fP" Use the specified colour for the colour of the cursor text\&. For this to take effect, \fBcursorColor\fP must also be specified\&. The default is to use the background colour\&. .IP "\fBreverseVideo:\fP \fIboolean\fP" \fBTrue\fP: simulate reverse video by foreground and background colours; option \fB-rv\fP\&. \fBFalse\fP: regular screen colours [default]; option \fB+rv\fP\&. See note in \fBCOLORS AND GRAPHICS\fP section\&. .IP "\fBjumpScroll:\fP \fIboolean\fP" \fBTrue\fP: specify that jump scrolling should be used\&. When scrolling quickly, fewer screen updates are performed [default]; option \fB-j\fP\&. \fBFalse\fP: specify that smooth scrolling should be used; option \fB+j\fP\&. .IP "\fBinheritPixmap:\fP \fIboolean\fP" \fBTrue\fP: make the background inherit the parent windows\&' pixmap, giving artificial transparency\&. \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. .IP "\fBscrollColor:\fP \fIcolour\fP" Use the specified colour for the scrollbar [default #B2B2B2]\&. .IP "\fBtroughColor:\fP \fIcolour\fP" Use the specified colour for the scrollbar\&'s trough area [default #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. .IP "\fBbackgroundPixmap:\fP \fIfile[;geom]\fP" Use the specified XPM file (note the `\&.xpm\&' extension is optional) for the background and also optionally specify its scaling with a geometry string \fBWxH+X+Y\fP, in which \fB"W" / "H"\fP specify the horizontal/vertical scale (percent) and \fB"X" / "Y"\fP locate the image centre (percent)\&. A scale of 0 displays the image with tiling\&. A scale of 1 displays the image without any scaling\&. A scale of 2 to 9 specifies an integer number of images in that direction\&. No image will be magnified beyond 10 times its original size\&. The maximum permitted scale is 1000\&. [default 0x0+50+50] .IP "\fBmenu:\fP \fIfile[;tag]\fP" Read in the specified menu file (note the `\&.menu\&' extension is optional) and also optionally specify a starting tag to find\&. See the reference documentation for details on the syntax for the menuBar\&. .IP "\fBpath:\fP \fIpath\fP" Specify the colon-delimited search path for finding files (XPM and menus), in addition to the paths specified by the \fBRXVTPATH\fP and \fBPATH\fP environment variables\&. .IP "\fBfont:\fP \fIfontname\fP" Select the fonts to be used used\&. This is a comma seperated list of font names that are used in turn when trying to display unicode characters\&. The first font defines the cell size for characters, pther fonts might be smaller, but not larger\&. A reasonable default list is appended\&. option \fB-fn\fP\&. .IP "\fBselectstyle:\fP \fImode\fP" Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which is xterm style with 2\&.20 old word selection, or anything else which gives xterm style selection\&. .IP "\fBscrollstyle:\fP \fImode\fP" Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP .IP "\fBtitle:\fP \fIstring\fP" Set window title string, the default title is the command-line specified after the \fB-e\fP option, if any, otherwise the application name; option \fB-title\fP\&. .IP "\fBiconName:\fP \fIstring\fP" Set the name used to label the window\&'s icon or displayed in an icon manager window, it also sets the window\&'s title unless it is explicitly set; option \fB-n\fP\&. .IP "\fBmapAlert:\fP \fIboolean\fP" \fBTrue\fP: de-iconify (map) on receipt of a bell character\&. \fBFalse\fP: no de-iconify (map) on receipt of a bell character [default]\&. .IP "\fBvisualBell:\fP \fIboolean\fP" \fBTrue\fP: use visual bell on receipt of a bell character; option \fB-vb\fP\&. \fBFalse\fP: no visual bell [default]; option \fB+vb\fP\&. .IP "\fBloginShell:\fP \fIboolean\fP" \fBTrue\fP: start as a login shell by prepending a `-\&' to \fBargv[0]\fP of the shell; option \fB-ls\fP\&. \fBFalse\fP: start as a normal sub-shell [default]; option \fB+ls\fP\&. .IP "\fButmpInhibit:\fP \fIboolean\fP" \fBTrue\fP: inhibit writing record into the system log file \fButmp\fP; option \fB-ut\fP\&. \fBFalse\fP: write record into the system log file \fButmp\fP [default]; option \fB+ut\fP\&. .IP "\fBprint-pipe:\fP \fIstring\fP" Specify a command pipe for vt100 printer [default \fIlpr(1)\fP]\&. Use \fBPrint\fP to initiate a screen dump to the printer and \fBCtrl-Print\fP or \fBShift-Print\fP to include the scrollback as well\&. .IP "\fBscrollBar:\fP \fIboolean\fP" \fBTrue\fP: enable the scrollbar [default]; option \fB-sb\fP\&. \fBFalse\fP: disable the scrollbar; option \fB+sb\fP\&. .IP "\fBscrollBar_right:\fP \fIboolean\fP" \fBTrue\fP: place the scrollbar on the right of the window; option \fB-sr\fP\&. \fBFalse\fP: place the scrollbar on the left of the window; option \fB+sr\fP\&. .IP "\fBscrollBar_floating:\fP \fIboolean\fP" \fBTrue\fP: display an rxvt scrollbar without a trough; option \fB-st\fP\&. \fBFalse\fP: display an rxvt scrollbar with a trough; option \fB+st\fP\&. .IP "\fBscrollBar_align:\fP \fImode\fP" Align the \fBtop\fP, \fBbottom\fP or \fBcentre\fP [default] of the scrollbar thumb with the pointer on middle button press/drag\&. .IP "\fBscrollTtyOutput:\fP \fIboolean\fP" \fBTrue\fP: scroll to bottom when tty receives output; option(+si)\&. \fBFalse\fP: do not scroll to bottom when tty receives output; option(-si)\&. .IP "\fBscrollWithBuffer:\fP \fIboolean\fP" \fBTrue\fP: scroll with scrollback buffer when tty recieves new lines (and \fBscrollTtyOutput\fP is False); option(+sw)\&. \fBFalse\fP: do not scroll with scrollback buffer when tty recieves new lines; option(-sw)\&. .IP "\fBscrollTtyKeypress:\fP \fIboolean\fP" \fBTrue\fP: scroll to bottom when a non-special key is pressed\&. Special keys are those which are intercepted by rxvt for special handling and are not passed onto the shell; option(-sk)\&. \fBFalse\fP: do not scroll to bottom when a non-special key is pressed; option(+sk)\&. .IP "\fBsmallfont_key:\fP \fIkeysym\fP" If enabled, use \fBAlt-\fP\fIkeysym\fP to toggle to a smaller font [default \fBAlt-<\fP] .IP "\fBbigfont_key:\fP \fIkeysym\fP" If enabled, use \fBAlt-\fP\fIkeysym\fP to toggle to a bigger font [default \fBAlt->\fP] .IP "\fBsaveLines:\fP \fInumber\fP" Save \fInumber\fP lines in the scrollback buffer [default 64]\&. This resource is limited on most machines to 65535; option \fB-sl\fP\&. .IP "\fBinternalBorder:\fP \fInumber\fP" Internal border of \fInumber\fP pixels\&. This resource is limited to 100; option \fB-b\fP\&. .IP "\fBexternalBorder:\fP \fInumber\fP" External border of \fInumber\fP pixels\&. This resource is limited to 100; option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&. .IP "\fBtermName:\fP \fItermname\fP" Specifies the terminal type name to be set in the \fBTERM\fP environment variable; option \fB-tn\fP\&. .IP "\fBlinespace:\fP \fInumber\fP" Specifies number of lines (pixel height) to insert between each row of the display [default 0]; option \fB-lsp\fP\&. .IP "\fBmeta8:\fP \fIboolean\fP" \fBTrue\fP: handle Meta (Alt) + keypress to set the 8th bit\&. \fBFalse\fP: handle Meta (Alt) + keypress as an escape prefix [default]\&. .IP "\fBmouseWheelScrollPage:\fP \fIboolean\fP" \fBTrue\fP: the mouse wheel scrolls a page full\&. \fBFalse\fP: the mouse wheel scrolls five lines [default]\&. .IP "\fBcursorBlink:\fP \fIboolean\fP" \fBTrue\fP: blink the cursor\&. \fBFalse\fP: do not blink the cursor [default]; option \fB-bc\fP\&. .IP "\fBpointerBlank:\fP \fIboolean\fP" \fBTrue\fP: blank the pointer when a key is pressed or after a set number of seconds of inactivity\&. \fBFalse\fP: the pointer is always visible [default]\&. .IP "\fBpointerBlankDelay:\fP \fInumber\fP" Specifies number of seconds before blanking the pointer [default 2]\&. .IP "\fBbackspacekey:\fP \fIstring\fP" The string to send when the backspace key is pressed\&. If set to \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, \fBBackspace\fP (code 8) - which can be reversed with the appropriate DEC private mode escape sequence\&. .IP "\fBdeletekey:\fP \fIstring\fP" The string to send when the delete key (not the keypad delete key) is pressed\&. If unset it will send the sequence traditionally associated with the \fBExecute\fP key\&. .IP "\fBcutchars:\fP \fIstring\fP" The characters used as delimiters for double-click word selection\&. The built-in default: .br \fBBACKSLASH `"\&'&()*,;<=>?@[]{|}\fP .IP "\fBpreeditType:\fP \fIstyle\fP" \fBOverTheSpot\fP, \fBOffTheSpot\fP, \fBRoot\fP; option \fB-pt\fP\&. .IP "\fBinputMethod:\fP \fIname\fP" \fIname\fP of inputMethod to use; option \fB-im\fP\&. .IP "\fBimLocale:\fP \fIname\fP" The locale to use for opening the IM\&. You can use an LC_CTYPE of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP for the input extension to be able to input japanese characters while staying in another locale\&. option \fB-imlocale\fP\&. .IP "\fBmodifier:\fP \fImodifier\fP" Set the key to be interpreted as the Meta key to: \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, \fBmod4\fP, \fBmod5\fP; option \fB-mod\fP\&. .IP "\fBanswerbackString:\fP \fIstring\fP" Specify the reply rxvt sends to the shell when an ENQ (control-E) character is passed through\&. It may contain escape values as described in the entry on \fBkeysym\fP following\&. .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, \en: newline, \er: return, \et: tab, \e000: octal number) or control characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with double quotes so that it can start or end with whitespace\&. The intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This resource is only available when compiled with KEYSYM_RESOURCE\&. .SH "THE SCROLLBAR" .PP Lines of text that scroll off the top of the \fBrxvt\fP window (resource: \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour mimics that of \fIxterm\fP .PP Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. Continuous scroll with \fBButton2\fP\&. .SH "MOUSE REPORTING" .PP To temporarily override mouse reporting, for either the scrollbar or the normal text selection/insertion, hold either the Shift or the Meta (Alt) key while performing the desired mouse action\&. .PP If mouse reporting mode is active, the normal scrollbar actions are disabled -- on the assumption that we are using a fullscreen application\&. Instead, pressing Button1 and Button3 sends \fBESC[6~\fP (Next) and \fBESC[5~\fP (Prior), respectively\&. Similarly, clicking on the up and down arrows sends \fBESC[A\fP (Up) and \fBESC[B\fP (Down), respectively\&. .SH "TEXT SELECTION AND INSERTION" .PP The behaviour of text selection and insertion mechanism is similar to \fIxterm\fP(1)\&. .PP .IP "\fBSelection\fP:" Left click at the beginning of the region, drag to the end of the region and release; Right click to extend the marked region; Left double-click to select a word; Left triple-click to select the entire line\&. .IP "\fBInsertion\fP:" Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) in an \fBrxvt\fP window causes the current text selection to be inserted as if it had been typed on the keyboard\&. .SH "CHANGING FONTS" .PP You can change fonts on-the-fly, which is to say cycle through the default font and others of various sizes, by using \fBShift-KP_Add\fP and \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with \fBAlt->\fP and \fBAlt-<\fP, where the actual key can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. .SH "LOGIN STAMP" .PP \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this feature, \fBrxvt\fP must be installed setuid root on some systems\&. .SH "COLORS AND GRAPHICS" .PP In addition to the default foreground and background colours, \fBrxvt\fP can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink versions of the same)\&. Here is a list of the colours with their \fBrgb\&.txt\fP names\&. .PP .TS .nr 3c \n(.C .cp 0 .nr 3lps \n[.s] .nr 3cent \n[.ce] .de 3init .ft \n[.f] .ps \n[.s] .vs \n[.v]u .in \n[.i]u .ll \n[.l]u .ls \n[.L] .ad \n[.j] .ie \n[.u] .fi .el .nf .ce \n[.ce] .. .nr 3ind \n[.i] .nr 3fnt \n[.f] .nr 3sz \n[.s] .nr 3fll \n[.u] .nr T. 0 .nr 3crow 0-1 .nr 3passed 0-1 .nr 3sflag 0 .ds 3trans .ds 3quote .nr 3brule 1 .nr 3supbot 0 .eo .de 3rmk .mk \$1 .if !'\n(.z'' \!.3rmk "\$1" .. .de 3rvpt .vpt \$1 .if !'\n(.z'' \!.3rvpt "\$1" .. .de 3keep .if '\n[.z]'' \{.ds 3quote \\ .ds 3trans \! .di 3section .nr 3sflag 1 .in 0 .\} .. .de 3release .if \n[3sflag] \{.di .in \n[3ind]u .nr 3dn \n[dn] .ds 3quote .ds 3trans .nr 3sflag 0 .if \n[.t]<=\n[dn] \{.nr T. 1 .T# .nr 3supbot 1 .sp \n[.t]u .nr 3supbot 0 .mk #T .\} .if \n[.t]<=\n[3dn] .tm warning: page \n%: table text block will not fit on one page .nf .ls 1 .3section .ls .rm 3section .\} .. .nr 3tflag 0 .de 3tkeep .if '\n[.z]'' \{.di 3table .nr 3tflag 1 .\} .. .de 3trelease .if \n[3tflag] \{.br .di .nr 3dn \n[dn] .ne \n[dn]u+\n[.V]u .ie \n[.t]<=\n[3dn] .tm error: page \n%: table will not fit on one page; use .TS H/.TH with a supporting macro package .el \{.in 0 .ls 1 .nf .3table .\} .rm 3table .\} .. .ec .ce 0 .nf .nr 3sep 1n .nr 3w0 \n(.H .nr 3aw0 0 .nr 3lnw0 0 .nr 3rnw0 0 .nr 3w1 \n(.H .nr 3aw1 0 .nr 3lnw1 0 .nr 3rnw1 0 .nr 3w2 \n(.H .nr 3aw2 0 .nr 3lnw2 0 .nr 3rnw2 0 .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor0\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (black) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Black \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor1\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (red) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Red3 \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor2\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (green) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Green3 \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor3\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (yellow) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Yellow3 \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor4\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (blue) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Blue3 \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor5\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (magenta) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Magenta3 \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor6\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (cyan) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Cyan3 \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor7\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (white) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = AntiqueWhite \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor8\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright black) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Grey25 \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor9\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright red) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Red \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor10\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright green) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Green \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor11\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright yellow) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Yellow \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor12\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright blue) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Blue \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor13\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright magenta) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Magenta \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor14\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright cyan) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Cyan \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBcolor15\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ (bright white) \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = White \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBforeground\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = Black \[tbl] .nr 3w0 \n[3w0]>?\w\[tbl]\fBbackground\fP \[tbl] .nr 3w1 \n[3w1]>?\w\[tbl]\ \[tbl] .nr 3w2 \n[3w2]>?\w\[tbl]\ = White \[tbl] .nr 3w0 \n[3w0]>?(\n[3lnw0]+\n[3rnw0]) .if \n[3aw0] .nr 3w0 \n[3w0]>?(\n[3aw0]+2n) .nr 3w1 \n[3w1]>?(\n[3lnw1]+\n[3rnw1]) .if \n[3aw1] .nr 3w1 \n[3w1]>?(\n[3aw1]+2n) .nr 3w2 \n[3w2]>?(\n[3lnw2]+\n[3rnw2]) .if \n[3aw2] .nr 3w2 \n[3w2]>?(\n[3aw2]+2n) .nr 3cd0 0 .nr 3cl0 0*\n[3sep] .nr 3ce0 \n[3cl0]+\n[3w0] .nr 3cl1 \n[3ce0]+(3*\n[3sep]) .nr 3cd1 \n[3ce0]+\n[3cl1]/2 .nr 3ce1 \n[3cl1]+\n[3w1] .nr 3cl2 \n[3ce1]+(3*\n[3sep]) .nr 3cd2 \n[3ce1]+\n[3cl2]/2 .nr 3ce2 \n[3cl2]+\n[3w2] .nr 3cd3 \n[3ce2]+(0*\n[3sep]) .nr TW \n[3cd3] .if \n[3cent] \{.in +(u;\n[.l]-\n[.i]-\n[TW]/2>?-\n[.i]) .nr 3ind \n[.i] .\} .eo .de T# .if !\n[3supbot] \{.3rvpt 0 .mk 3vert .ls 1 .ls .nr 3passed \n[3crow] .sp |\n[3vert]u .3rvpt 1 .\} .. .ec .fc  .3keep .3rmk 3rt0 \*[3trans].nr 3crow 0 .3keep .mk 3rs0 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor0\fP \h'|\n[3cl1]u'\ (black) \h'|\n[3cl2]u'\ = Black .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs0]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt1 \*[3trans].nr 3crow 1 .3keep .mk 3rs1 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor1\fP \h'|\n[3cl1]u'\ (red) \h'|\n[3cl2]u'\ = Red3 .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs1]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt2 \*[3trans].nr 3crow 2 .3keep .mk 3rs2 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor2\fP \h'|\n[3cl1]u'\ (green) \h'|\n[3cl2]u'\ = Green3 .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs2]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt3 \*[3trans].nr 3crow 3 .3keep .mk 3rs3 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor3\fP \h'|\n[3cl1]u'\ (yellow) \h'|\n[3cl2]u'\ = Yellow3 .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs3]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt4 \*[3trans].nr 3crow 4 .3keep .mk 3rs4 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor4\fP \h'|\n[3cl1]u'\ (blue) \h'|\n[3cl2]u'\ = Blue3 .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs4]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt5 \*[3trans].nr 3crow 5 .3keep .mk 3rs5 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor5\fP \h'|\n[3cl1]u'\ (magenta) \h'|\n[3cl2]u'\ = Magenta3 .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs5]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt6 \*[3trans].nr 3crow 6 .3keep .mk 3rs6 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor6\fP \h'|\n[3cl1]u'\ (cyan) \h'|\n[3cl2]u'\ = Cyan3 .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs6]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt7 \*[3trans].nr 3crow 7 .3keep .mk 3rs7 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor7\fP \h'|\n[3cl1]u'\ (white) \h'|\n[3cl2]u'\ = AntiqueWhite .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs7]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt8 \*[3trans].nr 3crow 8 .3keep .mk 3rs8 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor8\fP \h'|\n[3cl1]u'\ (bright black) \h'|\n[3cl2]u'\ = Grey25 .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs8]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt9 \*[3trans].nr 3crow 9 .3keep .mk 3rs9 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor9\fP \h'|\n[3cl1]u'\ (bright red) \h'|\n[3cl2]u'\ = Red .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs9]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt10 \*[3trans].nr 3crow 10 .3keep .mk 3rs10 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor10\fP \h'|\n[3cl1]u'\ (bright green) \h'|\n[3cl2]u'\ = Green .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs10]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt11 \*[3trans].nr 3crow 11 .3keep .mk 3rs11 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor11\fP \h'|\n[3cl1]u'\ (bright yellow) \h'|\n[3cl2]u'\ = Yellow .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs11]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt12 \*[3trans].nr 3crow 12 .3keep .mk 3rs12 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor12\fP \h'|\n[3cl1]u'\ (bright blue) \h'|\n[3cl2]u'\ = Blue .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs12]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt13 \*[3trans].nr 3crow 13 .3keep .mk 3rs13 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor13\fP \h'|\n[3cl1]u'\ (bright magenta) \h'|\n[3cl2]u'\ = Magenta .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs13]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt14 \*[3trans].nr 3crow 14 .3keep .mk 3rs14 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor14\fP \h'|\n[3cl1]u'\ (bright cyan) \h'|\n[3cl2]u'\ = Cyan .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs14]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt15 \*[3trans].nr 3crow 15 .3keep .mk 3rs15 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBcolor15\fP \h'|\n[3cl1]u'\ (bright white) \h'|\n[3cl2]u'\ = White .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs15]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt16 \*[3trans].nr 3crow 16 .3keep .mk 3rs16 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBforeground\fP \h'|\n[3cl1]u'\ \h'|\n[3cl2]u'\ = Black .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs16]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .3keep .3rmk 3rt17 \*[3trans].nr 3crow 17 .3keep .mk 3rs17 .mk 3bot .3rvpt 0 .ta \n[3ce0]u \n[3ce1]u \n[3ce2]u \&\h'|\n[3cl0]u'\fBbackground\fP \h'|\n[3cl1]u'\ \h'|\n[3cl2]u'\ = White .nr 3bot \n[3bot]>?\n[.d] .sp |\n[3rs17]u .3rvpt 1 .sp |\n[3bot]u \*[3trans].nr 3brule 1 .3release .mk 3rt18 .nr 3brule 1 .nr T. 1 .T# .3init .fc .cp \n(3c .TE .PP It is also possible to specify the colour values of \fBforeground\fP, \fBbackground\fP, \fBcursorColor\fP, \fBcursorColor2\fP, \fBcolorBD\fP, \fBcolorUL\fP as a number 0-15, as a convenient shorthand to reference the colour name of color0-color15\&. .PP Note that \fB-rv\fP (\fB"reverseVideo: True"\fP) simulates reverse video by always swapping the foreground/background colours\&. This is in contrast to \fIxterm\fP(1) where the colours are only swapped if they have not otherwise been specified\&. For example, .PP .IP "\fBrxvt -fg Black -bg White -rv\fP" would yield White on Black, while on \fIxterm\fP(1) it would yield Black on White\&. .SH "ENVIRONMENT" .PP \fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window id number of the \fBrxvt\fP window and it also uses and sets the environment variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. .SH "FILES" .PP .IP "\fB/etc/utmp\fP" System file for login records\&. .IP "\fB/usr/lib/X11/rgb\&.txt\fP" Color names\&. .PP .SH "SEE ALSO" .PP \fIxterm\fP(1), \fIsh\fP(1), \fIresize\fP(1), \fIX\fP(1), \fIpty\fP(4), \fItty\fP(4), \fIutmp\fP(5) .PP See rxvtRef\&.html rxvtRef\&.txt for detailed information on recognized escape sequences and menuBar syntax, etc\&. .PP .SH "BUGS" .PP Check the BUGS file for an up-to-date list\&. .PP Cursor change support is not yet implemented\&. .PP Click-and-drag doesn\&'t work with X11 mouse report overriding\&. .PP .SH "FTP LOCATION" .PP rxvt-2\&.4\&.tar\&.gz can be found at the following ftp sites ftp://ftp\&.rxvt\&.org/pub/rxvt .PP .SH "CURRENT PROJECT COORDINATOR" .PP .IP "Project Coordinator" Marc A\&. Lehmann .br .IP "Web page maintainter" Marc A\&. Lehmann .br .br .PP .SH "AUTHORS" .PP .IP "John Bovey" University of Kent, 1992, wrote the original Xvt\&. .IP "Rob Nation " very heavily modified Xvt and came up with Rxvt .IP "Angelo Haritsis " wrote the Greek Keyboard Input (no longer in code) .IP "mj olesen " Wrote the menu system\&. .br Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) .IP "Oezguer Kesim " Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) .IP "Geoff Wing " Rewrote screen display and text selection routines\&. Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) .IP "Marc Alexander Lehman " Rewrote most of the display code and internal character handling to store text in unicode\&. Numerous other fixes and extensions\&. .br Project Coordinator (Changes 1\&.0 - ) .PP