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.53 by root, Fri Feb 11 18:14:07 2005 UTC vs.
Revision 1.82 by root, Tue Jan 3 18:11:34 2006 UTC

105 105
106=item B<-j>|B<+j> 106=item B<-j>|B<+j>
107 107
108Turn on/off jump scrolling; resource B<jumpScroll>. 108Turn on/off jump scrolling; resource B<jumpScroll>.
109 109
110=item B<-ip>|B<+ip> 110=item B<-ip>|B<+ip> | B<-tr>|B<+tr>
111 111
112Turn on/off inheriting parent window's pixmap. Alternative form is 112Turn on/off inheriting parent window's pixmap. Alternative form is
113B<-tr>; resource B<inheritPixmap>. 113B<-tr>; resource B<inheritPixmap>.
114 114
115=item B<-fade> I<number> 115=item B<-fade> I<number>
116 116
117Fade the text by the given percentage when focus is lost. resource B<fading>. 117Fade the text by the given percentage when focus is lost. Small values
118fade a little only, 100 completely replaces all colours by the fade
119colour; resource B<fading>.
120
121=item B<-fadecolor> I<colour>
122
123Fade to this colour when fading is used (see B<-fade>). The default colour
124is black. resource B<fadeColor>.
118 125
119=item B<-tint> I<colour> 126=item B<-tint> I<colour>
120 127
121Tint the transparent background pixmap with the given colour when 128Tint the transparent background pixmap with the given colour when
122transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> 129transparency is enabled with B<-tr> or B<-ip>. This only works for
123option that can be used to brighten or darken the image in addition to 130non-tiled backgrounds, currently. See also the B<-sh> option that can be
124tinting it. 131used to brighten or darken the image in addition to tinting it; resource
132I<tintColor>. Example:
133
134 @@RXVT_NAME@@ -tr -tint blue -sh 40
125 135
126=item B<-sh> 136=item B<-sh>
127 137
128I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent 138I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent
129background image in addition to tinting it (i.e. B<-tint> must be 139background image in addition to tinting it (i.e. B<-tint> must be
192=item B<-fbi> I<fontlist> 202=item B<-fbi> I<fontlist>
193 203
194Compile font-styles: The bold italic font list to use when bold characters are to 204Compile font-styles: The bold italic font list to use when bold characters are to
195be printed. See resource B<boldItalicFont> for details. 205be printed. See resource B<boldItalicFont> for details.
196 206
207=item B<-is>|B<+is>
208
209Compile font-styles: Bold/Italic font styles imply high intensity
210foreground/background (default). See resource B<intensityStyles> for
211details.
212
197=item B<-name> I<name> 213=item B<-name> I<name>
198 214
199Specify the application name under which resources are to be obtained, 215Specify the application name under which resources are to be obtained,
200rather than the default executable file name. Name should not contain 216rather than the default executable file name. Name should not contain
201`.' or `*' characters. Also sets the icon and title name. 217`.' or `*' characters. Also sets the icon and title name.
238 254
239Put scrollbar on right/left; resource B<scrollBar_right>. 255Put scrollbar on right/left; resource B<scrollBar_right>.
240 256
241=item B<-st>|B<+st> 257=item B<-st>|B<+st>
242 258
243Display normal (non XTerm/NeXT) scrollbar without/with a trough; 259Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
244resource B<scrollBar_floating>. 260resource B<scrollBar_floating>.
245 261
246=item B<-ptab>|B<+ptab> 262=item B<-ptab>|B<+ptab>
247 263
248If enabled (default), "Horizontal Tab" characters are being stored as 264If enabled (default), "Horizontal Tab" characters are being stored as
303given on the command line. If this option is used, it must be the last 319given on the command line. If this option is used, it must be the last
304on the command-line. If there is no B<-e> option then the default is to 320on the command-line. If there is no B<-e> option then the default is to
305run the program specified by the B<SHELL> environment variable or, 321run the program specified by the B<SHELL> environment variable or,
306failing that, I<sh(1)>. 322failing that, I<sh(1)>.
307 323
324Please note that you must specify a program with arguments. If you want to
325run shell commands, you have to specify the shell, like this:
326
327 @@RXVT_NAME@@ -e sh -c "shell commands"
328
308=item B<-title> I<text> 329=item B<-title> I<text>
309 330
310Window title (B<-T> still respected); the default title is the basename 331Window title (B<-T> still respected); the default title is the basename
311of the program specified after the B<-e> option, if any, otherwise the 332of the program specified after the B<-e> option, if any, otherwise the
312application name; resource B<title>. 333application name; resource B<title>.
368=item B<-ssr>|B<+ssr> 389=item B<-ssr>|B<+ssr>
369 390
370Turn on/off secondary screen scroll (default enabled); resource 391Turn on/off secondary screen scroll (default enabled); resource
371B<secondaryScroll>. 392B<secondaryScroll>.
372 393
394=item B<-hold>|B<+hold>
395
396Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
397will not immediately destroy its window when the program executed within
398it exits. Instead, it will wait till it is being killed or closed by the
399user; resource B<hold>.
400
373=item B<-keysym.>I<sym>: I<string> 401=item B<-keysym.>I<sym> I<string>
374 402
375Remap a key symbol. See resource B<keysym>. 403Remap a key symbol. See resource B<keysym>.
376 404
405=item B<-embed> I<windowid>
406
407Tells @@RXVT_NAME@@ to embed it's windows into an already-existing window,
408which enables applications to easily embed a terminal.
409
410Right now, @@RXVT_NAME@@ will first unmap/map the specified window, so it
411shouldn't be a top-level window. @@RXVT_NAME@@ will also reconfigure it
412quite a bit, so don't expect it to keep some specific state. It's best to
413create an extra subwindow for @@RXVT_NAME@@ and leave it alone.
414
415The window will not be destroyed when @@RXVT_NAME@@ exits.
416
417It might be useful to know that @@RXVT_NAME@@ will not close file
418descriptors passed to it (except for stdin/out/err, of course), so you
419can use file descriptors to communicate with the programs within the
420terminal. This works regardless of wether the C<-embed> option was used or
421not.
422
423Here is a short Gtk2-perl snippet that illustrates how this option can be
424used (a longer example is in F<doc/embed>):
425
426 my $rxvt = new Gtk2::Socket;
427 $rxvt->signal_connect_after (realize => sub {
428 my $xid = $_[0]->window->get_xid;
429 system "@@RXVT_NAME@@ -embed $xid &";
430 });
431
432=item B<-pty-fd> I<fileno>
433
434Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty
435pair but instead use the given filehandle as the tty master. This is
436useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator
437without having to run a program within it.
438
439If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp
440entries and will not tinker with pty/tty permissions - you have to do that
441yourself if you want that.
442
443Here is a example in perl that illustrates how this option can be used (a
444longer example is in F<doc/pty-fd>):
445
446 use IO::Pty;
447 use Fcntl;
448
449 my $pty = new IO::Pty;
450 fcntl $pty, F_SETFD, 0; # clear close-on-exec
451 system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&";
452 close $pty;
453
454 # now communicate with rxvt
455 my $slave = $pty->slave;
456 while (<$slave>) { print $slave "got <$_>\n" }
457
377=item B<-xrm> I<resourcestring> 458=item B<-pe> I<string>
378 459
379No effect on rxvt-unicode. Simply passes through an argument to be made 460Colon-separated list of perl extension scripts to use in this terminal instance. See resource B<perl-ext>.
380available in the instance's argument list. Appears in I<WM_COMMAND> in
381some window managers.
382 461
383=back 462=back
384 463
385=head1 RESOURCES (available also as long-options) 464=head1 RESOURCES (available also as long-options)
386 465
501artificial transparency. B<False>: do not inherit the parent windows' 580artificial transparency. B<False>: do not inherit the parent windows'
502pixmap. 581pixmap.
503 582
504=item B<fading:> I<number> 583=item B<fading:> I<number>
505 584
506Fade the text by the given percentage when focus is lost. 585Fade the text by the given percentage when focus is lost; option B<-fade>.
586
587=item B<fadeColor:> I<colour>
588
589Fade to this colour, when fading is used (see B<fading:>). The default
590colour is black; option B<-fadecolor>.
507 591
508=item B<tintColor:> I<colour> 592=item B<tintColor:> I<colour>
509 593
510Tint the transparent background pixmap with the given colour. 594Tint the transparent background pixmap with the given colour; option
595B<-tint>.
511 596
512=item B<shading:> I<number> 597=item B<shading:> I<number>
513 598
514Darken (0 .. 100) or lighten (-1 .. -100) the transparent background 599Darken (0 .. 100) or lighten (-1 .. -100) the transparent background
515image in addition to tinting it. 600image in addition to tinting it.
519Use the specified colour for the scrollbar [default #B2B2B2]. 604Use the specified colour for the scrollbar [default #B2B2B2].
520 605
521=item B<troughColor:> I<colour> 606=item B<troughColor:> I<colour>
522 607
523Use the specified colour for the scrollbar's trough area [default 608Use the specified colour for the scrollbar's trough area [default
524#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. 609#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
525 610
526=item B<borderColor:> I<colour> 611=item B<borderColor:> I<colour>
527 612
528The colour of the border around the text area and between the scrollbar 613The colour of the border around the text area and between the scrollbar
529and the text. 614and the text.
556 641
557Select the fonts to be used. This is a comma separated list of font 642Select the fonts to be used. This is a comma separated list of font
558names that are used in turn when trying to display Unicode characters. 643names that are used in turn when trying to display Unicode characters.
559The first font defines the cell size for characters; other fonts might 644The first font defines the cell size for characters; other fonts might
560be smaller, but not larger. A reasonable default font list is always 645be smaller, but not larger. A reasonable default font list is always
561appended to it. option B<-fn>. 646appended to it; option B<-fn>.
562 647
563Each font can either be a standard X11 core font (XLFD) name, with 648Each font can either be a standard X11 core font (XLFD) name, with
564optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>. 649optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
565 650
566In addition, each font can be prefixed with additional hints and 651In addition, each font can be prefixed with additional hints and
612not possible, replacement fonts of the desired shape will be tried. 697not possible, replacement fonts of the desired shape will be tried.
613 698
614If set, but empty, then this specific style is disabled and the normal 699If set, but empty, then this specific style is disabled and the normal
615text font will being used for the given style. 700text font will being used for the given style.
616 701
702=item B<intensityStyles:> I<boolean>
703
704When font styles are not enabled, or this option is enabled (B<True>,
705option B<-is>, the default), bold and italic font styles imply high
706intensity foreground/backround colours. Disabling this option (B<False>,
707option B<+is>) disables this behaviour, the high intensity colours are not
708reachable.
709
617=item B<selectstyle:> I<mode> 710=item B<selectstyle:> I<mode>
618 711
619Set mouse selection style to B<old> which is 2.20, B<oldword> which is 712Set mouse selection style to B<old> which is 2.20, B<oldword> which is
620xterm style with 2.20 old word selection, or anything else which gives 713xterm style with 2.20 old word selection, or anything else which gives
621xterm style selection. 714xterm style selection.
622 715
623=item B<scrollstyle:> I<mode> 716=item B<scrollstyle:> I<mode>
624 717
625Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is 718Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
626the author's favourite.. 719the author's favourite.
627 720
628=item B<title:> I<string> 721=item B<title:> I<string>
629 722
630Set window title string, the default title is the command-line 723Set window title string, the default title is the command-line
631specified after the B<-e> option, if any, otherwise the application 724specified after the B<-e> option, if any, otherwise the application
663 756
664Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use 757Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use
665B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or 758B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or
666B<Shift-Print> to include the scrollback as well. 759B<Shift-Print> to include the scrollback as well.
667 760
761The string will be interpreted as if typed into the shell as-is.
762
763Example:
764
765 URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
766
767This creates a new file in your home directory with the screen contents
768everytime you hit C<Print>.
769
668=item B<scrollBar:> I<boolean> 770=item B<scrollBar:> I<boolean>
669 771
670B<True>: enable the scrollbar [default]; option B<-sb>. B<False>: 772B<True>: enable the scrollbar [default]; option B<-sb>. B<False>:
671disable the scrollbar; option B<+sb>. 773disable the scrollbar; option B<+sb>.
672 774
692B<+si>. 794B<+si>.
693 795
694=item B<scrollWithBuffer:> I<boolean> 796=item B<scrollWithBuffer:> I<boolean>
695 797
696B<True>: scroll with scrollback buffer when tty receives new lines (and 798B<True>: scroll with scrollback buffer when tty receives new lines (and
697B<scrollTtyOutput> is False); option B<+sw>. B<False>: do not scroll 799B<scrollTtyOutput> is False); option B<-sw>. B<False>: do not scroll
698with scrollback buffer when tty recieves new lines; option B<-sw>. 800with scrollback buffer when tty recieves new lines; option B<+sw>.
699 801
700=item B<scrollTtyKeypress:> I<boolean> 802=item B<scrollTtyKeypress:> I<boolean>
701 803
702B<True>: scroll to bottom when a non-special key is pressed. Special keys 804B<True>: scroll to bottom when a non-special key is pressed. Special keys
703are those which are intercepted by rxvt-unicode for special handling and 805are those which are intercepted by rxvt-unicode for special handling and
768 870
769Mouse pointer background colour. 871Mouse pointer background colour.
770 872
771=item B<pointerBlankDelay:> I<number> 873=item B<pointerBlankDelay:> I<number>
772 874
773Specifies number of seconds before blanking the pointer [default 2]. 875Specifies number of seconds before blanking the pointer [default 2]. Use a
876large number (e.g. C<987654321>) to effectively disable the timeout.
774 877
775=item B<backspacekey:> I<string> 878=item B<backspacekey:> I<string>
776 879
777The string to send when the backspace key is pressed. If set to B<DEC> 880The string to send when the backspace key is pressed. If set to B<DEC>
778or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace> 881or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace>
803=item B<imLocale:> I<name> 906=item B<imLocale:> I<name>
804 907
805The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g. 908The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
806C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the 909C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
807input extension to be able to input japanese characters while staying in 910input extension to be able to input japanese characters while staying in
808another locale. option B<-imlocale>. 911another locale; option B<-imlocale>.
809 912
810=item B<imFont:> I<fontset> 913=item B<imFont:> I<fontset>
811 914
812Specify the font-set used for XIM styles C<OverTheSpot> or 915Specify the font-set used for XIM styles C<OverTheSpot> or
813C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated 916C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated
818 921
819=item B<tripleclickwords:> I<boolean> 922=item B<tripleclickwords:> I<boolean>
820 923
821Change the meaning of triple-click selection with the left mouse 924Change the meaning of triple-click selection with the left mouse
822button. Instead of selecting a full line it will extend the selection to 925button. Instead of selecting a full line it will extend the selection to
823the end of the logical line only. option B<-tcw>. 926the end of the logical line only; option B<-tcw>.
824 927
825=item B<insecure:> I<boolean> 928=item B<insecure:> I<boolean>
826 929
827Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 930Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
828echo arbitrary strings like the icon name or the locale. This could be 931echo arbitrary strings like the icon name or the locale. This could be
829abused if somebody gets 8-bit-clean access to your display, whether 932abused if somebody gets 8-bit-clean access to your display, whether
830throuh a mail client displaying mail bodies unfiltered or though 933through a mail client displaying mail bodies unfiltered or through
831write(1). Therefore, these sequences are disabled by default. (Note 934write(1) or any other means. Therefore, these sequences are disabled by
832that other terminals, including xterm, have these sequences 935default. (Note that many other terminals, including xterm, have these
833enabled by default). You can enable them by setting this boolean 936sequences enabled by default, which doesn't make it safer, though).
834resource or specifying B<-insecure> as an option. At the moment, this 937
835enabled display-answer, locale, findfont, icon label and window title 938You can enable them by setting this boolean resource or specifying
836requests as well as dynamic menubar dispatch. 939B<-insecure> as an option. At the moment, this enables display-answer,
940locale, findfont, icon label and window title requests as well as dynamic
941menubar dispatch.
837 942
838=item B<modifier:> I<modifier> 943=item B<modifier:> I<modifier>
839 944
840Set the key to be interpreted as the Meta key to: B<alt>, B<meta>, 945Set the key to be interpreted as the Meta key to: B<alt>, B<meta>,
841B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option 946B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option
855 960
856Turn on/off secondary screen scroll (default enabled). If the this 961Turn on/off secondary screen scroll (default enabled). If the this
857option is enabled, scrolls on the secondary screen will change the 962option is enabled, scrolls on the secondary screen will change the
858scrollback buffer and switching to/from the secondary screen will 963scrollback buffer and switching to/from the secondary screen will
859instead scroll the screen up. 964instead scroll the screen up.
965
966=item B<hold>: I<bool>
967
968Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
969will not immediately destroy its window when the program executed within
970it exits. Instead, it will wait till it is being killed or closed by the
971user.
860 972
861=item B<keysym.>I<sym>: I<string> 973=item B<keysym.>I<sym>: I<string>
862 974
863Compile I<frills>: Associate I<string> with keysym I<sym>. The 975Compile I<frills>: Associate I<string> with keysym I<sym>. The
864intervening resource name B<keysym.> cannot be omitted. 976intervening resource name B<keysym.> cannot be omitted.
910example the following means "change the current locale to C<zh_CN.GBK> 1022example the following means "change the current locale to C<zh_CN.GBK>
911when Control-Meta-c is being pressed": 1023when Control-Meta-c is being pressed":
912 1024
913 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 1025 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
914 1026
1027If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
1028is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
1029manpage. For example, the F<selection> extension (activated via
1030C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
1031
1032 URxvt.keysym.M-C-c: perl:selection:rot13
1033
1034Due the the large number of modifier combinations, a defined key mapping
1035will match if at I<at least> the specified identifiers are being set, and
1036no other key mappings with those and more bits are being defined. That
1037means that defining a key map for C<a> will automatically provide
1038definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
1039mappings themselves.
1040
1041Unfortunately, this will override built-in key mappings. For example
1042if you overwrite the C<Insert> key you will disable @@RXVT_NAME@@'s
1043C<Shift-Insert> mapping. To re-enable that, you can poke "holes" into the
1044user-defined keymap using the C<builtin:> replacement:
1045
1046 URxvt.keysym.Insert: <my insert key sequence>
1047 URxvt.keysym.S-Insert: builtin:
1048
1049The first line defines a mapping for C<Insert> and I<any> combination
1050of modifiers. The second line re-establishes the default mapping for
1051C<Shift-Insert>.
1052
915The following example will map Control-Meta-1 and Control-Meta-2 to 1053The following example will map Control-Meta-1 and Control-Meta-2 to
916the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited 1054the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
917font-switching at runtime: 1055font-switching at runtime:
918 1056
919 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 1057 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
922Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more 1060Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
923info): 1061info):
924 1062
925 URxvt.keysym.M-C-3: command:\033[8;25;80t 1063 URxvt.keysym.M-C-3: command:\033[8;25;80t
926 URxvt.keysym.M-C-4: command:\033[8;48;110t 1064 URxvt.keysym.M-C-4: command:\033[8;48;110t
1065
1066=item B<perl-ext>: I<string>
1067
1068Colon-separated list of perl extension scripts to use in this terminal
1069instance. Each extension is looked up in the library directories, loaded
1070if necessary, and bound to the current terminal instance. If this resource
1071is empty or missing, then the perl interpreter will not be initialized;
1072option B<-pe>.
1073
1074=item B<perl-eval>: I<string>
1075
1076Perl code to be evaluated when all extensions have been registered. See the
1077@@RXVT_NAME@@perl(3) manpage.
1078
1079=item B<perl-lib>: I<path>
1080
1081Colon-separated list of additional directories that hold extension
1082scripts. When looking for extensions specified by the C<perl> resource,
1083@@RXVT_NAME@@ will first look in these directories and then in
1084F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1085
1086See the @@RXVT_NAME@@perl(3) manpage.
927 1087
928=back 1088=back
929 1089
930=head1 THE SCROLLBAR 1090=head1 THE SCROLLBAR
931 1091
966to select a word; Left triple-click to select the entire logical line 1126to select a word; Left triple-click to select the entire logical line
967(which can span multiple screen lines), unless modified by resource 1127(which can span multiple screen lines), unless modified by resource
968B<tripleclickwords>. 1128B<tripleclickwords>.
969 1129
970Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) 1130Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys)
971(Compile: I<frills>) will create a rectangular selection instead of a normal 1131(Compile: I<frills>) will create a rectangular selection instead of a
972one. 1132normal one. In this mode, every selected row becomes its own line in the
1133selection, and trailing whitespace is visually underlined and removed from
1134the selection.
973 1135
974=item B<Insertion>: 1136=item B<Insertion>:
975 1137
976Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in 1138Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in
977an B<@@RXVT_NAME@@> window causes the current text selection to be 1139an B<@@RXVT_NAME@@> window causes the current text selection to be
985supported in rxvt-unicode. Bug me if you need this. 1147supported in rxvt-unicode. Bug me if you need this.
986 1148
987You can, however, switch fonts at runtime using escape sequences (and 1149You can, however, switch fonts at runtime using escape sequences (and
988therefore using the menubar), e.g.: 1150therefore using the menubar), e.g.:
989 1151
990 printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic" 1152 printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
991 1153
992rxvt-unicode will automatically re-apply these fonts to the output so far. 1154rxvt-unicode will automatically re-apply these fonts to the output so far.
993 1155
994=head1 ISO 14755 SUPPORT 1156=head1 ISO 14755 SUPPORT
995 1157
1134Set to a string of the form C<fg;bg> or C<fg;xpm;bg>, where C<fg> is 1296Set to a string of the form C<fg;bg> or C<fg;xpm;bg>, where C<fg> is
1135the colour code used as default foreground/text colour (or the string 1297the colour code used as default foreground/text colour (or the string
1136C<default> to indicate that the default-colour escape sequence is to be 1298C<default> to indicate that the default-colour escape sequence is to be
1137used), C<bg> is the colour code used as default background colour (or the 1299used), C<bg> is the colour code used as default background colour (or the
1138string C<default>), and C<xpm> is the string C<default> if @@RXVT_NAME@@ 1300string C<default>), and C<xpm> is the string C<default> if @@RXVT_NAME@@
1139was compiled with XPM support. Libraries like C<slang> can (and do) use 1301was compiled with XPM support. Libraries like C<ncurses> and C<slang> can
1140this information to optimize screen output. 1302(and do) use this information to optimize screen output.
1141 1303
1142=item B<WINDOWID> 1304=item B<WINDOWID>
1143 1305
1144Set to the (decimal) X Window ID of the @@RXVT_NAME@@ window (the toplevel 1306Set to the (decimal) X Window ID of the @@RXVT_NAME@@ window (the toplevel
1145window, which usually has subwindows for the scrollbar, the terminal 1307window, which usually has subwindows for the scrollbar, the terminal
1171=item B<RXVT_SOCKET> 1333=item B<RXVT_SOCKET>
1172 1334
1173The unix domain socket path used by @@RXVT_NAME@@c(1) and 1335The unix domain socket path used by @@RXVT_NAME@@c(1) and
1174@@RXVT_NAME@@d(1). 1336@@RXVT_NAME@@d(1).
1175 1337
1176Default C<< $HOME/.rxvt-unicode-<nodename >>. 1338Default F<<< $HOME/.rxvt-unicode-I<< <nodename >> >>>.
1177 1339
1178=item B<HOME> 1340=item B<HOME>
1179 1341
1180Used to locate the default directory for the unix domain socket for 1342Used to locate the default directory for the unix domain socket for
1181daemon communications and to locate various resource files (such as 1343daemon communications and to locate various resource files (such as
1202 1364
1203=back 1365=back
1204 1366
1205=head1 SEE ALSO 1367=head1 SEE ALSO
1206 1368
1207@@RXVT_NAME@@(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) 1369@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1208
1209=head1 BUGS
1210
1211Check the BUGS file for an up-to-date list.
1212
1213Cursor change support is not yet implemented.
1214
1215Click-and-drag doesn't work with X11 mouse report overriding.
1216 1370
1217=head1 CURRENT PROJECT COORDINATOR 1371=head1 CURRENT PROJECT COORDINATOR
1218 1372
1219=over 4 1373=over 4
1220 1374
1221=item Project Coordinator 1375=item Project Coordinator
1222 1376
1223@@RXVT_MAINT@@ L<@@RXVT_MAINTEMAIL@@> 1377Marc A. Lehmann L<< <rxvt-unicode@schmorp.de> >>
1224 1378
1225L<@@RXVT_WEBPAGE@@> 1379L<http://software.schmorp.de/#rxvt-unicode>
1226 1380
1227=back 1381=back
1228 1382
1229=head1 AUTHORS 1383=head1 AUTHORS
1230 1384
1255=item Geoff Wing L<< <gcw@pobox.com> >> 1409=item Geoff Wing L<< <gcw@pobox.com> >>
1256 1410
1257Rewrote screen display and text selection routines. Project Coordinator 1411Rewrote screen display and text selection routines. Project Coordinator
1258(changes.txt 2.4.6 - rxvt-unicode) 1412(changes.txt 2.4.6 - rxvt-unicode)
1259 1413
1260=item Marc Alexander Lehmann L<< <rxvt@schmorp.de> >> 1414=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >>
1261 1415
1262Forked rxvt-unicode, rewrote most of the display code and internal 1416Forked rxvt-unicode, rewrote most of the display code and internal
1263character handling to store text in unicode, improve xterm 1417character handling to store text in unicode, improve xterm
1264compatibility and apply numerous other bugfixes and extensions. 1418compatibility and apply numerous other bugfixes and extensions.
1265 1419

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines