ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.txt
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.17 by root, Thu Feb 17 15:07:48 2005 UTC vs.
Revision 1.21 by root, Fri Apr 22 02:09:39 2005 UTC

… …
4 4
5SYNOPSIS 5SYNOPSIS
6 rxvt [options] [-e command [ args ]] 6 rxvt [options] [-e command [ args ]]
7 7
8DESCRIPTION 8DESCRIPTION
9 rxvt-unicode, version 5.2, is a colour vt102 terminal emulator intended 9 rxvt-unicode, version 5.5, is a colour vt102 terminal emulator intended
10 as an *xterm*(1) replacement for users who do not require features such 10 as an *xterm*(1) replacement for users who do not require features such
11 as Tektronix 4014 emulation and toolkit-style configurability. As a 11 as Tektronix 4014 emulation and toolkit-style configurability. As a
12 result, rxvt-unicode uses much less swap space -- a significant 12 result, rxvt-unicode uses much less swap space -- a significant
13 advantage on a machine serving many X sessions. 13 advantage on a machine serving many X sessions.
14 14
… …
334 used or not. 334 used or not.
335 335
336 Here is a short Gtk2-perl snippet that illustrates how this option 336 Here is a short Gtk2-perl snippet that illustrates how this option
337 can be used (a longer example is in doc/embed): 337 can be used (a longer example is in doc/embed):
338 338
339 my $rxvt = new Gtk2::DrawingArea; 339 my $rxvt = new Gtk2::Socket;
340 $...->add ($rxvt); # important to add it somewhere first 340 $rxvt->signal_connect_after (realize => sub {
341 $rxvt->realize; # now it can be realized
342 my $xid = $rxvt->window->get_xid; 341 my $xid = $_[0]->window->get_xid;
343
344 system "rxvt -embed $xid &"; 342 system "rxvt -embed $xid &";
343 });
345 344
346 -pty-fd *fileno* 345 -pty-fd *fileno*
347 Tells rxvt NOT to execute any commands or create a new pty/tty pair 346 Tells rxvt NOT to execute any commands or create a new pty/tty pair
348 but instead use the given filehandle as the tty master. This is 347 but instead use the given filehandle as the tty master. This is
349 useful if you want to drive rxvt as a generic terminal emulator 348 useful if you want to drive rxvt as a generic terminal emulator
… …
359 use IO::Pty; 358 use IO::Pty;
360 use Fcntl; 359 use Fcntl;
361 360
362 my $pty = new IO::Pty; 361 my $pty = new IO::Pty;
363 fcntl $pty, F_SETFD, 0; # clear close-on-exec 362 fcntl $pty, F_SETFD, 0; # clear close-on-exec
364
365 system "rxvt -pty-fd " . (fileno $pty) . "&"; 363 system "rxvt -pty-fd " . (fileno $pty) . "&";
364 close $pty;
366 365
367 # now communicate with rxvt 366 # now communicate with rxvt
368 my $slave = $pty->slave; 367 my $slave = $pty->slave;
369 while (<$slave>) { print $slave "got <$_>\n" } 368 while (<$slave>) { print $slave "got <$_>\n" }
370 369
… …
698 pointerColor2: *colour* 697 pointerColor2: *colour*
699 Mouse pointer background colour. 698 Mouse pointer background colour.
700 699
701 pointerBlankDelay: *number* 700 pointerBlankDelay: *number*
702 Specifies number of seconds before blanking the pointer [default 2]. 701 Specifies number of seconds before blanking the pointer [default 2].
702 Use a large number (e.g. 987654321) to effectively disable the
703 timeout.
703 704
704 backspacekey: *string* 705 backspacekey: *string*
705 The string to send when the backspace key is pressed. If set to DEC 706 The string to send when the backspace key is pressed. If set to DEC
706 or unset it will send Delete (code 127) or, if shifted, Backspace 707 or unset it will send Delete (code 127) or, if shifted, Backspace
707 (code 8) - which can be reversed with the appropriate DEC private 708 (code 8) - which can be reversed with the appropriate DEC private
… …
823 is interpreted and executed as rxvt's control sequence. For example 824 is interpreted and executed as rxvt's control sequence. For example
824 the following means "change the current locale to "zh_CN.GBK" when 825 the following means "change the current locale to "zh_CN.GBK" when
825 Control-Meta-c is being pressed": 826 Control-Meta-c is being pressed":
826 827
827 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 828 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
829
830 Due the the large number of modifier combinations, a defined key
831 mapping will match if at *at least* the specified identifiers are
832 being set, and no other key mappings with those and more bits are
833 being defined. That means that defining a key map for "a" will
834 automatically provide definitions for "Meta-a", "Shift-a" and so on,
835 unless some of those are defined mappings themselves.
836
837 Unfortunately, this will override built-in key mappings. For example
838 if you overwrite the "Insert" key you will disable rxvt's
839 "Shift-Insert" mapping. To re-enable that, you can poke "holes" into
840 the user-defined keymap using the "builtin:" replacement:
841
842 URxvt.keysym.Insert: <my insert key sequence>
843 URxvt.keysym.S-Insert: builtin:
844
845 The first line defines a mapping for "Insert" and *any* combination
846 of modifiers. The second line re-establishes the default mapping for
847 "Shift-Insert".
828 848
829 The following example will map Control-Meta-1 and Control-Meta-2 to 849 The following example will map Control-Meta-1 and Control-Meta-2 to
830 the fonts "suxuseuro" and "9x15bold", so you can have some limited 850 the fonts "suxuseuro" and "9x15bold", so you can have some limited
831 font-switching at runtime: 851 font-switching at runtime:
832 852

Diff Legend

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