9.22-maybe

4 files changed, 4989 insertions, 0 deletions

diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in
new file mode 100644
index 0000000..1f285e5
--- /dev/null
+++ b/doc/rxvt.1.man.in
@@ -0,0 +1,1806 @@
+.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+.    ds C`
+.    ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{
+.    if \nF \{
+.        de IX
+.        tm Index:\\$1\t\\n%\t"\\$2"
+..
+.        if !\nF==2 \{
+.            nr % 0
+.            nr F 2
+.        \}
+.    \}
+.\}
+.rr rF
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "@@RXVT_NAME@@ 1"
+.TH @@RXVT_NAME@@ 1 "2016-01-23" "@@RXVT_VERSION@@" "RXVT-UNICODE"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]]
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+\&\fBrxvt-unicode\fR, version \fB@@RXVT_VERSION@@\fR, is a colour vt102 terminal
+emulator intended as an \fIxterm\fR(1) replacement for users who do not
+require features such as Tektronix 4014 emulation and toolkit-style
+configurability. As a result, \fBrxvt-unicode\fR uses much less swap space \*(--
+a significant advantage on a machine serving many X sessions.
+.PP
+This document is also available on the World-Wide-Web at
+<http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.1.pod>.
+.SH "FREQUENTLY ASKED QUESTIONS"
+.IX Header "FREQUENTLY ASKED QUESTIONS"
+See @@RXVT_NAME@@(7) (try \f(CW\*(C`man 7 @@RXVT_NAME@@\*(C'\fR) for a list of
+frequently asked questions and answer to them and some common
+problems. That document is also accessible on the World-Wide-Web at
+<http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.7.pod>.
+.SH "RXVT-UNICODE VS. RXVT"
+.IX Header "RXVT-UNICODE VS. RXVT"
+Unlike the original rxvt, \fBrxvt-unicode\fR stores all text in Unicode
+internally. That means it can store and display most scripts in the
+world. Being a terminal emulator, however, some things are very difficult,
+especially cursive scripts such as arabic, vertically written scripts
+like mongolian or scripts requiring extremely complex combining rules,
+like tibetan or devanagari. Don't expect pretty output when using these
+scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work
+fine, though. A somewhat difficult case are right-to-left scripts, such
+as hebrew: \fBrxvt-unicode\fR adopts the view that bidirectional algorithms
+belong in the application, not the terminal emulator (too many things \*(--
+such as cursor-movement while editing \*(-- break otherwise), but that might
+change.
+.PP
+If you are looking for a terminal that supports more exotic scripts, let
+me recommend \f(CW\*(C`mlterm\*(C'\fR, which is a very user friendly, lean and clean
+terminal emulator. In fact, the reason rxvt-unicode was born was solely
+because the author couldn't get \f(CW\*(C`mlterm\*(C'\fR to use one font for latin1 and
+another for japanese.
+.PP
+Therefore another design rationale was the use of multiple fonts to
+display characters: The idea of a single unicode font which many other
+programs force onto its users never made sense to me: You should be able
+to choose any font for any script freely.
+.PP
+Apart from that, rxvt-unicode is also much better internationalised than
+its predecessor, supports things such as \s-1XFT\s0 and \s-1ISO 14755\s0 that are handy
+in i18n\-environments, is faster, and has a lot bugs less than the original
+rxvt. This all in addition to dozens of other small improvements.
+.PP
+It is still faithfully following the original rxvt idea of being lean
+and nice on resources: for example, you can still configure rxvt-unicode
+without most of its features to get a lean binary. It also comes with
+a client/daemon pair that lets you open any number of terminal windows
+from within a single process, which makes startup time very fast and
+drastically reduces memory usage. See @@RXVT_NAME@@d(1) (daemon) and
+@@RXVT_NAME@@c(1) (client).
+.PP
+It also makes technical information about escape sequences (which have
+been extended) more accessible: see @@RXVT_NAME@@(7) for technical
+reference documentation (escape sequences etc.).
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+The \fB@@RXVT_NAME@@\fR options (mostly a subset of \fIxterm\fR'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_NAME@@ \-h' gives a list of major compile-time options on
+the \fIOptions\fR line. Option descriptions may be prefixed with which
+compile option each is dependent upon. e.g. `Compile \fI\s-1XIM\s0\fR:' requires
+\&\fI\s-1XIM\s0\fR on the \fIOptions\fR line. Note: `@@RXVT_NAME@@ \-help' gives a list of all
+command-line options compiled into your version.
+.PP
+Note that \fB@@RXVT_NAME@@\fR 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_NAME@@ \-\-loginShell \-\-color1
+Orange'.
+.PP
+The following options are available:
+.IP "\fB\-help\fR, \fB\-\-help\fR" 4
+.IX Item "-help, --help"
+Print out a message describing available options.
+.IP "\fB\-display\fR \fIdisplayname\fR" 4
+.IX Item "-display displayname"
+Attempt to open a window on the named X display (the older form \fB\-d\fR
+is still respected. but deprecated). In the absence of this option, the
+display specified by the \fB\s-1DISPLAY\s0\fR environment variable is used.
+.IP "\fB\-depth\fR \fIbitdepth\fR" 4
+.IX Item "-depth bitdepth"
+Compile \fIfrills\fR: Attempt to find a visual with the given bit depth;
+resource \fBdepth\fR.
+.Sp
+[Please note that many X servers (and libXft) are buggy with
+respect to \f(CW\*(C`\-depth 32\*(C'\fR and/or alpha channels, and will cause all sorts
+of graphical corruption. This is harmless, but we can't do anything about
+this, so watch out]
+.IP "\fB\-visual\fR \fIvisualID\fR" 4
+.IX Item "-visual visualID"
+Compile \fIfrills\fR: Use the given visual (see e.g. \f(CW\*(C`xdpyinfo\*(C'\fR for
+possible visual ids) instead of the default, and also allocate a private
+colormap. All visual types except for DirectColor are supported.
+.IP "\fB\-geometry\fR \fIgeom\fR" 4
+.IX Item "-geometry geom"
+Window geometry (\fB\-g\fR still respected); resource \fBgeometry\fR.
+.IP "\fB\-rv\fR|\fB+rv\fR" 4
+.IX Item "-rv|+rv"
+Turn on/off simulated reverse video; resource \fBreverseVideo\fR.
+.IP "\fB\-j\fR|\fB+j\fR" 4
+.IX Item "-j|+j"
+Turn on/off jump scrolling (allow multiple lines per refresh); resource \fBjumpScroll\fR.
+.IP "\fB\-ss\fR|\fB+ss\fR" 4
+.IX Item "-ss|+ss"
+Turn on/off skip scrolling (allow multiple screens per refresh); resource \fBskipScroll\fR.
+.IP "\fB\-fade\fR \fInumber\fR" 4
+.IX Item "-fade number"
+Fade the text by the given percentage when focus is lost. Small values
+fade a little only, 100 completely replaces all colours by the fade
+colour; resource \fBfading\fR.
+.IP "\fB\-fadecolor\fR \fIcolour\fR" 4
+.IX Item "-fadecolor colour"
+Fade to this colour when fading is used (see \fB\-fade\fR). The default colour
+is opaque black. resource \fBfadeColor\fR.
+.IP "\fB\-icon\fR \fIfile\fR" 4
+.IX Item "-icon file"
+Compile \fIpixbuf\fR: Use the specified image as application icon. This
+is used by many window managers, taskbars and pagers to represent the
+application window; resource \fIiconFile\fR.
+.IP "\fB\-bg\fR \fIcolour\fR" 4
+.IX Item "-bg colour"
+Window background colour; resource \fBbackground\fR.
+.IP "\fB\-fg\fR \fIcolour\fR" 4
+.IX Item "-fg colour"
+Window foreground colour; resource \fBforeground\fR.
+.IP "\fB\-cr\fR \fIcolour\fR" 4
+.IX Item "-cr colour"
+The cursor colour; resource \fBcursorColor\fR.
+.IP "\fB\-pr\fR \fIcolour\fR" 4
+.IX Item "-pr colour"
+The mouse pointer foreground colour; resource \fBpointerColor\fR.
+.IP "\fB\-pr2\fR \fIcolour\fR" 4
+.IX Item "-pr2 colour"
+The mouse pointer background colour; resource \fBpointerColor2\fR.
+.IP "\fB\-bd\fR \fIcolour\fR" 4
+.IX Item "-bd colour"
+The colour of the border around the text area and between the scrollbar and the text;
+resource \fBborderColor\fR.
+.IP "\fB\-fn\fR \fIfontlist\fR" 4
+.IX Item "-fn fontlist"
+Select the fonts to be used. This is a comma separated list of font names
+that are checked in order when trying to find glyphs for characters. The
+first font defines the cell size for characters; other fonts might be
+smaller, but not (in general) larger. A (hopefully) reasonable default
+font list is always appended to it. See resource \fBfont\fR for more details.
+.Sp
+In short, to specify an X11 core font, just specify its name or prefix it
+with \f(CW\*(C`x:\*(C'\fR. To specify an XFT-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR,
+e.g.:
+.Sp
+.Vb 2
+\&   @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
+\&   @@RXVT_NAME@@ \-fn "9x15bold,xft:Bitstream Vera Sans Mono"
+.Ve
+.Sp
+See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0
+section of @@RXVT_NAME@@(7).
+.IP "\fB\-fb\fR \fIfontlist\fR" 4
+.IX Item "-fb fontlist"
+Compile \fIfont-styles\fR: The bold font list to use when \fBbold\fR characters
+are to be printed. See resource \fBboldFont\fR for details.
+.IP "\fB\-fi\fR \fIfontlist\fR" 4
+.IX Item "-fi fontlist"
+Compile \fIfont-styles\fR: The italic font list to use when \fIitalic\fR
+characters are to be printed. See resource \fBitalicFont\fR for details.
+.IP "\fB\-fbi\fR \fIfontlist\fR" 4
+.IX Item "-fbi fontlist"
+Compile \fIfont-styles\fR: The bold italic font list to use when \fB\f(BIbold
+italic\fB\fR characters are to be printed. See resource \fBboldItalicFont\fR
+for details.
+.IP "\fB\-is\fR|\fB+is\fR" 4
+.IX Item "-is|+is"
+Compile \fIfont-styles\fR: Bold/Blink font styles imply high intensity
+foreground/background (default). See resource \fBintensityStyles\fR for
+details.
+.IP "\fB\-name\fR \fIname\fR" 4
+.IX Item "-name name"
+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\fR|\fB+ls\fR" 4
+.IX Item "-ls|+ls"
+Start as a login\-shell/sub\-shell; resource \fBloginShell\fR.
+.IP "\fB\-mc\fR \fImilliseconds\fR" 4
+.IX Item "-mc milliseconds"
+Specify the maximum time between multi-click selections.
+.IP "\fB\-ut\fR|\fB+ut\fR" 4
+.IX Item "-ut|+ut"
+Compile \fIutmp\fR: Inhibit/enable writing a utmp entry; resource
+\&\fButmpInhibit\fR.
+.IP "\fB\-vb\fR|\fB+vb\fR" 4
+.IX Item "-vb|+vb"
+Turn on/off visual bell on receipt of a bell character; resource
+\&\fBvisualBell\fR.
+.IP "\fB\-sb\fR|\fB+sb\fR" 4
+.IX Item "-sb|+sb"
+Turn on/off scrollbar; resource \fBscrollBar\fR.
+.IP "\fB\-sr\fR|\fB+sr\fR" 4
+.IX Item "-sr|+sr"
+Put scrollbar on right/left; resource \fBscrollBar_right\fR.
+.IP "\fB\-st\fR|\fB+st\fR" 4
+.IX Item "-st|+st"
+Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
+resource \fBscrollBar_floating\fR.
+.IP "\fB\-si\fR|\fB+si\fR" 4
+.IX Item "-si|+si"
+Turn on/off scroll-to-bottom on \s-1TTY\s0 output inhibit; resource
+\&\fBscrollTtyOutput\fR has opposite effect.
+.IP "\fB\-sk\fR|\fB+sk\fR" 4
+.IX Item "-sk|+sk"
+Turn on/off scroll-to-bottom on keypress; resource
+\&\fBscrollTtyKeypress\fR.
+.IP "\fB\-sw\fR|\fB+sw\fR" 4
+.IX Item "-sw|+sw"
+Turn on/off scrolling with the scrollback buffer as new lines appear.
+This only takes effect if \fB\-si\fR is also given; resource
+\&\fBscrollWithBuffer\fR.
+.IP "\fB\-ptab\fR|\fB+ptab\fR" 4
+.IX Item "-ptab|+ptab"
+If enabled (default), \*(L"Horizontal Tab\*(R" characters are being stored as
+actual wide characters in the screen buffer, which makes it possible to
+select and paste them. Since a horizontal tab is a cursor movement and
+not an actual glyph, this can sometimes be visually annoying as the cursor
+on a tab character is displayed as a wide cursor; resource \fBpastableTabs\fR.
+.IP "\fB\-bc\fR|\fB+bc\fR" 4
+.IX Item "-bc|+bc"
+Blink the cursor; resource \fBcursorBlink\fR.
+.IP "\fB\-uc\fR|\fB+uc\fR" 4
+.IX Item "-uc|+uc"
+Make the cursor underlined; resource \fBcursorUnderline\fR.
+.IP "\fB\-iconic\fR" 4
+.IX Item "-iconic"
+Start iconified, if the window manager supports that option.
+Alternative form is \fB\-ic\fR.
+.IP "\fB\-sl\fR \fInumber\fR" 4
+.IX Item "-sl number"
+Save \fInumber\fR lines in the scrollback buffer. See resource entry for
+limits; resource \fBsaveLines\fR.
+.IP "\fB\-b\fR \fInumber\fR" 4
+.IX Item "-b number"
+Compile \fIfrills\fR: Internal border of \fInumber\fR pixels. See resource
+entry for limits; resource \fBinternalBorder\fR.
+.IP "\fB\-w\fR \fInumber\fR" 4
+.IX Item "-w number"
+Compile \fIfrills\fR: External border of \fInumber\fR pixels. Also, \fB\-bw\fR
+and \fB\-borderwidth\fR. See resource entry for limits; resource
+\&\fBexternalBorder\fR.
+.IP "\fB\-bl\fR" 4
+.IX Item "-bl"
+Compile \fIfrills\fR: Set \s-1MWM\s0 hints to request a borderless window, i.e.
+if honoured by the \s-1WM,\s0 the rxvt-unicode window will not have window
+decorations; resource \fBborderLess\fR. If the window manager does not
+support \s-1MWM\s0 hints (e.g. kwin), enables override-redirect mode.
+.IP "\fB\-override\-redirect\fR" 4
+.IX Item "-override-redirect"
+Compile \fIfrills\fR: Sets override-redirect on the window; resource
+\&\fBoverride-redirect\fR.
+.IP "\fB\-dockapp\fR" 4
+.IX Item "-dockapp"
+Sets the initial state of the window to WithdrawnState, which makes
+window managers that support this extension treat it as a dockapp.
+.IP "\fB\-sbg\fR" 4
+.IX Item "-sbg"
+Compile \fIfrills\fR: Disable the usage of the built-in block graphics/line
+drawing characters and just rely on what the specified fonts provide. Use
+this if you have a good font and want to use its block graphic glyphs;
+resource \fBskipBuiltinGlyphs\fR.
+.IP "\fB\-lsp\fR \fInumber\fR" 4
+.IX Item "-lsp number"
+Compile \fIfrills\fR: Lines (pixel height) to insert between each row of
+the display. Useful to work around font rendering problems; resource
+\&\fBlineSpace\fR.
+.IP "\fB\-letsp\fR \fInumber\fR" 4
+.IX Item "-letsp number"
+Compile \fIfrills\fR: Amount to adjust the computed character width by
+to control overall letter spacing. Negative values will tighten up the
+letter spacing, positive values will space letters out more. Useful to
+work around odd font metrics; resource \fBletterSpace\fR.
+.IP "\fB\-tn\fR \fItermname\fR" 4
+.IX Item "-tn termname"
+This option specifies the name of the terminal type to be set in the
+\&\fB\s-1TERM\s0\fR environment variable. This terminal type must exist in the
+\&\fI\fItermcap\fI\|(5)\fR database and should have \fIli#\fR and \fIco#\fR entries;
+resource \fBtermName\fR.
+.IP "\fB\-e\fR \fIcommand [arguments]\fR" 4
+.IX Item "-e command [arguments]"
+Run the command with its command-line arguments in the \fB@@RXVT_NAME@@\fR
+window; also sets the window title and icon name to be the basename of
+the program being executed if neither \fI\-title\fR (\fI\-T\fR) nor \fI\-n\fR 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\fR option then the default is to
+run the program specified by the \fB\s-1SHELL\s0\fR environment variable or,
+failing that, \fI\fIsh\fI\|(1)\fR.
+.Sp
+Please note that you must specify a program with arguments. If you want to
+run shell commands, you have to specify the shell, like this:
+.Sp
+.Vb 1
+\&  @@RXVT_NAME@@ \-e sh \-c "shell commands"
+.Ve
+.IP "\fB\-title\fR \fItext\fR" 4
+.IX Item "-title text"
+Window title (\fB\-T\fR still respected); the default title is the basename
+of the program specified after the \fB\-e\fR option, if any, otherwise the
+application name; resource \fBtitle\fR.
+.IP "\fB\-n\fR \fItext\fR" 4
+.IX Item "-n text"
+Icon name; the default name is the basename of the program specified
+after the \fB\-e\fR option, if any, otherwise the application name;
+resource \fBiconName\fR.
+.IP "\fB\-C\fR" 4
+.IX Item "-C"
+Capture system console messages.
+.IP "\fB\-pt\fR \fIstyle\fR" 4
+.IX Item "-pt style"
+Compile \fI\s-1XIM\s0\fR: input style for input method; \fBOverTheSpot\fR,
+\&\fBOffTheSpot\fR, \fBRoot\fR; resource \fBpreeditType\fR.
+.Sp
+If the perl extension \f(CW\*(C`xim\-onthespot\*(C'\fR is used (which is the default),
+then additionally the \f(CW\*(C`OnTheSpot\*(C'\fR preedit type is available.
+.IP "\fB\-im\fR \fItext\fR" 4
+.IX Item "-im text"
+Compile \fI\s-1XIM\s0\fR: input method name. resource \fBinputMethod\fR.
+.IP "\fB\-imlocale\fR \fIstring\fR" 4
+.IX Item "-imlocale string"
+The locale to use for opening the \s-1IM.\s0 You can use an \f(CW\*(C`LC_CTYPE\*(C'\fR of e.g.
+\&\f(CW\*(C`de_DE.UTF\-8\*(C'\fR for normal text processing but \f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR for the
+input extension to be able to input japanese characters while staying in
+another locale. resource \fBimLocale\fR.
+.IP "\fB\-imfont\fR \fIfontset\fR" 4
+.IX Item "-imfont fontset"
+Set the font set to use for the X Input Method, see resource \fBimFont\fR
+for more info.
+.IP "\fB\-tcw\fR" 4
+.IX Item "-tcw"
+Change the meaning of triple-click selection with the left mouse
+button. Only effective when the original (non-perl) selection code is
+in-use. Instead of selecting a full line it will extend the selection to
+the end of the logical line only. resource \fBtripleclickwords\fR.
+.IP "\fB\-insecure\fR" 4
+.IX Item "-insecure"
+Enable \*(L"insecure\*(R" mode, which currently enables most of the escape
+sequences that echo strings. See the resource \fBinsecure\fR for more
+info.
+.IP "\fB\-mod\fR \fImodifier\fR" 4
+.IX Item "-mod modifier"
+Override detection of Meta modifier with specified key: \fBalt\fR,
+\&\fBmeta\fR, \fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBmod4\fR,
+\&\fBmod5\fR; resource \fImodifier\fR.
+.IP "\fB\-ssc\fR|\fB+ssc\fR" 4
+.IX Item "-ssc|+ssc"
+Turn on/off secondary screen (default enabled); resource
+\&\fBsecondaryScreen\fR.
+.IP "\fB\-ssr\fR|\fB+ssr\fR" 4
+.IX Item "-ssr|+ssr"
+Turn on/off secondary screen scroll (default enabled); resource
+\&\fBsecondaryScroll\fR.
+.IP "\fB\-hold\fR|\fB+hold\fR" 4
+.IX Item "-hold|+hold"
+Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
+will not immediately destroy its window when the program executed within
+it exits. Instead, it will wait till it is being killed or closed by the
+user; resource \fBhold\fR.
+.IP "\fB\-cd\fR \fIpath\fR" 4
+.IX Item "-cd path"
+Sets the working directory for the shell (or the command specified via
+\&\fB\-e\fR). The \fIpath\fR must be an absolute path and it must exist for
+@@RXVT_NAME@@ to start; resource \fBchdir\fR.
+.IP "\fB\-xrm\fR \fIstring\fR" 4
+.IX Item "-xrm string"
+Works like the X Toolkit option of the same name, by adding the \fIstring\fR
+as if it were specified in a resource file. Resource values specified this
+way take precedence over all other resource specifications.
+.Sp
+Note that you need to use the \fIsame\fR syntax as in the .Xdefaults file,
+e.g. \f(CW\*(C`*.background: black\*(C'\fR. Also note that all @@RXVT_NAME@@\-specific
+options can be specified as long-options on the commandline, so use
+of \fB\-xrm\fR is mostly limited to cases where you want to specify other
+resources (e.g. for input methods) or for compatibility with other
+programs.
+.IP "\fB\-keysym.\fR\fIsym\fR \fIstring\fR" 4
+.IX Item "-keysym.sym string"
+Remap a key symbol. See resource \fBkeysym\fR.
+.IP "\fB\-embed\fR \fIwindowid\fR" 4
+.IX Item "-embed windowid"
+Tells @@RXVT_NAME@@ to embed its windows into an already-existing window,
+which enables applications to easily embed a terminal.
+.Sp
+Right now, @@RXVT_NAME@@ will first unmap/map the specified window, so it
+shouldn't be a top-level window. @@RXVT_NAME@@ will also reconfigure it
+quite a bit, so don't expect it to keep some specific state. It's best to
+create an extra subwindow for @@RXVT_NAME@@ and leave it alone.
+.Sp
+The window will not be destroyed when @@RXVT_NAME@@ exits.
+.Sp
+It might be useful to know that @@RXVT_NAME@@ will not close file
+descriptors passed to it (except for stdin/out/err, of course), so you
+can use file descriptors to communicate with the programs within the
+terminal. This works regardless of whether the \f(CW\*(C`\-embed\*(C'\fR option was used or
+not.
+.Sp
+Here is a short Gtk2\-perl snippet that illustrates how this option can be
+used (a longer example is in \fIdoc/embed\fR):
+.Sp
+.Vb 5
+\&   my $rxvt = new Gtk2::Socket;
+\&   $rxvt\->signal_connect_after (realize => sub {
+\&      my $xid = $_[0]\->window\->get_xid;
+\&      system "@@RXVT_NAME@@ \-embed $xid &";
+\&   });
+.Ve
+.IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4
+.IX Item "-pty-fd file descriptor"
+Tells @@RXVT_NAME@@ \s-1NOT\s0 to execute any commands or create a new pty/tty
+pair but instead use the given file descriptor as the tty master. This is
+useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator
+without having to run a program within it.
+.Sp
+If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp
+entries and will not tinker with pty/tty permissions \- you have to do that
+yourself if you want that.
+.Sp
+As an extremely special case, specifying \f(CW\*(C`\-1\*(C'\fR will completely suppress
+pty/tty operations, which is probably only useful in conjunction with some
+perl extension that manages the terminal.
+.Sp
+Here is a example in perl that illustrates how this option can be used (a
+longer example is in \fIdoc/pty\-fd\fR):
+.Sp
+.Vb 2
+\&   use IO::Pty;
+\&   use Fcntl;
+\&
+\&   my $pty = new IO::Pty;
+\&   fcntl $pty, F_SETFD, 0; # clear close\-on\-exec
+\&   system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&";
+\&   close $pty;
+\&
+\&   # now communicate with rxvt
+\&   my $slave = $pty\->slave;
+\&   while (<$slave>) { print $slave "got <$_>\en" }
+.Ve
+.IP "\fB\-pe\fR \fIstring\fR" 4
+.IX Item "-pe string"
+Comma-separated list of perl extension scripts to use (or not to use) in
+this terminal instance. See resource \fBperl-ext\fR for details.
+.SH "RESOURCES"
+.IX Header "RESOURCES"
+Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long
+options) compiled into your version. All resources are also available as
+long-options.
+.PP
+You can set and change the resources using X11 tools like \fBxrdb\fR. Many
+distribution do also load settings from the \fB~/.Xresources\fR file when X
+starts. @@RXVT_NAME@@ will consult the following files/resources in order,
+with later settings overwriting earlier ones:
+.PP
+.Vb 6
+\&  1. app\-defaults file in $XAPPLRESDIR
+\&  2. $HOME/.Xdefaults
+\&  3. RESOURCE_MANAGER property on root\-window of screen 0
+\&  4. SCREEN_RESOURCES property on root\-window of the current screen
+\&  5. $XENVIRONMENT file OR $HOME/.Xdefaults\-<nodename>
+\&  6. resources specified via \-xrm on the commandline
+.Ve
+.PP
+Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class
+names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources
+common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be easily
+configured, while the class name \fBURxvt\fR allows resources unique to
+\&\fB@@RXVT_NAME@@\fR, to be shared between different \fB@@RXVT_NAME@@\fR
+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 supported (you might want to
+check the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for additional settings by perl
+extensions not documented here):
+.IP "\fBdepth:\fR \fIbitdepth\fR" 4
+.IX Item "depth: bitdepth"
+Compile \fIxft\fR: Attempt to find a visual with the given bit depth;
+option \fB\-depth\fR.
+.IP "\fBbuffered:\fR \fIboolean\fR" 4
+.IX Item "buffered: boolean"
+Compile \fIxft\fR: Turn on/off double-buffering for xft (default enabled).
+On some card/driver combination enabling it slightly decreases
+performance, on most it greatly helps it. The slowdown is small, so it
+should normally be enabled.
+.IP "\fBgeometry:\fR \fIgeom\fR" 4
+.IX Item "geometry: geom"
+Create the window with the specified X window geometry [default 80x24];
+option \fB\-geometry\fR.
+.IP "\fBbackground:\fR \fIcolour\fR" 4
+.IX Item "background: colour"
+Use the specified colour as the window's background colour [default
+White]; option \fB\-bg\fR.
+.IP "\fBforeground:\fR \fIcolour\fR" 4
+.IX Item "foreground: colour"
+Use the specified colour as the window's foreground colour [default
+Black]; option \fB\-fg\fR.
+.IP "\fBcolor\fR\fIn\fR\fB:\fR \fIcolour\fR" 4
+.IX Item "colorn: colour"
+Use the specified colour for the colour value \fIn\fR, 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 \fB\s-1COLOURS AND GRAPHICS\s0\fR section.
+.Sp
+Colours higher than 15 cannot be set using resources (yet), but can be
+changed using an escape command (see @@RXVT_NAME@@(7)).
+.Sp
+Colours 16\-79 form a standard 4x4x4 colour cube (the same as xterm with
+88 colour support). Colours 80\-87 are evenly spaces grey steps.
+.IP "\fBcolorBD:\fR \fIcolour\fR" 4
+.IX Item "colorBD: colour"
+.PD 0
+.IP "\fBcolorIT:\fR \fIcolour\fR" 4
+.IX Item "colorIT: colour"
+.PD
+Use the specified colour to display bold or italic characters when the
+foreground colour is the default. If font styles are not available
+(Compile \fIstyles\fR) and this option is unset, reverse video is used instead.
+.IP "\fBcolorUL:\fR \fIcolour\fR" 4
+.IX Item "colorUL: colour"
+Use the specified colour to display underlined characters when the
+foreground colour is the default.
+.IP "\fBunderlineColor:\fR \fIcolour\fR" 4
+.IX Item "underlineColor: colour"
+If set, use the specified colour as the colour for the underline
+itself. If unset, use the foreground colour.
+.IP "\fBhighlightColor:\fR \fIcolour\fR" 4
+.IX Item "highlightColor: colour"
+If set, use the specified colour as the background for highlighted
+characters. If unset, use reverse video.
+.IP "\fBhighlightTextColor:\fR \fIcolour\fR" 4
+.IX Item "highlightTextColor: colour"
+If set and highlightColor is set, use the specified colour as the
+foreground for highlighted characters.
+.IP "\fBcursorColor:\fR \fIcolour\fR" 4
+.IX Item "cursorColor: colour"
+Use the specified colour for the cursor. The default is to use the
+foreground colour; option \fB\-cr\fR.
+.IP "\fBcursorColor2:\fR \fIcolour\fR" 4
+.IX Item "cursorColor2: colour"
+Use the specified colour for the colour of the cursor text. For this to
+take effect, \fBcursorColor\fR must also be specified. The default is to
+use the background colour.
+.IP "\fBreverseVideo:\fR \fIboolean\fR" 4
+.IX Item "reverseVideo: boolean"
+\&\fBTrue\fR: simulate reverse video by foreground and background colours;
+option \fB\-rv\fR. \fBFalse\fR: regular screen colours [default]; option
+\&\fB+rv\fR. See note in \fB\s-1COLOURS AND GRAPHICS\s0\fR section.
+.IP "\fBjumpScroll:\fR \fIboolean\fR" 4
+.IX Item "jumpScroll: boolean"
+\&\fBTrue\fR: specify that jump scrolling should be used. When receiving lots
+of lines, @@RXVT_NAME@@ will only scroll once a whole screen height of lines
+has been read, resulting in fewer updates while still displaying every
+received line; option \fB\-j\fR.
+.Sp
+\&\fBFalse\fR: specify that smooth scrolling should be used. @@RXVT_NAME@@ will
+force a screen refresh on each new line it received; option \fB+j\fR.
+.IP "\fBskipScroll:\fR \fIboolean\fR" 4
+.IX Item "skipScroll: boolean"
+\&\fBTrue\fR: (the default) specify that skip scrolling should be used. When
+receiving lots of lines, @@RXVT_NAME@@ will only scroll once in a while
+(around 60 times per second), resulting in far fewer updates. This can
+result in @@RXVT_NAME@@ not ever displaying some of the lines it receives;
+option \fB\-ss\fR.
+.Sp
+\&\fBFalse\fR: specify that everything is to be displayed, even
+if the refresh is too fast for the human eye to read anything (or the
+monitor to display anything); option \fB+ss\fR.
+.IP "\fBfading:\fR \fInumber\fR" 4
+.IX Item "fading: number"
+Fade the text by the given percentage when focus is lost; option \fB\-fade\fR.
+.IP "\fBfadeColor:\fR \fIcolour\fR" 4
+.IX Item "fadeColor: colour"
+Fade to this colour, when fading is used (see \fBfading:\fR). The default
+colour is black; option \fB\-fadecolor\fR.
+.IP "\fBiconFile:\fR \fIfile\fR" 4
+.IX Item "iconFile: file"
+Set the application icon pixmap; option \fB\-icon\fR.
+.IP "\fBscrollColor:\fR \fIcolour\fR" 4
+.IX Item "scrollColor: colour"
+Use the specified colour for the scrollbar [default #B2B2B2].
+.IP "\fBtroughColor:\fR \fIcolour\fR" 4
+.IX Item "troughColor: colour"
+Use the specified colour for the scrollbar's trough area [default
+#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
+.IP "\fBborderColor:\fR \fIcolour\fR" 4
+.IX Item "borderColor: colour"
+The colour of the border around the text area and between the scrollbar
+and the text.
+.IP "\fBfont:\fR \fIfontlist\fR" 4
+.IX Item "font: fontlist"
+Select the fonts to be used. This is a comma separated list of font names
+that are checked in order when trying to find glyphs for characters. The
+first font defines the cell size for characters; other fonts might be
+smaller, but not (in general) larger. A (hopefully) reasonable default
+font list is always appended to it; option \fB\-fn\fR.
+.Sp
+Each font can either be a standard X11 core font (\s-1XLFD\s0) name, with
+optional prefix \f(CW\*(C`x:\*(C'\fR or a Xft font (Compile \fIxft\fR), prefixed with \f(CW\*(C`xft:\*(C'\fR.
+.Sp
+In addition, each font can be prefixed with additional hints and
+specifications enclosed in square brackets (\f(CW\*(C`[]\*(C'\fR). The only available
+hint currently is \f(CW\*(C`codeset=codeset\-name\*(C'\fR, and this is only used for Xft
+fonts.
+.Sp
+For example, this font resource
+.Sp
+.Vb 5
+\&   URxvt.font: 9x15bold,\e
+\&               \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e
+\&               \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e
+\&               [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e
+\&               xft:Code2000:antialias=false
+.Ve
+.Sp
+specifies five fonts to be used. The first one is \f(CW\*(C`9x15bold\*(C'\fR (actually
+the iso8859\-1 version of the second font), which is the base font (because
+it is named first) and thus defines the character cell grid to be 9 pixels
+wide and 15 pixels high.
+.Sp
+The second font is just used to add additional unicode characters not in
+the base font, likewise the third, which is unfortunately non-bold, but
+the bold version of the font does contain fewer characters, so this is a
+useful supplement.
+.Sp
+The third font is an Xft font with aliasing turned off, and the characters
+are limited to the \fB\s-1JIS 0208\s0\fR codeset (i.e. japanese kanji). The font
+contains other characters, but we are not interested in them.
+.Sp
+The last font is a useful catch-all font that supplies most of the
+remaining unicode characters.
+.IP "\fBboldFont:\fR \fIfontlist\fR" 4
+.IX Item "boldFont: fontlist"
+.PD 0
+.IP "\fBitalicFont:\fR \fIfontlist\fR" 4
+.IX Item "italicFont: fontlist"
+.IP "\fBboldItalicFont:\fR \fIfontlist\fR" 4
+.IX Item "boldItalicFont: fontlist"
+.PD
+The font list to use for displaying \fBbold\fR, \fIitalic\fR or \fB\f(BIbold
+italic\fB\fR characters, respectively.
+.Sp
+If specified and non-empty, then the syntax is the same as for the
+\&\fBfont\fR\-resource, and the given font list will be used as is, which makes
+it possible to substitute completely different font styles for bold and
+italic.
+.Sp
+If unset (the default), a suitable font list will be synthesized by
+\&\*(L"morphing\*(R" the normal text font list into the desired shape. If that is
+not possible, replacement fonts of the desired shape will be tried.
+.Sp
+If set, but empty, then this specific style is disabled and the normal
+text font will being used for the given style.
+.IP "\fBintensityStyles:\fR \fIboolean\fR" 4
+.IX Item "intensityStyles: boolean"
+When font styles are not enabled, or this option is enabled (\fBTrue\fR,
+option \fB\-is\fR, the default), bold/blink font styles imply high
+intensity foreground/background colours. Disabling this option (\fBFalse\fR,
+option \fB+is\fR) disables this behaviour, the high intensity colours are not
+reachable.
+.IP "\fBtitle:\fR \fIstring\fR" 4
+.IX Item "title: string"
+Set window title string, the default title is the command-line
+specified after the \fB\-e\fR option, if any, otherwise the application
+name; option \fB\-title\fR.
+.IP "\fBiconName:\fR \fIstring\fR" 4
+.IX Item "iconName: string"
+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\fR.
+.IP "\fBmapAlert:\fR \fIboolean\fR" 4
+.IX Item "mapAlert: boolean"
+\&\fBTrue\fR: de-iconify (map) on receipt of a bell character. \fBFalse\fR: no
+de-iconify (map) on receipt of a bell character [default].
+.IP "\fBurgentOnBell:\fR \fIboolean\fR" 4
+.IX Item "urgentOnBell: boolean"
+\&\fBTrue\fR: set the urgency hint for the wm on receipt of a bell character.
+\&\fBFalse\fR: do not set the urgency hint [default].
+.Sp
+@@RXVT_NAME@@ resets the urgency hint on every focus change.
+.IP "\fBvisualBell:\fR \fIboolean\fR" 4
+.IX Item "visualBell: boolean"
+\&\fBTrue\fR: use visual bell on receipt of a bell character; option \fB\-vb\fR.
+\&\fBFalse\fR: no visual bell [default]; option \fB+vb\fR.
+.IP "\fBloginShell:\fR \fIboolean\fR" 4
+.IX Item "loginShell: boolean"
+\&\fBTrue\fR: start as a login shell by prepending a `\-' to \fBargv[0]\fR of
+the shell; option \fB\-ls\fR. \fBFalse\fR: start as a normal sub-shell
+[default]; option \fB+ls\fR.
+.IP "\fBmultiClickTime:\fR \fInumber\fR" 4
+.IX Item "multiClickTime: number"
+Specify the maximum time in milliseconds between multi-click select
+events. The default is 500 milliseconds; option \fB\-mc\fR.
+.IP "\fButmpInhibit:\fR \fIboolean\fR" 4
+.IX Item "utmpInhibit: boolean"
+\&\fBTrue\fR: inhibit writing record into the system log file \fButmp\fR;
+option \fB\-ut\fR. \fBFalse\fR: write record into the