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.75 by root, Tue Dec 27 01:50:00 2005 UTC vs.
Revision 1.83 by root, Tue Jan 3 22:28:07 2006 UTC

189See also the question "How does rxvt-unicode choose fonts?" in the FAQ 189See also the question "How does rxvt-unicode choose fonts?" in the FAQ
190section of @@RXVT_NAME@@(7). 190section of @@RXVT_NAME@@(7).
191 191
192=item B<-fb> I<fontlist> 192=item B<-fb> I<fontlist>
193 193
194Compile font-styles: The bold font list to use when bold characters are to 194Compile font-styles: The bold font list to use when B<bold> characters are to
195be printed. See resource B<boldFont> for details. 195be printed. See resource B<boldFont> for details.
196 196
197=item B<-fi> I<fontlist> 197=item B<-fi> I<fontlist>
198 198
199Compile font-styles: The italic font list to use when bold characters are to 199Compile font-styles: The italic font list to use when I<italic> characters are to
200be printed. See resource B<italicFont> for details. 200be printed. See resource B<italicFont> for details.
201 201
202=item B<-fbi> I<fontlist> 202=item B<-fbi> I<fontlist>
203 203
204Compile 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 B<< I<bold
205be printed. See resource B<boldItalicFont> for details. 205italic> >> characters are to be printed. See resource B<boldItalicFont>
206for details.
207
208=item B<-is>|B<+is>
209
210Compile font-styles: Bold/Italic font styles imply high intensity
211foreground/background (default). See resource B<intensityStyles> for
212details.
206 213
207=item B<-name> I<name> 214=item B<-name> I<name>
208 215
209Specify the application name under which resources are to be obtained, 216Specify the application name under which resources are to be obtained,
210rather than the default executable file name. Name should not contain 217rather than the default executable file name. Name should not contain
446 close $pty; 453 close $pty;
447 454
448 # now communicate with rxvt 455 # now communicate with rxvt
449 my $slave = $pty->slave; 456 my $slave = $pty->slave;
450 while (<$slave>) { print $slave "got <$_>\n" } 457 while (<$slave>) { print $slave "got <$_>\n" }
458
459=item B<-pe> I<string>
460
461Colon-separated list of perl extension scripts to use in this terminal instance. See resource B<perl-ext>.
451 462
452=back 463=back
453 464
454=head1 RESOURCES (available also as long-options) 465=head1 RESOURCES (available also as long-options)
455 466
631 642
632Select the fonts to be used. This is a comma separated list of font 643Select the fonts to be used. This is a comma separated list of font
633names that are used in turn when trying to display Unicode characters. 644names that are used in turn when trying to display Unicode characters.
634The first font defines the cell size for characters; other fonts might 645The first font defines the cell size for characters; other fonts might
635be smaller, but not larger. A reasonable default font list is always 646be smaller, but not larger. A reasonable default font list is always
636appended to it. option B<-fn>. 647appended to it; option B<-fn>.
637 648
638Each font can either be a standard X11 core font (XLFD) name, with 649Each font can either be a standard X11 core font (XLFD) name, with
639optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>. 650optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
640 651
641In addition, each font can be prefixed with additional hints and 652In addition, each font can be prefixed with additional hints and
687not possible, replacement fonts of the desired shape will be tried. 698not possible, replacement fonts of the desired shape will be tried.
688 699
689If set, but empty, then this specific style is disabled and the normal 700If set, but empty, then this specific style is disabled and the normal
690text font will being used for the given style. 701text font will being used for the given style.
691 702
703=item B<intensityStyles:> I<boolean>
704
705When font styles are not enabled, or this option is enabled (B<True>,
706option B<-is>, the default), bold and italic font styles imply high
707intensity foreground/backround colours. Disabling this option (B<False>,
708option B<+is>) disables this behaviour, the high intensity colours are not
709reachable.
710
692=item B<selectstyle:> I<mode> 711=item B<selectstyle:> I<mode>
693 712
694Set mouse selection style to B<old> which is 2.20, B<oldword> which is 713Set mouse selection style to B<old> which is 2.20, B<oldword> which is
695xterm style with 2.20 old word selection, or anything else which gives 714xterm style with 2.20 old word selection, or anything else which gives
696xterm style selection. 715xterm style selection.
888=item B<imLocale:> I<name> 907=item B<imLocale:> I<name>
889 908
890The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g. 909The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
891C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the 910C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
892input extension to be able to input japanese characters while staying in 911input extension to be able to input japanese characters while staying in
893another locale. option B<-imlocale>. 912another locale; option B<-imlocale>.
894 913
895=item B<imFont:> I<fontset> 914=item B<imFont:> I<fontset>
896 915
897Specify the font-set used for XIM styles C<OverTheSpot> or 916Specify the font-set used for XIM styles C<OverTheSpot> or
898C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated 917C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated
903 922
904=item B<tripleclickwords:> I<boolean> 923=item B<tripleclickwords:> I<boolean>
905 924
906Change the meaning of triple-click selection with the left mouse 925Change the meaning of triple-click selection with the left mouse
907button. Instead of selecting a full line it will extend the selection to 926button. Instead of selecting a full line it will extend the selection to
908the end of the logical line only. option B<-tcw>. 927the end of the logical line only; option B<-tcw>.
909 928
910=item B<insecure:> I<boolean> 929=item B<insecure:> I<boolean>
911 930
912Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 931Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
913echo arbitrary strings like the icon name or the locale. This could be 932echo arbitrary strings like the icon name or the locale. This could be
1004example the following means "change the current locale to C<zh_CN.GBK> 1023example the following means "change the current locale to C<zh_CN.GBK>
1005when Control-Meta-c is being pressed": 1024when Control-Meta-c is being pressed":
1006 1025
1007 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 1026 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
1008 1027
1028If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
1029is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
1030manpage. For example, the F<selection> extension (activated via
1031C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
1032
1033 URxvt.keysym.M-C-c: perl:selection:rot13
1034
1009Due the the large number of modifier combinations, a defined key mapping 1035Due the the large number of modifier combinations, a defined key mapping
1010will match if at I<at least> the specified identifiers are being set, and 1036will match if at I<at least> the specified identifiers are being set, and
1011no other key mappings with those and more bits are being defined. That 1037no other key mappings with those and more bits are being defined. That
1012means that defining a key map for C<a> will automatically provide 1038means that defining a key map for C<a> will automatically provide
1013definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined 1039definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
1035Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more 1061Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
1036info): 1062info):
1037 1063
1038 URxvt.keysym.M-C-3: command:\033[8;25;80t 1064 URxvt.keysym.M-C-3: command:\033[8;25;80t
1039 URxvt.keysym.M-C-4: command:\033[8;48;110t 1065 URxvt.keysym.M-C-4: command:\033[8;48;110t
1066
1067=item B<perl-ext>: I<string>
1068
1069Colon-separated list of perl extension scripts to use in this terminal
1070instance. Each extension is looked up in the library directories, loaded
1071if necessary, and bound to the current terminal instance. If this resource
1072is empty or missing, then the perl interpreter will not be initialized;
1073option B<-pe>.
1074
1075=item B<perl-eval>: I<string>
1076
1077Perl code to be evaluated when all extensions have been registered. See the
1078@@RXVT_NAME@@perl(3) manpage.
1079
1080=item B<perl-lib>: I<path>
1081
1082Colon-separated list of additional directories that hold extension
1083scripts. When looking for extensions specified by the C<perl> resource,
1084@@RXVT_NAME@@ will first look in these directories and then in
1085F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1086
1087See the @@RXVT_NAME@@perl(3) manpage.
1040 1088
1041=back 1089=back
1042 1090
1043=head1 THE SCROLLBAR 1091=head1 THE SCROLLBAR
1044 1092

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines