--- rxvt-unicode/doc/rxvt.1.html 2005/02/11 18:14:07 1.11 +++ rxvt-unicode/doc/rxvt.1.html 2005/02/17 15:07:48 1.17 @@ -49,7 +49,7 @@

DESCRIPTION

-

rxvt-unicode, version 5.0, is a colour vt102 terminal +

rxvt-unicode, version 5.2, 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 -- @@ -513,18 +513,86 @@ secondaryScroll.

-
-keysym.sym: string
+
-keysym.sym string
Remap a key symbol. See resource keysym.

-
-xrm resourcestring
+
-embed windowid
-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. +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.

+
+
+

The window will not be destroyed when rxvt exits.

+
+
+

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.

+
+
+

Here is a short Gtk2-perl snippet that illustrates how this option can be +used (a longer example is in doc/embed):

+
+
+
+   my $rxvt = new Gtk2::DrawingArea;
+   $...->add ($rxvt); # important to add it somewhere first
+   $rxvt->realize; # now it can be realized
+   my $xid = $rxvt->window->get_xid;
+
+
+
+   system "rxvt -embed $xid &";
+
+

+
-pty-fd fileno
+
+
+Tells rxvt NOT to execute any commands or create a new pty/tty +pair but instead use the given filehandle as the tty master. This is +useful if you want to drive rxvt as a generic terminal emulator +without having to run a program within it. +
+
+

If this switch is given, rxvt 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.

+
+
+

Here is a example in perl that illustrates how this option can be used (a +longer example is in doc/pty-fd):

+
+
+
+   use IO::Pty;
+   use Fcntl;
+
+
+
+   my $pty = new IO::Pty;
+   fcntl $pty, F_SETFD, 0; # clear close-on-exec
+
+
+
+   system "rxvt -pty-fd " . (fileno $pty) . "&";
+
+
+
+   # now communicate with rxvt
+   my $slave = $pty->slave;
+   while (<$slave>) { print $slave "got <$_>\n" }

@@ -928,8 +996,8 @@

True: scroll with scrollback buffer when tty receives new lines (and -scrollTtyOutput is False); option +sw. False: do not scroll -with scrollback buffer when tty recieves new lines; option -sw. +scrollTtyOutput is False); option -sw. False: do not scroll +with scrollback buffer when tty recieves new lines; option +sw.

scrollTtyKeypress: boolean
@@ -1443,8 +1511,8 @@ default to indicate that the default-colour escape sequence is to be used), bg is the colour code used as default background colour (or the string default), and xpm is the string default if rxvt -was compiled with XPM support. Libraries like slang can (and do) use -this information to optimize screen output. +was compiled with XPM support. Libraries like ncurses and slang can +(and do) use this information to optimize screen output.

WINDOWID
@@ -1550,10 +1618,10 @@
Project Coordinator
-Marc A. Lehmann rxvt@schmorp.de +Marc A. Lehmann >
-

http://software.schmorp.de/

+

http://software.schmorp.de/#rxvt-unicode

@@ -1601,7 +1669,7 @@ (changes.txt 2.4.6 - rxvt-unicode)

-
Marc Alexander Lehmann >
+
Marc Alexander Lehmann >
Forked rxvt-unicode, rewrote most of the display code and internal