[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvt.1.txt

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.15 by root, Mon Feb 14 18:50:57 2005 UTC vs.
Revision 1.21 by root, Fri Apr 22 02:09:39 2005 UTC

 SYNOPSIS
     rxvt [options] [-e command [ args ]]
 DESCRIPTION
-    rxvt-unicode, version 5.1, is a colour vt102 terminal emulator intended
+    rxvt-unicode, version 5.5, 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.
     -ssr|+ssr
         Turn on/off secondary screen scroll (default enabled); resource
         secondaryScroll.
-    -keysym.*sym*: *string*
+    -keysym.*sym* *string*
         Remap a key symbol. See resource keysym.
-    -embed: *windowid*
+    -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
         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::Socket;
+           $rxvt->signal_connect_after (realize => sub {
+              my $xid = $_[0]->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)
     compiled into your version.
         True: scroll to bottom when tty receives output; option -si. False:
         do not scroll to bottom when tty receives output; option +si.
     scrollWithBuffer: *boolean*
         True: scroll with scrollback buffer when tty receives new lines (and
-        scrollTtyOutput is False); option +sw. False: do not scroll with
+        scrollTtyOutput is False); option -sw. False: do not scroll with
-        scrollback buffer when tty recieves new lines; option -sw.
+        scrollback buffer when tty recieves new lines; option +sw.
     scrollTtyKeypress: *boolean*
         True: scroll to bottom when a non-special key is pressed. Special
         keys are those which are intercepted by rxvt-unicode for special
         handling and are not passed onto the shell; option -sk. False: do
     pointerColor2: *colour*
         Mouse pointer background colour.
     pointerBlankDelay: *number*
         Specifies number of seconds before blanking the pointer [default 2].
+        Use a large number (e.g. 987654321) to effectively disable the
+        timeout.
     backspacekey: *string*
         The string to send when the backspace key is pressed. If set to DEC
         or unset it will send Delete (code 127) or, if shifted, Backspace
         (code 8) - which can be reversed with the appropriate DEC private
         is interpreted and executed as rxvt's control sequence. For example
         the following means "change the current locale to "zh_CN.GBK" when
         Control-Meta-c is being pressed":
           URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
+        Due the the large number of modifier combinations, a defined key
+        mapping will match if at *at least* the specified identifiers are
+        being set, and no other key mappings with those and more bits are
+        being defined. That means that defining a key map for "a" will
+        automatically provide definitions for "Meta-a", "Shift-a" and so on,
+        unless some of those are defined mappings themselves.
+        Unfortunately, this will override built-in key mappings. For example
+        if you overwrite the "Insert" key you will disable rxvt's
+        "Shift-Insert" mapping. To re-enable that, you can poke "holes" into
+        the user-defined keymap using the "builtin:" replacement:
+          URxvt.keysym.Insert: <my insert key sequence>
+          URxvt.keysym.S-Insert: builtin:
+        The first line defines a mapping for "Insert" and *any* combination
+        of modifiers. The second line re-establishes the default mapping for
+        "Shift-Insert".
         The following example will map Control-Meta-1 and Control-Meta-2 to
         the fonts "suxuseuro" and "9x15bold", so you can have some limited
         font-switching at runtime:

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents): Revision 1.15 by root, Mon Feb 14 18:50:57 2005 UTC vs. Revision 1.21 by root, Fri Apr 22 02:09:39 2005 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.15 by root, Mon Feb 14 18:50:57 2005 UTC vs.
Revision 1.21 by root, Fri Apr 22 02:09:39 2005 UTC