WISH: http://www120.pair.com/mccarthy/nextstep/intro.htmld/Workspace.html is the correct nextstep look.
DUMB: support tex fonts
-7.3
+7.3 Wed Jan 25 22:47:35 CET 2006
- don't let iso14755 or mouse reporting get into the way of perl
(could lead to global grabs never being cleared).
- experimental OnTheSpot editing support (-pe xim-onthespot).
EWMH-hints (pid, utf8 names) and protocols (ping)
seperate underline colour (-underlineColor)
settable border widths and borderless switch (-w, -b, -bl)
+ visual selection (-depth)
settable extra linespacing /-lsp)
iso-14755-2 and -3, and visual feedback
backindex and forwardindex escape sequence
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
-<p><strong>rxvt-unicode</strong>, version <strong>7.2</strong>, is a colour vt102 terminal
+<p><strong>rxvt-unicode</strong>, version <strong>7.3</strong>, is a colour vt102 terminal
emulator intended as an <em>xterm</em>(1) replacement for users who do not
require features such as Tektronix 4014 emulation and toolkit-style
configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
<strong>DISPLAY</strong> environment variable is used.
</dd>
<p></p>
+<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong><br />
+</dt>
+<dd>
+Compile <em>frills</em>: Attempt to find a visual with the given bit depth;
+resource <strong>depth</strong>.
+</dd>
+<p></p>
<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br />
</dt>
<dd>
check the <code>rxvtperl(3)</code> manpage for additional settings by perl
extensions not documented here):</p>
<dl>
+<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong><br />
+</dt>
+<dd>
+Compile <em>frills</em>: Attempt to find a visual with the given bit depth;
+option <strong>-depth</strong>.
+</dd>
+<p></p>
<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
</dt>
<dd>
<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br />
</dt>
<dd>
-The characters used as delimiters for double-click word selection. The
-built-in default:
+The characters used as delimiters for double-click word selection
+(whitespace delimiting is added automatically if resource is given).
+</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>
+</dd>
+<dd>
+<p>When the selection extension is not used, only ISO-8859-1 characters can
+be used. If not specified, the built-in default is used:</p>
</dd>
<dd>
<p><strong>BACKSLASH ```'&()*,;<=</strong>?@[]{|} >></p>
.\" ========================================================================
.\"
.IX Title "rxvt 1"
-.TH rxvt 1 "2006-01-25" "7.2" "RXVT-UNICODE"
+.TH rxvt 1 "2006-01-25" "7.3" "RXVT-UNICODE"
.SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS"
Attempt to open a window on the named X display (\fB\-d\fR still
respected). 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.
.IP "\fB\-geometry\fR \fIgeom\fR" 4
.IX Item "-geometry geom"
Window geometry (\fB\-g\fR still respected); resource \fBgeometry\fR.
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 \fIfrills\fR: Attempt to find a visual with the given bit depth;
+option \fB\-depth\fR.
.IP "\fBgeometry:\fR \fIgeom\fR" 4
.IX Item "geometry: geom"
Create the window with the specified X window geometry [default 80x24];
with the \fBExecute\fR key.
.IP "\fBcutchars:\fR \fIstring\fR" 4
.IX Item "cutchars: string"
-The characters used as delimiters for double-click word selection. The
-built-in default:
+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.
+.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:
.Sp
\&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]{|}\fR
.IP "\fBpreeditType:\fR \fIstyle\fR" 4
rxvt [options] [-e command [ args ]]
DESCRIPTION
- rxvt-unicode, version 7.2, is a colour vt102 terminal emulator intended
+ rxvt-unicode, version 7.3, is a colour vt102 terminal emulator intended
as an *xterm*(1) replacement for users who do not require features such
as Tektronix 4014 emulation and toolkit-style configurability. As a
result, rxvt-unicode uses much less swap space -- a significant
respected). In the absence of this option, the display specified by
the DISPLAY environment variable is used.
+ -depth *bitdepth*
+ Compile *frills*: Attempt to find a visual with the given bit depth;
+ resource depth.
+
-geometry *geom*
Window geometry (-g still respected); resource geometry.
the rxvtperl(3) manpage for additional settings by perl extensions not
documented here):
+ depth: *bitdepth*
+ Compile *frills*: Attempt to find a visual with the given bit depth;
+ option -depth.
+
geometry: *geom*
Create the window with the specified X window geometry [default
80x24]; option -geometry.
associated with the Execute key.
cutchars: *string*
- The characters used as delimiters for double-click word selection.
- The built-in default:
+ 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
+ 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.
+
+ When the selection extension is not used, only ISO-8859-1 characters
+ can be used. If not specified, the built-in default is used:
BACKSLASH `"'&()*,;<=>?@[]{|}
EWMH-hints (pid, utf8 names) and protocols (ping)
seperate underline colour (-underlineColor)
settable border widths and borderless switch (-w, -b, -bl)
+ visual selection (-depth)
settable extra linespacing /-lsp)
iso-14755-2 and -3, and visual feedback
backindex and forwardindex escape sequence
.\" ========================================================================
.\"
.IX Title "rxvt 7"
-.TH rxvt 7 "2006-01-25" "7.2" "RXVT-UNICODE"
+.TH rxvt 7 "2006-01-25" "7.3" "RXVT-UNICODE"
.SH "NAME"
RXVT REFERENCE \- FAQ, command sequences and other background information
.SH "SYNOPSIS"
A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
in combination with other switches) is:
.Sp
-.Vb 17
+.Vb 18
\& MWM-hints
\& EWMH-hints (pid, utf8 names) and protocols (ping)
\& seperate underline colour (-underlineColor)
\& settable border widths and borderless switch (-w, -b, -bl)
+\& visual selection (-depth)
\& settable extra linespacing /-lsp)
\& iso-14755-2 and -3, and visual feedback
\& backindex and forwardindex escape sequence
EWMH-hints (pid, utf8 names) and protocols (ping)
seperate underline colour (-underlineColor)
settable border widths and borderless switch (-w, -b, -bl)
+ visual selection (-depth)
settable extra linespacing /-lsp)
iso-14755-2 and -3, and visual feedback
backindex and forwardindex escape sequence
Displays a digital clock using the built-in overlay.
</dd>
<p></p>
-<dt><strong><a name="item_example_2drefresh_2dhooks">example-refresh-hooks</a></strong><br />
+<dt><strong><a name="item_remote_2dclipboard">remote-clipboard</a></strong><br />
</dt>
<dd>
-Displays a very simple digital clock in the upper right corner of the
-window. Illustrates overwriting the refresh callbacks to create your own
-overlays or changes.
+Somewhat of a misnomer, this extension adds two menu entries to the
+selection popup that allows one ti run external commands to store the
+selection somewhere and fetch it again.
+</dd>
+<dd>
+<p>We use it to implement a ``distributed selection mechanism'', which just
+means that one command uploads the file to a remote server, and another
+reads it.</p>
+</dd>
+<dd>
+<p>The commands can be set using the <code>URxvt.remote-selection.store</code> and
+<code>URxvt.remote-selection.fetch</code> resources. The first should read the
+selection to store from STDIN (always in UTF-8), the second should provide
+the selection data on STDOUT (also in UTF-8).</p>
+</dd>
+<dd>
+<p>The defaults (which are likely useless to you) use rsh and cat:</p>
+</dd>
+<dd>
+<pre>
+ URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
+ URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'</pre>
</dd>
<p></p>
<dt><strong><a name="item_selection_2dpastebin">selection-pastebin</a></strong><br />
<pre>
URxvt.selection-pastebin.url: <a href="http://www.ta-sa.org/files/txt/%">http://www.ta-sa.org/files/txt/%</a></pre>
</dd>
+<p></p>
+<dt><strong><a name="item_example_2drefresh_2dhooks">example-refresh-hooks</a></strong><br />
+</dt>
+<dd>
+Displays a very simple digital clock in the upper right corner of the
+window. Illustrates overwriting the refresh callbacks to create your own
+overlays or changes.
+</dd>
<p></p></dl>
<p>
</p>
Called just after the screen gets redrawn. See <code>on_refresh_begin</code>.
</dd>
<p></p>
-<dt><strong><a name="item_on_keyboard_command__24term_2c__24string">on_keyboard_command $term, $string</a></strong><br />
+<dt><strong><a name="item_on_user_command__24term_2c__24string">on_user_command $term, $string</a></strong><br />
</dt>
<dd>
-Called whenever the user presses a key combination that has a
-<code>perl:string</code> action bound to it (see description of the <strong>keysym</strong>
+Called whenever the a user-configured event is being activated (e.g. via
+a <code>perl:string</code> action bound to a key, see description of the <strong>keysym</strong>
resource in the <code>rxvt(1)</code> manpage).
</dd>
+<dd>
+<p>The event is simply the action string. This interface is assumed to change
+slightly in the future.</p>
+</dd>
<p></p>
<dt><strong><a name="item_on_x_event__24term_2c__24event">on_x_event $term, $event</a></strong><br />
</dt>
.\" ========================================================================
.\"
.IX Title "rxvt 3"
-.TH rxvt 3 "2006-01-25" "7.2" "RXVT-UNICODE"
+.TH rxvt 3 "2006-01-25" "7.3" "RXVT-UNICODE"
.SH "NAME"
@@RXVT_NAME@@perl \- rxvt\-unicode's embedded perl interpreter
.SH "SYNOPSIS"
.IP "digital-clock" 4
.IX Item "digital-clock"
Displays a digital clock using the built-in overlay.
-.IP "example-refresh-hooks" 4
-.IX Item "example-refresh-hooks"
-Displays a very simple digital clock in the upper right corner of the
-window. Illustrates overwriting the refresh callbacks to create your own
-overlays or changes.
+.IP "remote-clipboard" 4
+.IX Item "remote-clipboard"
+Somewhat of a misnomer, this extension adds two menu entries to the
+selection popup that allows one ti run external commands to store the
+selection somewhere and fetch it again.
+.Sp
+We use it to implement a \*(L"distributed selection mechanism\*(R", which just
+means that one command uploads the file to a remote server, and another
+reads it.
+.Sp
+The commands can be set using the \f(CW\*(C`URxvt.remote\-selection.store\*(C'\fR and
+\&\f(CW\*(C`URxvt.remote\-selection.fetch\*(C'\fR resources. The first should read the
+selection to store from \s-1STDIN\s0 (always in \s-1UTF\-8\s0), the second should provide
+the selection data on \s-1STDOUT\s0 (also in \s-1UTF\-8\s0).
+.Sp
+The defaults (which are likely useless to you) use rsh and cat:
+.Sp
+.Vb 2
+\& URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
+\& URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'
+.Ve
.IP "selection-pastebin" 4
.IX Item "selection-pastebin"
This is a little rarely useful extension that Uploads the selection as
.Vb 1
\& URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
.Ve
+.IP "example-refresh-hooks" 4
+.IX Item "example-refresh-hooks"
+Displays a very simple digital clock in the upper right corner of the
+window. Illustrates overwriting the refresh callbacks to create your own
+overlays or changes.
.SH "API DOCUMENTATION"
.IX Header "API DOCUMENTATION"
.Sh "General \s-1API\s0 Considerations"
.el .IP "on_refresh_end \f(CW$term\fR" 4
.IX Item "on_refresh_end $term"
Called just after the screen gets redrawn. See \f(CW\*(C`on_refresh_begin\*(C'\fR.
-.ie n .IP "on_keyboard_command $term\fR, \f(CW$string" 4
-.el .IP "on_keyboard_command \f(CW$term\fR, \f(CW$string\fR" 4
-.IX Item "on_keyboard_command $term, $string"
-Called whenever the user presses a key combination that has a
-\&\f(CW\*(C`perl:string\*(C'\fR action bound to it (see description of the \fBkeysym\fR
+.ie n .IP "on_user_command $term\fR, \f(CW$string" 4
+.el .IP "on_user_command \f(CW$term\fR, \f(CW$string\fR" 4
+.IX Item "on_user_command $term, $string"
+Called whenever the a user-configured event is being activated (e.g. via
+a \f(CW\*(C`perl:string\*(C'\fR action bound to a key, see description of the \fBkeysym\fR
resource in the @@RXVT_NAME@@(1) manpage).
+.Sp
+The event is simply the action string. This interface is assumed to change
+slightly in the future.
.ie n .IP "on_x_event $term\fR, \f(CW$event" 4
.el .IP "on_x_event \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_x_event $term, $event"
digital-clock
Displays a digital clock using the built-in overlay.
- example-refresh-hooks
- Displays a very simple digital clock in the upper right corner of
- the window. Illustrates overwriting the refresh callbacks to create
- your own overlays or changes.
+ remote-clipboard
+ Somewhat of a misnomer, this extension adds two menu entries to the
+ selection popup that allows one ti run external commands to store
+ the selection somewhere and fetch it again.
+
+ We use it to implement a "distributed selection mechanism", which
+ just means that one command uploads the file to a remote server, and
+ another reads it.
+
+ The commands can be set using the "URxvt.remote-selection.store" and
+ "URxvt.remote-selection.fetch" resources. The first should read the
+ selection to store from STDIN (always in UTF-8), the second should
+ provide the selection data on STDOUT (also in UTF-8).
+
+ The defaults (which are likely useless to you) use rsh and cat:
+
+ URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
+ URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'
selection-pastebin
This is a little rarely useful extension that Uploads the selection
URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
+ example-refresh-hooks
+ Displays a very simple digital clock in the upper right corner of
+ the window. Illustrates overwriting the refresh callbacks to create
+ your own overlays or changes.
+
API DOCUMENTATION
General API Considerations
All objects (such as terminals, time watchers etc.) are typical
on_refresh_end $term
Called just after the screen gets redrawn. See "on_refresh_begin".
- on_keyboard_command $term, $string
- Called whenever the user presses a key combination that has a
- "perl:string" action bound to it (see description of the keysym
- resource in the rxvt(1) manpage).
+ on_user_command $term, $string
+ Called whenever the a user-configured event is being activated (e.g.
+ via a "perl:string" action bound to a key, see description of the
+ keysym resource in the rxvt(1) manpage).
+
+ The event is simply the action string. This interface is assumed to
+ change slightly in the future.
on_x_event $term, $event
Called on every X event received on the vt window (and possibly
netdisp.o: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
netdisp.o: rxvtfont.h rxvtutil.h rxvttoolkit.h iom.h iom_conf.h callback.h
netdisp.o: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+proxy.o: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+proxy.o: optinc.h feature.h encoding.h rxvtfont.h rxvtutil.h rxvttoolkit.h
+proxy.o: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
ptytty.o: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
ptytty.o: optinc.h feature.h encoding.h rxvtfont.h rxvtutil.h rxvttoolkit.h
ptytty.o: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
netdisp.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
netdisp.lo: rxvtfont.h rxvtutil.h rxvttoolkit.h iom.h iom_conf.h callback.h
netdisp.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+proxy.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+proxy.lo: optinc.h feature.h encoding.h rxvtfont.h rxvtutil.h rxvttoolkit.h
+proxy.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
ptytty.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
ptytty.lo: optinc.h feature.h encoding.h rxvtfont.h rxvtutil.h rxvttoolkit.h
ptytty.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
// VERSION _must_ be \d.\d+
#define VERSION "7.3"
-#define DATE "2006-01-22"
+#define DATE "2006-01-25"