--- rxvt-unicode/doc/rxvt.1.txt	2005/02/13 08:56:27	1.12
+++ rxvt-unicode/doc/rxvt.1.txt	2005/02/18 12:15:07	1.18
@@ -6,7 +6,7 @@
     rxvt [options] [-e command [ args ]]
 
 DESCRIPTION
-    rxvt-unicode, version 5.0, is a colour vt102 terminal emulator intended
+    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 -- a significant
@@ -313,13 +313,60 @@
         Turn on/off secondary screen scroll (default enabled); resource
         secondaryScroll.
 
-    -keysym.*sym*: *string*
+    -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.
+
+        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) . "&";
+           close $pty;
+
+           # now communicate with rxvt
+           my $slave = $pty->slave;
+           while (<$slave>) { print $slave "got <$_>\n" }
 
 RESOURCES (available also as long-options)
     Note: `rxvt --help' gives a list of all resources (long options)
@@ -590,8 +637,8 @@
 
     scrollWithBuffer: *boolean*
         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*
         True: scroll to bottom when a non-special key is pressed. Special
@@ -1027,9 +1074,9 @@
 
 CURRENT PROJECT COORDINATOR
     Project Coordinator
-        Marc A. Lehmann rxvt@schmorp.de
+        Marc A. Lehmann <rxvt-unicode@schmorp.de>
 
-        <http://software.schmorp.de/>
+        <http://software.schmorp.de/#rxvt-unicode>
 
 AUTHORS
     John Bovey
@@ -1053,7 +1100,7 @@
         Rewrote screen display and text selection routines. Project
         Coordinator (changes.txt 2.4.6 - rxvt-unicode)
 
-    Marc Alexander Lehmann <rxvt@schmorp.de>
+    Marc Alexander Lehmann <rxvt-unicode@schmorp.de>
         Forked rxvt-unicode, rewrote most of the display code and internal
         character handling to store text in unicode, improve xterm
         compatibility and apply numerous other bugfixes and extensions.