From: root Date: Thu, 12 Aug 2004 21:30:14 +0000 (+0000) Subject: *** empty log message *** X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=9fa3eaf84765f122800080b4131b9e99177f0f5b;p=dana%2Furxvt.git *** empty log message *** --- diff --git a/Makefile.in b/Makefile.in index f436e289..2e6246de 100644 --- a/Makefile.in +++ b/Makefile.in @@ -1,5 +1,5 @@ # ./Makefile.in -*- Makefile -*- -# $Id: Makefile.in,v 1.7 2004-05-08 17:21:07 pcg Exp $ +# $Id: Makefile.in,v 1.8 2004-08-12 21:32:40 root Exp $ @MCOMMON@ srcdir = @srcdir@ @@ -83,7 +83,7 @@ distclean: (cd $(srcdir); $(RMF) Makefile autoconf/Make.common) distdir: - cd doc && $(MAKE) yodl/versioninfo.yo rxvt.html rxvtRef.txt + cd doc && $(MAKE) distdepend rm -rf $(VERNAME) mkdir $(VERNAME) rsync -aR `cat MANIFEST` $(VERNAME)/. diff --git a/autoconf/Make.common.in b/autoconf/Make.common.in index 78a99410..524b2ea0 100644 --- a/autoconf/Make.common.in +++ b/autoconf/Make.common.in @@ -5,12 +5,10 @@ LSMDATE=@LSMDATE@ VERSION=@VERSION@ VERNAME=rxvt-unicode-$(VERSION) MAINT=Marc A. Lehmann -MAINTEMAIL= +MAINTEMAIL=rxvt@schmorp.de WEBMAINT=Marc A. Lehmann -WEBMAINTEMAIL= -WEBPAGE= -FTPSITENAME=ftp.rxvt.org -FTPSITEDIR=/pub/rxvt +WEBMAINTEMAIL=rxvt@schmorp.de +WEBPAGE=http://software.schmorp.de/#rxvt-unicode #------------------------------------------------------------------------- RXVTNAME=@RXVTNAME@ @@ -30,8 +28,10 @@ exec_prefix = @exec_prefix@ bindir = @bindir@ libdir = @libdir@ includedir = @includedir@ -mandir = @mandir@/man1 -manext = 1 +man1dir = @mandir@/man1 +man1ext = 1 +man7dir = @mandir@/man7 +man7ext = 7 # Tools & program stuff CC = @CC@ diff --git a/doc/LSM.in b/doc/LSM.in index ed655e4f..b339b057 100644 --- a/doc/LSM.in +++ b/doc/LSM.in @@ -1,9 +1,9 @@ Begin3 Title: rxvt -Version: @RXVT_VERSION@ -Entered-date: @RXVT_LSMDATE@ +Version: @@RXVT_VERSION@@ +Entered-date: @@RXVT_LSMDATE@@ -Description: @RXVT_WEBPAGE@ +Description: @@RXVT_WEBPAGE@@ Rxvt is an 8-bit clean, colour xterm replacement that uses significantly less memory than a conventional xterm, mostly since it doesn't support toolkit configurability or Tek @@ -39,10 +39,9 @@ Author: * John Bovey [Univ. Kent at Canterbury] was the creator of and mouse selection. Coordinated development, versions 2.4.6 - -Maintained-by: @RXVT_MAINT@ @RXVT_MAINTEMAIL@ Project Coordinator +Maintained-by: @@RXVT_MAINT@@ @@RXVT_MAINTEMAIL@@ Project Coordinator -Original-site: @RXVT_FTPSITENAME@ @RXVT_FTPSITEDIR@ - 582k rxvt-@RXVT_VERSION@.tar.gz +Original-site: http://software.schmorp.de/#rxvt-unicode Platforms: requires X11 installed diff --git a/doc/podtbl b/doc/podtbl new file mode 100755 index 00000000..bef484bb --- /dev/null +++ b/doc/podtbl @@ -0,0 +1,84 @@ +#!/usr/bin/perl + +use Pod::Parser; +use List::Util qw(max); + +@ISA = Pod::Parser::; + +sub stripfcodes { + # strip formatting codes, dumb version + map { + s/[IBCLFSXZ]<< (.*?) >>/$1/gs; + s/[IBCLFSXZ]<(.*?)>/$1/gs; + $_ + } @$_; +} + +sub htmlfcodes { + my %tag = ( + I => "i", + B => "b", + C => "tt", + L => "i", # broken + F => "tt", + S => "nobr", # non-std + X => "span", # brokwn + Z => "span", # brokwn + ); + # strip formatting codes, dumb version + map { + s/([IBCLFSXZ])<< (.*?) >>/<$tag{$1}>$2<\/$tag{$1}>/gs; + s/([IBCLFSXZ])<(.*?)>/<$tag{$1}>$2<\/$tag{$1}>/gs; + $_ + } @$_; +} + +sub command { + my ($self, $command, $paragraph) = @_; + + if ($command eq "begin" && $paragraph =~ /^\s*table\s*$/s) { + $table++; + } elsif ($command eq "end" && $paragraph =~ /^\s*table\s*$/s) { + $table--; + } else { + shift; + return $self->SUPER::command (@_); + } +} + +sub verbatim { + my ($self, $para) = @_; + shift; + + return $self->SUPER::verbatim (@_) unless $table; + + my $table = [ map [$_ =~ /\t([^\t]*)/g], split /\n/, $para ]; + my $cols = max map scalar @$_, @$table; + + my $fh = $self->output_handle; + + # format the table + # tbl first + print $fh "=begin roff\n\n"; + + print $fh ".TS\n" . ("l " x $cols) . ".\n"; + print $fh map +(join "\t", stripfcodes @$_) . "\n", @$table; + print $fh ".TE\n\n"; + + print $fh "=end roff\n\n"; + + # html second + print $fh "=begin html\n\n"; + + print $fh "\n"; + print $fh map "\n", @$table; + print $fh "
" . +(join "", htmlfcodes @$_) . "
\n\n"; + + print $fh "=end html\n\n"; + +} + +__PACKAGE__->new->parse_from_filehandle; + + + diff --git a/doc/rxvt.1 b/doc/rxvt.1 deleted file mode 100644 index f78042b2..00000000 --- a/doc/rxvt.1 +++ /dev/null @@ -1,1152 +0,0 @@ -.if !\n(.g .ab GNU tbl requires GNU troff. -.if !dTS .ds TS -.if !dTE .ds TE -.TH "RXVT" "1" "2004-08-11" "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 \fB3\&.5\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-fade\fP \fInumber\fP" -Fade the text by the given percentage when focus is lost\&. -.IP "\fB-tint\fP \fIcolour\fP" -Tint the transparent background pixmap with the given colour when -transparency is enabled with \fB-tr\fP or \fB-ip\fP\&. See also -the \fB-sh\fP option that can be used to brighten or darken -the image in addition to tinting it\&. -.IP "\fB-sh\fP" -\fInumber\fP -Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background -image in addition to tinting it (i\&.e\&. \fB-tint\fP must be specified, too)\&. -.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 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\&. -.IP "\fB-fn\fP \fIfontname\fP" -Select the fonts to be 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; other fonts might -be smaller, but not larger\&. -A reasonable default font list is always appended to it\&. -resource \fBfont\fP\&. -.IP "\fB-rb\fP|\fB+rb\fP" -Enable "real bold" support\&. -When this option is on, bold text will be displayed using the first -available bold font in the font list\&. -Bold fonts should thus be specified in the font list after their -corresponding regular fonts\&. -If no bold font can be found, a regular font will be used\&. -resource \fBrealBold\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-bl\fP" -Compile \fIfrills\fP: Set MWM hints to request a borderless window, -i\&.e\&. if honoured by the WM, the rxvt window will not have window -decorations; resource \fBborderLess\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-insecure\fP" -Enable "insecure" mode, which currently enables most of the escape -sequences that echo strings\&. See the resource \fBinsecure\fP for -more info\&. -.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-ssc\fP|\fB+ssc\fP" -Turn on/off secondary screen (default enabled); -resource \fBsecondaryScreen\fP\&. -.IP "\fB-ssr\fP|\fB+ssr\fP" -Turn on/off secondary screen scroll (default enabled); -resource \fBsecondaryScroll\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\&. -.PP -There are two different methods that rxvt can use to get the -Xresource data: using the X libraries (Xrm*-functions) or internal Xresources -reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists -\fBXGetDefaults\fP), you can set and change the resources using X11 -tools like \fBxset\fP\&. Many distribution do also load settings from the -\fB~/\&.Xresources\fP file when X starts\&. -.PP -If compiled with internal Xresources support (i\&.e\&. \fBrxvt --h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application -defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually -\fB/usr/lib/X11/app-defaults/URxvt\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 \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources -common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured, -while the class name \fBURxvt\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\&. -This option will be ignored if \fBrealBold\fP is enabled\&. -.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 "\fBfading:\fP \fInumber\fP" -Fade the text by the given percentage when focus is lost\&. -.IP "\fBtintColor:\fP \fIcolour\fP" -Tint the transparent background pixmap with the given colour\&. -.IP "\fBshading:\fP \fInumber\fP" -Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background -image in addition to tinting it\&. -.IP "\fBfading:\fP \fInumber\fP" -Scale the tint colour by the given percentage\&. -.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\&. -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; other fonts might -be smaller, but not larger\&. -A reasonable default font list is always appended to it\&. -option \fB-fn\fP\&. -.IP "\fBrealBold:\fP \fIboolean\fP" -\fBTrue\fP: Enable "real bold" support\&. -When this option is on, bold text will be displayed using the first -available bold font in the font list\&. -Bold fonts should thus be specified in the font list after their -corresponding regular fonts\&. -If no bold font can be found, a regular font will be used\&. -option \fB-rb\fP\&. -\fBFalse\fP: Display bold text in a regular font, using the color -specified with \fBcolorBD\fP; -option \fB+rb\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, \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 -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 "\fBborderLess:\fP \fIboolean\fP" -Set MWM hints to request a borderless window, -i\&.e\&. if honoured by the WM, the rxvt window will not have window -decorations; option \fB-bl\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 "\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" -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 "\fBinsecure\fP" -Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences -that echo arbitrary strings like the icon name or the locale\&. This -could be abused if somebody gets 8-bit-clean access to your -display, wether throuh a mail client displaying mail bodies -unfiltered or though write(1)\&. Therefore, these sequences are -disabled by default\&. (Note that other terminals, including xterm, -have these sequences enabled by default)\&. You can enable them -by setting this boolean resource or specifying \fB-insecure\fP as -an option\&. At the moment, this enabled display-answer, locale, -findfont, icon label and window title requests as well as dynamic -menubar dispatch\&. -.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 "\fBsecondaryScreen:\fP \fIbool\fP" -Turn on/off secondary screen (default enabled)\&. -.IP "\fBsecondaryScroll:\fP \fIbool\fP" -Turn on/off secondary screen scroll (default enabled)\&. If -the this option is enabled, scrolls on the secondary screen will -change the scrollback buffer and switching to/from the secondary screen -will instead scroll the screen up\&. -.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-3\&.5\&.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 Lehmann " -Forked rxvt-unicode, rewrote most of the display code and -internal character handling to store text in unicode, -improve xterm compatibility and apply numerous other bugfixes -and extensions\&. -.br -Project Coordinator (Changes 1\&.0 - ) -.PP diff --git a/doc/rxvt.1.pod b/doc/rxvt.1.pod index d75bbb0d..5e802fcd 100644 --- a/doc/rxvt.1.pod +++ b/doc/rxvt.1.pod @@ -4,7 +4,7 @@ rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system) =head1 SYNOPSIS -B<@@RXVTNAME@@> [options] [-e command [ args ]] +B<@@RXVT_NAME@@> [options] [-e command [ args ]] =head1 DESCRIPTION @@ -14,9 +14,12 @@ require features such as Tektronix 4014 emulation and toolkit-style configurability. As a result, B uses much less swap space -- a significant advantage on a machine serving many X sessions. +See also @@RXVT_NAME@@(7) for technical reference documentation (escape +sequences etc.). + =head1 OPTIONS -The B<@@RXVTNAME@@> options (mostly a subset of I's) are listed +The B<@@RXVT_NAME@@> options (mostly a subset of I'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 @@ -26,7 +29,7 @@ compile option each is dependent upon. e.g. `Compile I:' requires I on the I line. Note: `rxvt -help' gives a list of all command-line options compiled into your version. -Note that B<@@RXVTNAME@@> permits the resource name to be used as a +Note that B<@@RXVT_NAME@@> 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'. @@ -221,7 +224,7 @@ resource B. =item B<-e> I -Run the command with its command-line arguments in the B<@@RXVTNAME@@> +Run the command with its command-line arguments in the B<@@RXVT_NAME@@> window; also sets the window title and icon name to be the basename of the program being executed if neither I<-title> (I<-T>) nor I<-n> are given on the command line. If this option is used, it must be the last @@ -293,27 +296,27 @@ some window managers. =head1 RESOURCES (available also as long-options) -Note: `@@RXVTNAME@@ --help' gives a list of all resources (long +Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long options) compiled into your version. -There are two different methods that @@RXVTNAME@@ can use to get the +There are two different methods that @@RXVT_NAME@@ can use to get the Xresource data: using the X libraries (Xrm*-functions) or internal Xresources reader (B<~/.Xdefaults>). For the first method (ie. -B<@@RXVTNAME@@ -h> lists B), you can set and change the +B<@@RXVT_NAME@@ -h> lists B), you can set and change the resources using X11 tools like B. Many distribution do also load settings from the B<~/.Xresources> file when X starts. -If compiled with internal Xresources support (i.e. B<@@RXVTNAME@@ -h> -lists B<.Xdefaults>) then B<@@RXVTNAME@@> accepts application defaults +If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h> +lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually B) and resources set in B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist. -Note that when reading X resources, B<@@RXVTNAME@@> recognizes two +Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class names: B and B. The class name B allows -resources common to both B<@@RXVTNAME@@> and the original I to be +resources common to both B<@@RXVT_NAME@@> and the original I to be easily configured, while the class name B allows resources -unique to B<@@RXVTNAME@@>, notably colours and key-handling, to be -shared between different B<@@RXVTNAME@@> configurations. If no +unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be +shared between different B<@@RXVT_NAME@@> 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: @@ -464,7 +467,7 @@ xterm style selection. =item B I -Set scrollbar style to B<@@RXVTNAME@@>, B, B, B or +Set scrollbar style to B<@@RXVT_NAME@@>, B, B, B or B =item B I @@ -705,9 +708,9 @@ KEYSYM_RESOURCE. =head1 THE SCROLLBAR -Lines of text that scroll off the top of the B<@@RXVTNAME@@> window +Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window (resource: B) and can be scrolled back using the scrollbar -or by keystrokes. The normal B<@@RXVTNAME@@> scrollbar has arrows and +or by keystrokes. The normal B<@@RXVT_NAME@@> scrollbar has arrows and its behaviour is fairly intuitive. The B is without arrows and its behaviour mimics that of I @@ -745,7 +748,7 @@ line. =item B: Pressing and releasing the Middle mouse button (or B) in -an B<@@RXVTNAME@@> window causes the current text selection to be +an B<@@RXVT_NAME@@> window causes the current text selection to be inserted as if it had been typed on the keyboard. =back @@ -759,17 +762,31 @@ B<@@HOTKEY@@-@@BIGFONT@@> and B<@@HOTKEY@@-@@SMALLFONT@@>, where the actual key can be selected using resources B/B. +=head1 ISO 14755 SUPPORT + +Partial ISO 14755-support is implemented. that means that pressing + +Section 5.1: Control and Shift together enters unicode input +mode. Entering hex digits composes a Unicode character, pressing space or +releasing the modifiers commits the keycode and every other key cancels +the current input character. + +Section 5.2: Pressing and immediately releasing Control and Shift together +enters keycap entry mode for the next key: pressing a function key (tab, +return etc..) will enter the unicode character corresponding to the given +key. + =head1 LOGIN STAMP -B<@@RXVTNAME@@> tries to write an entry into the I(5) file so +B<@@RXVT_NAME@@> tries to write an entry into the I(5) file so that it can be seen via the I command, and can accept messages. -To allow this feature, B<@@RXVTNAME@@> must be installed setuid root on +To allow this feature, B<@@RXVT_NAME@@> must be installed setuid root on some systems. =head1 COLORS AND GRAPHICS In addition to the default foreground and background colours, -B<@@RXVTNAME@@> can display up to 16 colours (8 ANSI colours plus +B<@@RXVT_NAME@@> 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 B names. @@ -817,11 +834,11 @@ on White. =head1 ENVIRONMENT -B<@@RXVTNAME@@> sets the environment variables B, B +B<@@RXVT_NAME@@> sets the environment variables B, B and B. The environment variable B is set to the X -window id number of the B<@@RXVTNAME@@> window and it also uses and +window id number of the B<@@RXVT_NAME@@> window and it also uses and sets the environment variable B to specify which display -terminal to use. B<@@RXVTNAME@@> uses the environment variables +terminal to use. B<@@RXVT_NAME@@> uses the environment variables B and B to find XPM files. =head1 FILES @@ -852,23 +869,19 @@ Cursor change support is not yet implemented. Click-and-drag doesn't work with X11 mouse report overriding. -=head1 FTP LOCATION - -rxvt-+@@RXVTVERSION@@.tar.gz can be found at the following ftp sites L<@@RXVTFTPSITE@@>(@@RXVTFTPSITE@@) - =head1 CURRENT PROJECT COORDINATOR =over 4 =item Project Coordinator -@@RXVTMAINT@@ L<@@RXVTMAINTEMAIL@@> +@@RXVTMAINT@@ L<@@RXVT_MAINTEMAIL@@> =item Web page maintainter -@@RXVTWEBMAINT@@ L<@@RXVTWEBMAINTEMAIL@@> +@@RXVTWEBMAINT@@ L<@@RXVT_WEBMAINTEMAIL@@> -L<@@RXVTWEBPAGE@@>(@@RXVTWEBPAGE@@) +L<@@RXVT_WEBPAGE@@> =back diff --git a/doc/rxvt.7.pod b/doc/rxvt.7.pod index 9e92abb0..f451a280 100644 --- a/doc/rxvt.7.pod +++ b/doc/rxvt.7.pod @@ -1,8 +1,4 @@ -=head1 Rxvt Technical Reference - -Marc Lehmann , converted to pod and reworked from the -original Rxvt documentation by Geoff Wing , who in turn used -the XTerm documentation and other sources. +=head1 RXVT TECHNICAL REFERENCE =head1 Definitions @@ -39,7 +35,7 @@ A text parameter composed of printable characters. =item B<< C >> Enquiry (Ctrl-E) = Send Device Attributes (DA) -request attributes from terminal == +request attributes from terminal. See B<< C >>. =item B<< C >> @@ -300,11 +296,11 @@ Move backward B<< C >> [default: 1] tab stops =item B<< C >> -== +See B<< C >> =item B<< C >> -==X +See B<< C >> =item B<< C >> @@ -319,7 +315,7 @@ Cursor to Line B<< C >> (VPA) =item B<< C >> -== +See B<< C >> =item B<< C >> @@ -627,8 +623,8 @@ X =begin table - B<< C >> Application Keypad (DECPAM) == - B<< C >> Normal Keypad (DECPNM) == + B<< C >> Application Keypad (DECPAM) == C + B<< C >> Normal Keypad (DECPNM) == C<< ESC > >> =end table @@ -731,9 +727,9 @@ B can be escaped by prefixing it with SYN (0x16, ^V). B<< C >> Change default background colour to B<< C >> I B<< C >> Set fontset to B<< C >>, with the following special values of B<< C >> (B) B<< C<#+n> >> change up B<< C >> B<< C<#-n> >> change down B<< C >> if B<< C >> is missing of 0, a value of 1 is used I change to font0 B<< C >> change to font B<< C >> B<< C >> Log all scrollback buffer and all of screen to B<< C >> - B<< C >> Change current locale to B<< C >>, or, if B<< C >> is B<< C >>, return the current locale (@@RXVTNAME@@ extension) - B<< C >> find font for character, used for debugging (@@RXVTNAME@@ extension) - B<< C >> command B<< C >> I (@@RXVTNAME@@ extension) + B<< C >> Change current locale to B<< C >>, or, if B<< C >> is B<< C >>, return the current locale (@@RXVT_NAME@@ extension) + B<< C >> find font for character, used for debugging (@@RXVT_NAME@@ extension) + B<< C >> command B<< C >> I (@@RXVT_NAME@@ extension) =end table @@ -1323,20 +1319,6 @@ Row = B<< C<< - SPACE >> >> =back X -=head1 ISO 14755 support - -Partial ISO 14755-support is implemented. that means that pressing - -section 5.1: Control and Shift together enters unicode input -mode. Entering hex digits composes a Unicode character, pressing space or -releasing the modifiers commits the keycode and every other key cancels -the current input character. - -section 5.2: Pressing and immediately releasing Control and Shift together -enters keycap entry mode for the next key: pressing a function key (tab, -return etc..) will enter the unicode character corresponding to the given -key. - =head1 Key Codes Note: B + B-B generates B-B @@ -1410,3 +1392,10 @@ your system. =end table +=head1 AUTHORS + +Marc Lehmann , converted this document to pod and +reworked it from the original Rxvt documentation, which was done by Geoff +Wing , who in turn used the XTerm documentation and other +sources. + diff --git a/doc/rxvt.tbl b/doc/rxvt.tbl deleted file mode 100644 index bc4d3df3..00000000 --- a/doc/rxvt.tbl +++ /dev/null @@ -1,702 +0,0 @@ -.TH "RXVT" "1" "2004-08-11" "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 \fB3\&.5\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-fade\fP \fInumber\fP" -Fade the text by the given percentage when focus is lost\&. -.IP "\fB-tint\fP \fIcolour\fP" -Tint the transparent background pixmap with the given colour when -transparency is enabled with \fB-tr\fP or \fB-ip\fP\&. See also -the \fB-sh\fP option that can be used to brighten or darken -the image in addition to tinting it\&. -.IP "\fB-sh\fP" -\fInumber\fP -Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background -image in addition to tinting it (i\&.e\&. \fB-tint\fP must be specified, too)\&. -.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 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\&. -.IP "\fB-fn\fP \fIfontname\fP" -Select the fonts to be 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; other fonts might -be smaller, but not larger\&. -A reasonable default font list is always appended to it\&. -resource \fBfont\fP\&. -.IP "\fB-rb\fP|\fB+rb\fP" -Enable "real bold" support\&. -When this option is on, bold text will be displayed using the first -available bold font in the font list\&. -Bold fonts should thus be specified in the font list after their -corresponding regular fonts\&. -If no bold font can be found, a regular font will be used\&. -resource \fBrealBold\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-bl\fP" -Compile \fIfrills\fP: Set MWM hints to request a borderless window, -i\&.e\&. if honoured by the WM, the rxvt window will not have window -decorations; resource \fBborderLess\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-insecure\fP" -Enable "insecure" mode, which currently enables most of the escape -sequences that echo strings\&. See the resource \fBinsecure\fP for -more info\&. -.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-ssc\fP|\fB+ssc\fP" -Turn on/off secondary screen (default enabled); -resource \fBsecondaryScreen\fP\&. -.IP "\fB-ssr\fP|\fB+ssr\fP" -Turn on/off secondary screen scroll (default enabled); -resource \fBsecondaryScroll\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\&. -.PP -There are two different methods that rxvt can use to get the -Xresource data: using the X libraries (Xrm*-functions) or internal Xresources -reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists -\fBXGetDefaults\fP), you can set and change the resources using X11 -tools like \fBxset\fP\&. Many distribution do also load settings from the -\fB~/\&.Xresources\fP file when X starts\&. -.PP -If compiled with internal Xresources support (i\&.e\&. \fBrxvt --h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application -defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually -\fB/usr/lib/X11/app-defaults/URxvt\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 \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources -common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured, -while the class name \fBURxvt\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\&. -This option will be ignored if \fBrealBold\fP is enabled\&. -.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 "\fBfading:\fP \fInumber\fP" -Fade the text by the given percentage when focus is lost\&. -.IP "\fBtintColor:\fP \fIcolour\fP" -Tint the transparent background pixmap with the given colour\&. -.IP "\fBshading:\fP \fInumber\fP" -Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background -image in addition to tinting it\&. -.IP "\fBfading:\fP \fInumber\fP" -Scale the tint colour by the given percentage\&. -.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\&. -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; other fonts might -be smaller, but not larger\&. -A reasonable default font list is always appended to it\&. -option \fB-fn\fP\&. -.IP "\fBrealBold:\fP \fIboolean\fP" -\fBTrue\fP: Enable "real bold" support\&. -When this option is on, bold text will be displayed using the first -available bold font in the font list\&. -Bold fonts should thus be specified in the font list after their -corresponding regular fonts\&. -If no bold font can be found, a regular font will be used\&. -option \fB-rb\fP\&. -\fBFalse\fP: Display bold text in a regular font, using the color -specified with \fBcolorBD\fP; -option \fB+rb\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, \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 -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 "\fBborderLess:\fP \fIboolean\fP" -Set MWM hints to request a borderless window, -i\&.e\&. if honoured by the WM, the rxvt window will not have window -decorations; option \fB-bl\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 "\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" -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 "\fBinsecure\fP" -Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences -that echo arbitrary strings like the icon name or the locale\&. This -could be abused if somebody gets 8-bit-clean access to your -display, wether throuh a mail client displaying mail bodies -unfiltered or though write(1)\&. Therefore, these sequences are -disabled by default\&. (Note that other terminals, including xterm, -have these sequences enabled by default)\&. You can enable them -by setting this boolean resource or specifying \fB-insecure\fP as -an option\&. At the moment, this enabled display-answer, locale, -findfont, icon label and window title requests as well as dynamic -menubar dispatch\&. -.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 "\fBsecondaryScreen:\fP \fIbool\fP" -Turn on/off secondary screen (default enabled)\&. -.IP "\fBsecondaryScroll:\fP \fIbool\fP" -Turn on/off secondary screen scroll (default enabled)\&. If -the this option is enabled, scrolls on the secondary screen will -change the scrollback buffer and switching to/from the secondary screen -will instead scroll the screen up\&. -.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 -tab(`); -l l l . -\fBcolor0\fP `\ (black) `\ = Black -\fBcolor1\fP `\ (red) `\ = Red3 -\fBcolor2\fP `\ (green) `\ = Green3 -\fBcolor3\fP `\ (yellow) `\ = Yellow3 -\fBcolor4\fP `\ (blue) `\ = Blue3 -\fBcolor5\fP `\ (magenta) `\ = Magenta3 -\fBcolor6\fP `\ (cyan) `\ = Cyan3 -\fBcolor7\fP `\ (white) `\ = AntiqueWhite -\fBcolor8\fP `\ (bright black) `\ = Grey25 -\fBcolor9\fP `\ (bright red) `\ = Red -\fBcolor10\fP `\ (bright green) `\ = Green -\fBcolor11\fP `\ (bright yellow) `\ = Yellow -\fBcolor12\fP `\ (bright blue) `\ = Blue -\fBcolor13\fP `\ (bright magenta) `\ = Magenta -\fBcolor14\fP `\ (bright cyan) `\ = Cyan -\fBcolor15\fP `\ (bright white) `\ = White -\fBforeground\fP `\ `\ = Black -\fBbackground\fP `\ `\ = White -.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-3\&.5\&.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 Lehmann " -Forked rxvt-unicode, rewrote most of the display code and -internal character handling to store text in unicode, -improve xterm compatibility and apply numerous other bugfixes -and extensions\&. -.br -Project Coordinator (Changes 1\&.0 - ) -.PP diff --git a/doc/rxvtRef-frame.html b/doc/rxvtRef-frame.html deleted file mode 100644 index b636080f..00000000 --- a/doc/rxvtRef-frame.html +++ /dev/null @@ -1,10 +0,0 @@ - - -Rxvt Technical Reference - - - - - -Your browser needs frames -