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.65 by root, Thu Jun 30 14:00:49 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
… …
710=item B<print-pipe:> I<string> 709=item B<print-pipe:> I<string>
711 710
712Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use 711Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use
713B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or 712B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or
714B<Shift-Print> to include the scrollback as well. 713B<Shift-Print> to include the scrollback as well.
714
715The string will be interpreted as if typed into the shell as-is.
715 716
716=item B<scrollBar:> I<boolean> 717=item B<scrollBar:> I<boolean>
717 718
718B<True>: enable the scrollbar [default]; option B<-sb>. B<False>: 719B<True>: enable the scrollbar [default]; option B<-sb>. B<False>:
719disable the scrollbar; option B<+sb>. 720disable the scrollbar; option B<+sb>.
… …
816 817
817Mouse pointer background colour. 818Mouse pointer background colour.
818 819
819=item B<pointerBlankDelay:> I<number> 820=item B<pointerBlankDelay:> I<number>
820 821
821Specifies number of seconds before blanking the pointer [default 2]. 822Specifies number of seconds before blanking the pointer [default 2]. Use a
823large number (e.g. C<987654321>) to effectively disable the timeout.
822 824
823=item B<backspacekey:> I<string> 825=item B<backspacekey:> I<string>
824 826
825The string to send when the backspace key is pressed. If set to B<DEC> 827The 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> 828or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace>
… …
957is interpreted and executed as @@RXVT_NAME@@'s control sequence. For 959is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
958example the following means "change the current locale to C<zh_CN.GBK> 960example the following means "change the current locale to C<zh_CN.GBK>
959when Control-Meta-c is being pressed": 961when Control-Meta-c is being pressed":
960 962
961 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 963 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
964
965Due the the large number of modifier combinations, a defined key mapping
966will match if at I<at least> the specified identifiers are being set, and
967no other key mappings with those and more bits are being defined. That
968means that defining a key map for C<a> will automatically provide
969definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
970mappings themselves.
971
972Unfortunately, this will override built-in key mappings. For example
973if you overwrite the C<Insert> key you will disable @@RXVT_NAME@@'s
974C<Shift-Insert> mapping. To re-enable that, you can poke "holes" into the
975user-defined keymap using the C<builtin:> replacement:
976
977 URxvt.keysym.Insert: <my insert key sequence>
978 URxvt.keysym.S-Insert: builtin:
979
980The first line defines a mapping for C<Insert> and I<any> combination
981of modifiers. The second line re-establishes the default mapping for
982C<Shift-Insert>.
962 983
963The following example will map Control-Meta-1 and Control-Meta-2 to 984The 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 985the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
965font-switching at runtime: 986font-switching at runtime:
966 987

Diff Legend

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