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

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

393not. 393not.
394 394
395Here is a short Gtk2-perl snippet that illustrates how this option can be 395Here is a short Gtk2-perl snippet that illustrates how this option can be
396used (a longer example is in F<doc/embed>): 396used (a longer example is in F<doc/embed>):
397 397
398 my $rxvt = new Gtk2::DrawingArea; 398 my $rxvt = new Gtk2::Socket;
399 $...->add ($rxvt); # important to add it somewhere first 399 $rxvt->signal_connect_after (realize => sub {
400 $rxvt->realize; # now it can be realized
401 my $xid = $rxvt->window->get_xid; 400 my $xid = $_[0]->window->get_xid;
402
403 system "@@RXVT_NAME@@ -embed $xid &"; 401 system "@@RXVT_NAME@@ -embed $xid &";
402 });
404 403
405=item B<-pty-fd> I<fileno> 404=item B<-pty-fd> I<fileno>
406 405
407Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty 406Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty
408pair but instead use the given filehandle as the tty master. This is 407pair but instead use the given filehandle as the tty master. This is
419 use IO::Pty; 418 use IO::Pty;
420 use Fcntl; 419 use Fcntl;
421 420
422 my $pty = new IO::Pty; 421 my $pty = new IO::Pty;
423 fcntl $pty, F_SETFD, 0; # clear close-on-exec 422 fcntl $pty, F_SETFD, 0; # clear close-on-exec
424
425 system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&"; 423 system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&";
424 close $pty;
426 425
427 # now communicate with rxvt 426 # now communicate with rxvt
428 my $slave = $pty->slave; 427 my $slave = $pty->slave;
429 while (<$slave>) { print $slave "got <$_>\n" } 428 while (<$slave>) { print $slave "got <$_>\n" }
430 429
816 815
817Mouse pointer background colour. 816Mouse pointer background colour.
818 817
819=item B<pointerBlankDelay:> I<number> 818=item B<pointerBlankDelay:> I<number>
820 819
821Specifies number of seconds before blanking the pointer [default 2]. 820Specifies number of seconds before blanking the pointer [default 2]. Use a
821large number (e.g. C<987654321>) to effectively disable the timeout.
822 822
823=item B<backspacekey:> I<string> 823=item B<backspacekey:> I<string>
824 824
825The string to send when the backspace key is pressed. If set to B<DEC> 825The string to send when the backspace key is pressed. If set to B<DEC>
826or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace> 826or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace>
957is interpreted and executed as @@RXVT_NAME@@'s control sequence. For 957is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
958example the following means "change the current locale to C<zh_CN.GBK> 958example the following means "change the current locale to C<zh_CN.GBK>
959when Control-Meta-c is being pressed": 959when Control-Meta-c is being pressed":
960 960
961 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 961 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
962
963Due the the large number of modifier combinations, a defined key mapping
964will match if at I<at least> the specified identifiers are being set, and
965no other key mappings with those and more bits are being defined. That
966means that defining a key map for C<a> will automatically provide
967definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
968mappings themselves.
969
970Unfortunately, this will override built-in key mappings. For example
971if you overwrite the C<Insert> key you will disable @@RXVT_NAME@@'s
972C<Shift-Insert> mapping. To re-enable that, you can poke "holes" into the
973user-defined keymap using the C<builtin:> replacement:
974
975 URxvt.keysym.Insert: <my insert key sequence>
976 URxvt.keysym.S-Insert: builtin:
977
978The first line defines a mapping for C<Insert> and I<any> combination
979of modifiers. The second line re-establishes the default mapping for
980C<Shift-Insert>.
962 981
963The following example will map Control-Meta-1 and Control-Meta-2 to 982The following example will map Control-Meta-1 and Control-Meta-2 to
964the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited 983the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
965font-switching at runtime: 984font-switching at runtime:
966 985

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines