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.64 by root, Fri Jun 17 12:05:31 2005 UTC

… …
238 238
239Put scrollbar on right/left; resource B<scrollBar_right>. 239Put scrollbar on right/left; resource B<scrollBar_right>.
240 240
241=item B<-st>|B<+st> 241=item B<-st>|B<+st>
242 242
243Display normal (non XTerm/NeXT) scrollbar without/with a trough; 243Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
244resource B<scrollBar_floating>. 244resource B<scrollBar_floating>.
245 245
246=item B<-ptab>|B<+ptab> 246=item B<-ptab>|B<+ptab>
247 247
248If enabled (default), "Horizontal Tab" characters are being stored as 248If enabled (default), "Horizontal Tab" characters are being stored as
… …
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
… …
567Use the specified colour for the scrollbar [default #B2B2B2]. 566Use the specified colour for the scrollbar [default #B2B2B2].
568 567
569=item B<troughColor:> I<colour> 568=item B<troughColor:> I<colour>
570 569
571Use the specified colour for the scrollbar's trough area [default 570Use the specified colour for the scrollbar's trough area [default
572#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. 571#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
573 572
574=item B<borderColor:> I<colour> 573=item B<borderColor:> I<colour>
575 574
576The colour of the border around the text area and between the scrollbar 575The colour of the border around the text area and between the scrollbar
577and the text. 576and the text.
… …
669xterm style selection. 668xterm style selection.
670 669
671=item B<scrollstyle:> I<mode> 670=item B<scrollstyle:> I<mode>
672 671
673Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is 672Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
674the author's favourite.. 673the author's favourite.
675 674
676=item B<title:> I<string> 675=item B<title:> I<string>
677 676
678Set window title string, the default title is the command-line 677Set window title string, the default title is the command-line
679specified after the B<-e> option, if any, otherwise the application 678specified after the B<-e> option, if any, otherwise the application
… …
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