- fix a bug when parsing fontnames and another one
for empty keymaps which could result in crashes
(Kuang-che Wu).
+ - new option: -embed.
- only warn on X errors, *try* to continue (frills).
- add COPYING back, which got lost somehow.
- after deciding that LSM is dead, remove all traces of it,
I need a termcap file entry.
One reason you might want this is that some distributions or
operating systems still compile some programs using the
- long-obsoleted termcap (Fedora Core's bash is one example) and rely
- on a termcap entry for "rxvt-unicode".
+ long-obsoleted termcap library (Fedora Core's bash is one example)
+ and rely on a termcap entry for "rxvt-unicode".
You could use rxvt's termcap entry with resonable results in many
cases. You can also create a termcap entry by using terminfo's
rxvt-unicode|rxvt-unicode terminal (X Window System):\
:am:bw:eo:km:mi:ms:xn:xo:\
- :co#80:it#8:li#24:\
+ :co#80:it#8:li#24:lm#0:\
:AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
:K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
:RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\
:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\
:ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\
:im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
- :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\
- :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\
- :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\
- :ke=\E[?1l\E>:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\
- :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\
- :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\
- :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\
- :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
+ :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
+ :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
+ :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
+ :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
+ :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
+ :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
+ :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
+ :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
:vs=\E[?25h:
Why does "ls" no longer have coloured output?
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
-<p><strong>rxvt-unicode</strong>, version <strong></strong>, is a colour vt102 terminal
+<p><strong>rxvt-unicode</strong>, version <strong>5.1</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 --
Remap a key symbol. See resource <strong>keysym</strong>.
</dd>
<p></p>
-<dt><strong><a name="item__2dxrm_resourcestring"><strong>-xrm</strong> <em>resourcestring</em></a></strong><br />
+<dt><strong><a name="item__2dembed_3a_windowid"><strong>-embed</strong>: <em>windowid</em></a></strong><br />
</dt>
<dd>
-No effect on rxvt-unicode. Simply passes through an argument to be made
-available in the instance's argument list. Appears in <em>WM_COMMAND</em> in
-some window managers.
+Tells rxvt to embed it's windows into an already-existing window,
+which enables applications to easily embed a terminal.
+</dd>
+<dd>
+<p>Right now, rxvt will first unmap/map the specified window, so it
+shouldn't be a top-level window. rxvt 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 and leave it alone.</p>
+</dd>
+<dd>
+<p>It might be useful to know that rxvt 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 wether the <code>-embed</code> option was used or
+not.</p>
</dd>
<p></p></dl>
<p>
.\" ========================================================================
.\"
.IX Title "rxvt 1"
-.TH rxvt 1 "2005-02-14" "" "RXVT-UNICODE"
+.TH rxvt 1 "2005-02-14" "5.1" "RXVT-UNICODE"
.SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS"
.IP "\fB\-keysym.\fR\fIsym\fR: \fIstring\fR" 4
.IX Item "-keysym.sym: string"
Remap a key symbol. See resource \fBkeysym\fR.
-.IP "\fB\-xrm\fR \fIresourcestring\fR" 4
-.IX Item "-xrm resourcestring"
-No effect on rxvt\-unicode. Simply passes through an argument to be made
-available in the instance's argument list. Appears in \fI\s-1WM_COMMAND\s0\fR in
-some window managers.
+.IP "\fB\-embed\fR: \fIwindowid\fR" 4
+.IX Item "-embed: windowid"
+Tells @@RXVT_NAME@@ to embed it's 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
+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 wether the \f(CW\*(C`\-embed\*(C'\fR option was used or
+not.
.SH "RESOURCES (available also as long\-options)"
.IX Header "RESOURCES (available also as long-options)"
Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long
Remap a key symbol. See resource B<keysym>.
-=item B<-xrm> I<resourcestring>
+=item B<-embed>: I<windowid>
-No effect on rxvt-unicode. Simply passes through an argument to be made
-available in the instance's argument list. Appears in I<WM_COMMAND> in
-some window managers.
+Tells @@RXVT_NAME@@ to embed it's windows into an already-existing window,
+which enables applications to easily embed a terminal.
+
+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.
+
+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 wether the C<-embed> option was used or
+not.
=back
rxvt [options] [-e command [ args ]]
DESCRIPTION
- rxvt-unicode, version , 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 advantage on a
- machine serving many X sessions.
+ rxvt-unicode, version 5.1, 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
+ advantage on a machine serving many X sessions.
FREQUENTLY ASKED QUESTIONS
See rxvt(7) (try "man 7 rxvt") for a list of frequently asked questions
-keysym.*sym*: *string*
Remap a key symbol. See resource keysym.
- -xrm *resourcestring*
- No effect on rxvt-unicode. Simply passes through an argument to be
- made available in the instance's argument list. Appears in
- *WM_COMMAND* in some window managers.
+ -embed: *windowid*
+ Tells rxvt to embed it's windows into an already-existing window,
+ which enables applications to easily embed a terminal.
+
+ Right now, rxvt will first unmap/map the specified window, so it
+ shouldn't be a top-level window. rxvt 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 and leave it alone.
+
+ It might be useful to know that rxvt 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 wether the "-embed" option was
+ used or not.
RESOURCES (available also as long-options)
Note: `rxvt --help' gives a list of all resources (long options)