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.74 by root, Thu Dec 22 16:44:10 2005 UTC vs.
Revision 1.81 by root, Mon Jan 2 21:41:51 2006 UTC

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 bold characters are to
205be printed. See resource B<boldItalicFont> for details. 205be printed. See resource B<boldItalicFont> for details.
206 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
207=item B<-name> I<name> 213=item B<-name> I<name>
208 214
209Specify the application name under which resources are to be obtained, 215Specify the application name under which resources are to be obtained,
210rather than the default executable file name. Name should not contain 216rather than the default executable file name. Name should not contain
211`.' or `*' characters. Also sets the icon and title name. 217`.' or `*' characters. Also sets the icon and title name.
446 close $pty; 452 close $pty;
447 453
448 # now communicate with rxvt 454 # now communicate with rxvt
449 my $slave = $pty->slave; 455 my $slave = $pty->slave;
450 while (<$slave>) { print $slave "got <$_>\n" } 456 while (<$slave>) { print $slave "got <$_>\n" }
457
458=item B<-pe> I<string>
459
460Colon-separated list of perl extension scripts to use in this terminal instance. See resource B<perl-ext>.
451 461
452=back 462=back
453 463
454=head1 RESOURCES (available also as long-options) 464=head1 RESOURCES (available also as long-options)
455 465
631 641
632Select 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
633names that are used in turn when trying to display Unicode characters. 643names that are used in turn when trying to display Unicode characters.
634The first font defines the cell size for characters; other fonts might 644The first font defines the cell size for characters; other fonts might
635be smaller, but not larger. A reasonable default font list is always 645be smaller, but not larger. A reasonable default font list is always
636appended to it. option B<-fn>. 646appended to it; option B<-fn>.
637 647
638Each 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
639optional 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:>.
640 650
641In addition, each font can be prefixed with additional hints and 651In addition, each font can be prefixed with additional hints and
687not possible, replacement fonts of the desired shape will be tried. 697not possible, replacement fonts of the desired shape will be tried.
688 698
689If 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
690text font will being used for the given style. 700text font will being used for the given style.
691 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
692=item B<selectstyle:> I<mode> 710=item B<selectstyle:> I<mode>
693 711
694Set 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
695xterm 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
696xterm style selection. 714xterm style selection.
888=item B<imLocale:> I<name> 906=item B<imLocale:> I<name>
889 907
890The 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.
891C<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
892input extension to be able to input japanese characters while staying in 910input extension to be able to input japanese characters while staying in
893another locale. option B<-imlocale>. 911another locale; option B<-imlocale>.
894 912
895=item B<imFont:> I<fontset> 913=item B<imFont:> I<fontset>
896 914
897Specify the font-set used for XIM styles C<OverTheSpot> or 915Specify the font-set used for XIM styles C<OverTheSpot> or
898C<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
903 921
904=item B<tripleclickwords:> I<boolean> 922=item B<tripleclickwords:> I<boolean>
905 923
906Change the meaning of triple-click selection with the left mouse 924Change the meaning of triple-click selection with the left mouse
907button. 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
908the end of the logical line only. option B<-tcw>. 926the end of the logical line only; option B<-tcw>.
909 927
910=item B<insecure:> I<boolean> 928=item B<insecure:> I<boolean>
911 929
912Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 930Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
913echo 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
1004example 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>
1005when Control-Meta-c is being pressed": 1023when Control-Meta-c is being pressed":
1006 1024
1007 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
1008 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
1009Due the the large number of modifier combinations, a defined key mapping 1034Due 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 1035will 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 1036no other key mappings with those and more bits are being defined. That
1012means that defining a key map for C<a> will automatically provide 1037means 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 1038definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
1036info): 1061info):
1037 1062
1038 URxvt.keysym.M-C-3: command:\033[8;25;80t 1063 URxvt.keysym.M-C-3: command:\033[8;25;80t
1039 URxvt.keysym.M-C-4: command:\033[8;48;110t 1064 URxvt.keysym.M-C-4: command:\033[8;48;110t
1040 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; option B<-pe>.
1071
1072=item B<perl-eval>: I<string>
1073
1074Perl code to be evaluated when all extensions have been registered. See the
1075@@RXVT_NAME@@perl(3) manpage.
1076
1077=item B<perl-lib>: I<path>
1078
1079Colon-separated list of additional directories that hold extension
1080scripts. When looking for extensions specified by the C<perl> resource,
1081@@RXVT_NAME@@ will first look in these directories and then in
1082F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1083
1084See the @@RXVT_NAME@@perl(3) manpage.
1085
1041=back 1086=back
1042 1087
1043=head1 THE SCROLLBAR 1088=head1 THE SCROLLBAR
1044 1089
1045Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window 1090Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window
1079to select a word; Left triple-click to select the entire logical line 1124to select a word; Left triple-click to select the entire logical line
1080(which can span multiple screen lines), unless modified by resource 1125(which can span multiple screen lines), unless modified by resource
1081B<tripleclickwords>. 1126B<tripleclickwords>.
1082 1127
1083Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) 1128Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys)
1084(Compile: I<frills>) will create a rectangular selection instead of a normal 1129(Compile: I<frills>) will create a rectangular selection instead of a
1085one. 1130normal one. In this mode, every selected row becomes its own line in the
1131selection, and trailing whitespace is visually underlined and removed from
1132the selection.
1086 1133
1087=item B<Insertion>: 1134=item B<Insertion>:
1088 1135
1089Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in 1136Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in
1090an B<@@RXVT_NAME@@> window causes the current text selection to be 1137an B<@@RXVT_NAME@@> window causes the current text selection to be

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines