<li><a href="#resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></li>
<li><a href="#the_scrollbar">THE SCROLLBAR</a></li>
<li><a href="#mouse_reporting">MOUSE REPORTING</a></li>
- <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li>
+ <li><a href="#the_selection__selecting_and_pasting_text">THE SELECTION: SELECTING AND PASTING TEXT</a></li>
<li><a href="#changing_fonts">CHANGING FONTS</a></li>
<li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li>
<li><a href="#login_stamp">LOGIN STAMP</a></li>
<dd>
<p>Change the meaning of triple-click selection with the left mouse
-button. Instead of selecting a full line it will extend the selection the
+button. Only effective when the original (non-perl) selection code is
+in-use. Instead of selecting a full line it will extend the selection the
end of the logical line only. resource <strong>tripleclickwords</strong>.</p>
</dd>
</li>
<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong>
<dd>
-<p>Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is
-xterm style with 2.20 old word selection, or anything else which gives
-xterm style selection.</p>
+<p>Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which
+is xterm style with 2.20 old word selection, or anything else which
+gives xterm style selection. Only effective when the original (non-perl)
+selection code is in use.</p>
</dd>
</li>
<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong>
de-iconify (map) on receipt of a bell character [default].</p>
</dd>
</li>
+<dt><strong><a name="item_urgentonbell_3a_boolean"><strong>urgentOnBell:</strong> <em>boolean</em></a></strong>
+
+<dd>
+<p><strong>True</strong>: set the urgency hint for the wm on receipt of a bell character.
+<strong>False</strong>: do not set the urgency hint [default].</p>
+</dd>
+</li>
<dt><strong><a name="item_visualbell_3a_boolean"><strong>visualBell:</strong> <em>boolean</em></a></strong>
<dd>
(whitespace delimiting is added automatically if resource is given).</p>
</dd>
<dd>
-<p>When the selection extension is in use (the default if compiled in, see
-the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters
-will be created (if the resource exists, otherwise, no regex will be
-created). In this mode, characters outside ISO-8859-1 can be used.</p>
+<p>When the perl selection extension is in use (the default if compiled
+in, see the <code>rxvtperl(3)</code> manpage), a suitable regex using these
+characters will be created (if the resource exists, otherwise, no regex
+will be created). In this mode, characters outside ISO-8859-1 can be used.</p>
</dd>
<dd>
<p>When the selection extension is not used, only ISO-8859-1 characters can
<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong>
<dd>
-<p>Turn on/off secondary screen scroll (default enabled). If the this
+<p>Turn on/off secondary screen scroll (default enabled). If 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.</p>
<p>
</p>
<hr />
-<h1><a name="text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></h1>
-<p>The behaviour of text selection and insertion mechanism is similar to
-<em>xterm</em>(1).</p>
+<h1><a name="the_selection__selecting_and_pasting_text">THE SELECTION: SELECTING AND PASTING TEXT</a></h1>
+<p>The behaviour of text selection and insertion/pasting mechanism is similar
+to <em>xterm</em>(1).</p>
<dl>
-<dt><strong><a name="item_selection_3a"><strong>Selection</strong>:</a></strong>
+<dt><strong><a name="item_selecting_3a"><strong>Selecting</strong>:</a></strong>
<dd>
<p>Left click at the beginning of the region, drag to the end of the region
the selection.</p>
</dd>
</li>
-<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong>
+<dt><strong><a name="item_pasting_3a"><strong>Pasting</strong>:</a></strong>
<dd>
<p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
window causes the value of the PRIMARY selection (or CLIPBOARD with the
-Meta modifier) to be inserted as if it had been typed on the keyboard.</p>
+<strong>Meta</strong> modifier) to be inserted as if it had been typed on the keyboard.</p>
</dd>
<dd>
<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2007-02-17" "8.2" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2007-06-02" "8.2" "RXVT-UNICODE"
.SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS"
.IP "\fB\-tcw\fR" 4
.IX Item "-tcw"
Change the meaning of triple-click selection with the left mouse
-button. Instead of selecting a full line it will extend the selection the
+button. Only effective when the original (non\-perl) selection code is
+in\-use. Instead of selecting a full line it will extend the selection the
end of the logical line only. resource \fBtripleclickwords\fR.
.IP "\fB\-insecure\fR" 4
.IX Item "-insecure"
reachable.
.IP "\fBselectstyle:\fR \fImode\fR" 4
.IX Item "selectstyle: mode"
-Set mouse selection style to \fBold\fR which is 2.20, \fBoldword\fR which is
-xterm style with 2.20 old word selection, or anything else which gives
-xterm style selection.
+Set mouse selection style to \fBold\fR which is 2.20, \fBoldword\fR which
+is xterm style with 2.20 old word selection, or anything else which
+gives xterm style selection. Only effective when the original (non\-perl)
+selection code is in use.
.IP "\fBscrollstyle:\fR \fImode\fR" 4
.IX Item "scrollstyle: mode"
Set scrollbar style to \fBrxvt\fR, \fBplain\fR, \fBnext\fR or \fBxterm\fR. \fBplain\fR is
.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].
.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.
The characters used as delimiters for double-click word selection
(whitespace delimiting is added automatically if resource is given).
.Sp
-When the selection extension is in use (the default if compiled in, see
-the @@RXVT_NAME@@\fIperl\fR\|(3) manpage), a suitable regex using these characters
-will be created (if the resource exists, otherwise, no regex will be
-created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used.
+When the perl selection extension is in use (the default if compiled
+in, see the @@RXVT_NAME@@\fIperl\fR\|(3) manpage), a suitable regex using these
+characters will be created (if the resource exists, otherwise, no regex
+will be created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used.
.Sp
When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can
be used. If not specified, the built-in default is used:
Turn on/off secondary screen (default enabled).
.IP "\fBsecondaryScroll:\fR \fIboolean\fR" 4
.IX Item "secondaryScroll: boolean"
-Turn on/off secondary screen scroll (default enabled). If the this
+Turn on/off secondary screen scroll (default enabled). If 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.
(Next) and \fB\s-1ESC\s0 [ 5 ~\fR (Prior), respectively. Similarly, clicking on the
up and down arrows sends \fB\s-1ESC\s0 [ A\fR (Up) and \fB\s-1ESC\s0 [ B\fR (Down),
respectively.
-.SH "TEXT SELECTION AND INSERTION"
-.IX Header "TEXT SELECTION AND INSERTION"
-The behaviour of text selection and insertion mechanism is similar to
-\&\fIxterm\fR(1).
-.IP "\fBSelection\fR:" 4
-.IX Item "Selection:"
+.SH "THE SELECTION: SELECTING AND PASTING TEXT"
+.IX Header "THE SELECTION: SELECTING AND PASTING TEXT"
+The behaviour of text selection and insertion/pasting mechanism is similar
+to \fIxterm\fR(1).
+.IP "\fBSelecting\fR:" 4
+.IX Item "Selecting:"
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 logical line
normal one. In this mode, every selected row becomes its own line in the
selection, and trailing whitespace is visually underlined and removed from
the selection.
-.IP "\fBInsertion\fR:" 4
-.IX Item "Insertion:"
+.IP "\fBPasting\fR:" 4
+.IX Item "Pasting:"
Pressing and releasing the Middle mouse button in an \fB@@RXVT_NAME@@\fR
window causes the value of the \s-1PRIMARY\s0 selection (or \s-1CLIPBOARD\s0 with the
-Meta modifier) to be inserted as if it had been typed on the keyboard.
+\&\fBMeta\fR modifier) to be inserted as if it had been typed on the keyboard.
.Sp
Pressing \fBShift-Insert\fR causes the value of the \s-1PRIMARY\s0 selection to be
inserted too.
-tcw
Change the meaning of triple-click selection with the left mouse
- button. Instead of selecting a full line it will extend the
+ button. Only effective when the original (non-perl) selection code
+ is in-use. Instead of selecting a full line it will extend the
selection the end of the logical line only. resource
tripleclickwords.
selectstyle: *mode*
Set mouse selection style to old which is 2.20, oldword which is
xterm style with 2.20 old word selection, or anything else which
- gives xterm style selection.
+ gives xterm style selection. Only effective when the original
+ (non-perl) selection code is in use.
scrollstyle: *mode*
Set scrollbar style to rxvt, plain, next or xterm. plain is the
True: de-iconify (map) on receipt of a bell character. False: no
de-iconify (map) on receipt of a bell character [default].
+ urgentOnBell: *boolean*
+ True: set the urgency hint for the wm on receipt of a bell
+ character. False: do not set the urgency hint [default].
+
visualBell: *boolean*
True: use visual bell on receipt of a bell character; option -vb.
False: no visual bell [default]; option +vb.
The characters used as delimiters for double-click word selection
(whitespace delimiting is added automatically if resource is given).
- When the selection extension is in use (the default if compiled in,
- see the rxvtperl(3) manpage), a suitable regex using these
+ When the perl selection extension is in use (the default if compiled
+ in, see the rxvtperl(3) manpage), a suitable regex using these
characters will be created (if the resource exists, otherwise, no
regex will be created). In this mode, characters outside ISO-8859-1
can be used.
Turn on/off secondary screen (default enabled).
secondaryScroll: *boolean*
- Turn on/off secondary screen scroll (default enabled). If the this
+ Turn on/off secondary screen scroll (default enabled). If 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.
(Next) and ESC [ 5 ~ (Prior), respectively. Similarly, clicking on the
up and down arrows sends ESC [ A (Up) and ESC [ B (Down), respectively.
-TEXT SELECTION AND INSERTION
- The behaviour of text selection and insertion mechanism is similar to
- *xterm*(1).
+THE SELECTION: SELECTING AND PASTING TEXT
+ The behaviour of text selection and insertion/pasting mechanism is
+ similar to *xterm*(1).
- Selection:
+ Selecting:
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
the selection, and trailing whitespace is visually underlined and
removed from the selection.
- Insertion:
+ Pasting:
Pressing and releasing the Middle mouse button in an rxvt window
causes the value of the PRIMARY selection (or CLIPBOARD with the
Meta modifier) to be inserted as if it had been typed on the
question) there are two standard values that can be used for
Backspace: <code>^H</code> and <code>^?</code>.</p>
<p>Historically, either value is correct, but rxvt-unicode adopts the debian
-policy of using <code>^?</code> when unsure, because it's the one only only correct
+policy of using <code>^?</code> when unsure, because it's the one and only correct
choice :).</p>
<p>Rxvt-unicode tries to inherit the current stty settings and uses the value
of `erase' to guess the value for backspace. If rxvt-unicode wasn't
<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1>
<p>General hint: if you get compile errors, then likely your configuration
hasn't been tested well. Either try with <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> or use
-the <em>./reconf</em> script as a base for experiments. <em>./reconf</em> is used by
-myself, so it should generally be a working config. Of course, you should
-always report when a combination doesn't work, so it can be fixed. Marc
-Lehmann <<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>>.</p>
+the default configuration (i.e. <code>--enable-xxx</code> or <code>--disable-xxx</code>). Of
+course, you should always report when a combination doesn't work, so it
+can be fixed. Marc Lehmann <<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>>.</p>
<p>All</p>
<dl>
<dt><strong><a name="item__2d_2denable_2deverything">--enable-everything</a></strong>
<pre>
MWM-hints
EWMH-hints (pid, utf8 names) and protocols (ping)
+ urgency hint
seperate underline colour (-underlineColor)
settable border widths and borderless switch (-w, -b, -bl)
visual depth selection (-depth)
settable extra linespacing /-lsp)
- iso-14755-2 and -3, and visual feedback
+ iso-14755 5.1 (basic) support
tripleclickwords (-tcw)
settable insecure mode (-insecure)
keysym remapping support
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 7"
-.TH @@RXVT_NAME@@ 7 "2007-02-17" "8.2" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 7 "2007-06-02" "8.2" "RXVT-UNICODE"
.SH "NAME"
RXVT REFERENCE \- FAQ, command sequences and other background information
.SH "SYNOPSIS"
Backspace: \f(CW\*(C`^H\*(C'\fR and \f(CW\*(C`^?\*(C'\fR.
.PP
Historically, either value is correct, but rxvt-unicode adopts the debian
-policy of using \f(CW\*(C`^?\*(C'\fR when unsure, because it's the one only only correct
+policy of using \f(CW\*(C`^?\*(C'\fR when unsure, because it's the one and only correct
choice :).
.PP
Rxvt-unicode tries to inherit the current stty settings and uses the value
.IX Header "CONFIGURE OPTIONS"
General hint: if you get compile errors, then likely your configuration
hasn't been tested well. Either try with \f(CW\*(C`\-\-enable\-everything\*(C'\fR or use
-the \fI./reconf\fR script as a base for experiments. \fI./reconf\fR is used by
-myself, so it should generally be a working config. Of course, you should
-always report when a combination doesn't work, so it can be fixed. Marc
-Lehmann <rxvt@schmorp.de>.
+the default configuration (i.e. \f(CW\*(C`\-\-enable\-xxx\*(C'\fR or \f(CW\*(C`\-\-disable\-xxx\*(C'\fR). Of
+course, you should always report when a combination doesn't work, so it
+can be fixed. Marc Lehmann <rxvt@schmorp.de>.
.PP
All
.IP "\-\-enable\-everything" 4
A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
in combination with other switches) is:
.Sp
-.Vb 16
+.Vb 17
\& MWM-hints
\& EWMH-hints (pid, utf8 names) and protocols (ping)
+\& urgency hint
\& seperate underline colour (-underlineColor)
\& settable border widths and borderless switch (-w, -b, -bl)
\& visual depth selection (-depth)
\& settable extra linespacing /-lsp)
-\& iso-14755-2 and -3, and visual feedback
+\& iso-14755 5.1 (basic) support
\& tripleclickwords (-tcw)
\& settable insecure mode (-insecure)
\& keysym remapping support
two standard values that can be used for Backspace: "^H" and "^?".
Historically, either value is correct, but rxvt-unicode adopts the
- debian policy of using "^?" when unsure, because it's the one only only
+ debian policy of using "^?" when unsure, because it's the one and only
correct choice :).
Rxvt-unicode tries to inherit the current stty settings and uses the
CONFIGURE OPTIONS
General hint: if you get compile errors, then likely your configuration
hasn't been tested well. Either try with "--enable-everything" or use
- the ./reconf script as a base for experiments. ./reconf is used by
- myself, so it should generally be a working config. Of course, you
- should always report when a combination doesn't work, so it can be
- fixed. Marc Lehmann <rxvt@schmorp.de>.
+ the default configuration (i.e. "--enable-xxx" or "--disable-xxx"). Of
+ course, you should always report when a combination doesn't work, so it
+ can be fixed. Marc Lehmann <rxvt@schmorp.de>.
All
MWM-hints
EWMH-hints (pid, utf8 names) and protocols (ping)
+ urgency hint
seperate underline colour (-underlineColor)
settable border widths and borderless switch (-w, -b, -bl)
visual depth selection (-depth)
settable extra linespacing /-lsp)
- iso-14755-2 and -3, and visual feedback
+ iso-14755 5.1 (basic) support
tripleclickwords (-tcw)
settable insecure mode (-insecure)
keysym remapping support
projects / dana / urxvt.git / commitdiff