# ./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@
(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)/.
VERSION=@VERSION@
VERNAME=rxvt-unicode-$(VERSION)
MAINT=Marc A. Lehmann
-MAINTEMAIL=<rxvt@schmorp.de>
+MAINTEMAIL=rxvt@schmorp.de
WEBMAINT=Marc A. Lehmann
-WEBMAINTEMAIL=<rxvt@schmorp.de>
-WEBPAGE=<http://www.sourceforge.net/projects/rxvt-unicode/>
-FTPSITENAME=ftp.rxvt.org
-FTPSITEDIR=/pub/rxvt
+WEBMAINTEMAIL=rxvt@schmorp.de
+WEBPAGE=http://software.schmorp.de/#rxvt-unicode
#-------------------------------------------------------------------------
RXVTNAME=@RXVTNAME@
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@
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
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
--- /dev/null
+#!/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 "<table>\n";
+ print $fh map "<tr><td>" . +(join "</td><td>", htmlfcodes @$_) . "</td></tr>\n", @$table;
+ print $fh "</table>\n\n";
+
+ print $fh "=end html\n\n";
+
+}
+
+__PACKAGE__->new->parse_from_filehandle;
+
+
+
+++ /dev/null
-.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 \ 2\ 3
-.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 <rxvt@schmorp\&.de>
-.br
-.IP "Web page maintainter"
-Marc A\&. Lehmann <rxvt@schmorp\&.de>
-.br
-<http://www\&.sourceforge\&.net/projects/rxvt-unicode/>
-.br
-.PP
-.SH "AUTHORS"
-.PP
-.IP "John Bovey"
-University of Kent, 1992, wrote the original Xvt\&.
-.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>"
-very heavily modified Xvt and came up with Rxvt
-.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>"
-wrote the Greek Keyboard Input (no longer in code)
-.IP "mj olesen <olesen@me\&.QueensU\&.CA>"
-Wrote the menu system\&.
-.br
-Project Coordinator (changes\&.txt 2\&.11 to 2\&.21)
-.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
-Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
-.IP "Geoff Wing <gcw@pobox\&.com>"
-Rewrote screen display and text selection routines\&.
-Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
-.IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>"
-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
=head1 SYNOPSIS
-B<@@RXVTNAME@@> [options] [-e command [ args ]]
+B<@@RXVT_NAME@@> [options] [-e command [ args ]]
=head1 DESCRIPTION
configurability. As a result, B<rxvt-unicode> 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<xterm>'s) are listed
+The B<@@RXVT_NAME@@> options (mostly a subset of I<xterm>'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
I<XIM> on the I<Options> 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'.
=item B<-e> I<command [arguments]>
-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
=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<XGetDefaults>), you can set and change the
+B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the
resources using X11 tools like B<xset>. 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</usr/lib/X11/app-defaults/URxvt>) 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<XTerm> and B<URxvt>. The class name B<Rxvt> allows
-resources common to both B<@@RXVTNAME@@> and the original I<rxvt> to be
+resources common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be
easily configured, while the class name B<URxvt> 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:
=item B<scrollstyle:> I<mode>
-Set scrollbar style to B<@@RXVTNAME@@>, B<rxvt>, B<plain>, B<next> or
+Set scrollbar style to B<@@RXVT
_NAME@@>, B<rxvt>, B<plain>, B<next> or
B<xterm>
=item B<title:> I<string>
=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<saveLines>) 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<xterm-scrollbar> is without
arrows and its behaviour mimics that of I<xterm>
=item B<Insertion>:
Pressing and releasing the Middle mouse button (or B<Shift-Insert>) 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
actual key can be selected using resources
B<smallfont_key>/B<bigfont_key>.
+=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<utmp>(5) file so
+B<@@RXVT_NAME@@> tries to write an entry into the I<utmp>(5) file so
that it can be seen via the I<who(1)> 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<rgb.txt> names.
=head1 ENVIRONMENT
-B<@@RXVTNAME@@> sets the environment variables B<TERM>, B<COLORTERM>
+B<@@RXVT_NAME@@> sets the environment variables B<TERM>, B<COLORTERM>
and B<COLORFGBG>. The environment variable B<WINDOWID> 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<DISPLAY> to specify which display
-terminal to use. B<@@RXVTNAME@@> uses the environment variables
+terminal to use. B<@@RXVT_NAME@@> uses the environment variables
B<RXVTPATH> and B<PATH> to find XPM files.
=head1 FILES
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
-=head1 Rxvt Technical Reference
-
-Marc Lehmann <rxvt@schmorp.de>, converted to pod and reworked from the
-original Rxvt documentation by Geoff Wing <gcw@pobox.com>, who in turn used
-the XTerm documentation and other sources.
+=head1 RXVT TECHNICAL REFERENCE
=head1 Definitions
=item B<< C<ENQ> >>
Enquiry (Ctrl-E) = Send Device Attributes (DA)
-request attributes from terminal ==
+request attributes from terminal. See B<< C<ESC [ Ps c> >>.
=item B<< C<BEL> >>
=item B<< C<ESC [ Ps '> >>
-==
+See B<< C<ESC [ Ps G> >>
=item B<< C<ESC [ Ps a> >>
-==X<ESCOBPsc>
+See B<< C<ESC [ Ps C> >>
=item B<< C<ESC [ Ps c> >>
=item B<< C<ESC [ Ps e> >>
-==
+See B<< C<ESC [ Ps A> >>
=item B<< C<ESC [ Ps;Ps f> >>
=begin table
- B<< C<h> >> Application Keypad (DECPAM) ==
- B<< C<l> >> Normal Keypad (DECPNM) ==
+ B<< C<h> >> Application Keypad (DECPAM) == C<ESC =>
+ B<< C<l> >> Normal Keypad (DECPNM) == C<< ESC > >>
=end table
B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option>
B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >>
B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >>
- B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (@@RXVTNAME@@ extension)
- B<< C<Ps = 702> >> find font for character, used for debugging (@@RXVTNAME@@ extension)
- B<< C<Ps = 703> >> command B<< C<Pt> >> I<rxvt compile-time option> (@@RXVTNAME@@ extension)
+ B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (@@RXVT_NAME@@ extension)
+ B<< C<Ps = 702> >> find font for character, used for debugging (@@RXVT_NAME@@ extension)
+ B<< C<Ps = 703> >> command B<< C<Pt> >> I<rxvt compile-time option> (@@RXVT_NAME@@ extension)
=end table
=back
X<KeyCodes>
-=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<Shift> + B<F1>-B<F10> generates B<F11>-B<F20>
=end table
+=head1 AUTHORS
+
+Marc Lehmann <rxvt@schmorp.de>, converted this document to pod and
+reworked it from the original Rxvt documentation, which was done by Geoff
+Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other
+sources.
+
+++ /dev/null
-.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 <rxvt@schmorp\&.de>
-.br
-.IP "Web page maintainter"
-Marc A\&. Lehmann <rxvt@schmorp\&.de>
-.br
-<http://www\&.sourceforge\&.net/projects/rxvt-unicode/>
-.br
-.PP
-.SH "AUTHORS"
-.PP
-.IP "John Bovey"
-University of Kent, 1992, wrote the original Xvt\&.
-.IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>"
-very heavily modified Xvt and came up with Rxvt
-.IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>"
-wrote the Greek Keyboard Input (no longer in code)
-.IP "mj olesen <olesen@me\&.QueensU\&.CA>"
-Wrote the menu system\&.
-.br
-Project Coordinator (changes\&.txt 2\&.11 to 2\&.21)
-.IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>"
-Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5)
-.IP "Geoff Wing <gcw@pobox\&.com>"
-Rewrote screen display and text selection routines\&.
-Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode)
-.IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>"
-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
+++ /dev/null
-<HTML>
-<HEAD>
-<TITLE>Rxvt Technical Reference</TITLE>
-</HEAD>
-<FRAMESET COLS="20%,*">
- <FRAME NAME="toc" SRC="rxvtRef-toc.html" >
- <FRAME NAME="main" SRC="rxvtRef.html" >
-</FRAMESET>
-<NOFRAME><BODY>Your browser needs frames</BODY></NOFRAME>
-</HTML>
projects / dana / urxvt.git / commitdiff