--- rxvt-unicode/doc/rxvt.1 2004/05/08 17:18:21 1.11 +++ rxvt-unicode/doc/rxvt.1 2004/07/10 20:59:39 1.12 @@ -1,17 +1,17 @@ .if !\n(.g .ab GNU tbl requires GNU troff. .if !dTS .ds TS .if !dTE .ds TE -.TH "RXVT" "1" "2004-04-02" "X Version 11" "X Tools" +.TH "RXVT" "1" "2004-05-10" "X Version 11" "X Tools" .SH "NAME" rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system .PP .SH "SYNOPSIS" .PP -\fBurxvt\fP [options] [-e command [ args ]] +\fBrxvt\fP [options] [-e command [ args ]] .PP .SH "DESCRIPTION" .PP -\fBrxvt-unicode\fP, version \fB2\&.7\fP, is a colour vt102 terminal emulator +\fBrxvt-unicode\fP, version \fB3\&.1\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 @@ -20,7 +20,7 @@ .PP .SH "OPTIONS" .PP -The \fBurxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. +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\&. @@ -30,7 +30,7 @@ line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled into your version\&. .PP -Note that \fBurxvt\fP permits the resource name to be used as a long-option +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\&'\&. @@ -74,8 +74,11 @@ The cursor colour; resource \fBcursorColor\fP\&. .IP "\fB-pr\fP \fIcolour\fP" -The mouse pointer colour; +The mouse pointer foreground colour; resource \fBpointerColor\fP\&. +.IP "\fB-pr2\fP \fIcolour\fP" +The mouse pointer background colour; +resource \fBpointerColor2\fP\&. .IP "\fB-bd\fP \fIcolour\fP" The colour of the border between the xterm scrollbar and the text; resource \fBborderColor\fP\&. @@ -146,7 +149,7 @@ \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 \fBurxvt\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 @@ -200,15 +203,15 @@ 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 \fBurxvt\fP accepts application defaults set in +\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, \fBurxvt\fP recognizes two class names: \fBXTerm\fP and +reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both -\fBurxvt\fP and \fIxterm\fP to be easily configured, while the class name -\fBRxvt\fP allows resources unique to \fBurxvt\fP, notably colours and -key-handling, to be shared between different \fBurxvt\fP configurations\&. +\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: @@ -303,7 +306,7 @@ 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 \fBurxvt\fP, \fBnext\fP or \fBxterm\fP +Set scrollbar style to \fBrxvt\fP, \fBrxvt\fP, \fBplain\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 @@ -414,6 +417,10 @@ \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 "\fBpointerColor:\fP \fIcolour\fP" +Mouse pointer foreground colour\&. +.IP "\fBpointerColor2:\fP \fIcolour\fP" +Mouse pointer background colour\&. .IP "\fBpointerBlankDelay:\fP \fInumber\fP" Specifies number of seconds before blanking the pointer [default 2]\&. .IP "\fBbackspacekey:\fP \fIstring\fP" @@ -480,9 +487,9 @@ resource is only available when compiled with KEYSYM_RESOURCE\&. .SH "THE SCROLLBAR" .PP -Lines of text that scroll off the top of the \fBurxvt\fP window (resource: +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 \fBurxvt\fP scrollbar has arrows and its behaviour is fairly +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 @@ -513,7 +520,7 @@ the entire line\&. .IP "\fBInsertion\fP:" Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) -in an \fBurxvt\fP window causes the current text selection to be inserted +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 @@ -524,12 +531,12 @@ can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. .SH "LOGIN STAMP" .PP -\fBurxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be +\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, \fBurxvt\fP must be installed setuid root on some systems\&. +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, \fBurxvt\fP +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\&. @@ -1020,10 +1027,10 @@ Black on White\&. .SH "ENVIRONMENT" .PP -\fBurxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and +\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 \fBurxvt\fP window and it also uses and sets the environment -variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBurxvt\fP uses +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 @@ -1050,7 +1057,7 @@ .PP .SH "FTP LOCATION" .PP -rxvt-2\&.7\&.tar\&.gz can be found at the following ftp sites +rxvt-3\&.1\&.tar\&.gz can be found at the following ftp sites ftp://ftp\&.rxvt\&.org/pub/rxvt .PP .SH "CURRENT PROJECT COORDINATOR" @@ -1082,9 +1089,9 @@ Rewrote screen display and text selection routines\&. Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) .IP "Marc Alexander Lehmann " -Forked rxvt-unicode\&. Rewrote most of the display code and +Forked rxvt-unicode, rewrote most of the display code and internal character handling to store text in unicode, -improve xterm compatibility and numerous other bugfixes +improve xterm compatibility and apply numerous other bugfixes and extensions\&. .br Project Coordinator (Changes 1\&.0 - )