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.76 by root, Sat Dec 31 16:06:48 2005 UTC vs.
Revision 1.85 by root, Wed Jan 4 20:43:37 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 I<font-styles>: The bold font list to use when B<bold> characters
195be printed. See resource B<boldFont> for details. 195are to be 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 I<font-styles>: The italic font list to use when I<italic>
200be printed. See resource B<italicFont> for details. 200characters are to be 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 I<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.
206 207
207=item B<-is>|B<+is> 208=item B<-is>|B<+is>
208 209
209Compile font-styles: Bold/Italic font styles imply high intensity 210Compile I<font-styles>: Bold/Italic font styles imply high intensity
210foreground/background (default). See resource B<intensityStyles> for 211foreground/background (default). See resource B<intensityStyles> for
211details. 212details.
212 213
213=item B<-name> I<name> 214=item B<-name> I<name>
214 215
295=item B<-bl> 296=item B<-bl>
296 297
297Compile I<frills>: Set MWM hints to request a borderless window, i.e. 298Compile I<frills>: Set MWM hints to request a borderless window, i.e.
298if honoured by the WM, the rxvt-unicode window will not have window 299if honoured by the WM, the rxvt-unicode window will not have window
299decorations; resource B<borderLess>. 300decorations; resource B<borderLess>.
301
302=item B<-sbg>
303
304Compile I<frills>: Disable the usage of the built-in block graphics/line
305drawing characters and just rely on what the specified fonts provide. Use
306this if you have a good font and want to use its block graphic glyphs;
307resource B<skipBuiltinGlyphs>.
300 308
301=item B<-lsp> I<number> 309=item B<-lsp> I<number>
302 310
303Compile I<frills>: Lines (pixel height) to insert between each row of 311Compile I<frills>: Lines (pixel height) to insert between each row of
304the display. Useful to work around font rendering problems; resource 312the display. Useful to work around font rendering problems; resource
452 close $pty; 460 close $pty;
453 461
454 # now communicate with rxvt 462 # now communicate with rxvt
455 my $slave = $pty->slave; 463 my $slave = $pty->slave;
456 while (<$slave>) { print $slave "got <$_>\n" } 464 while (<$slave>) { print $slave "got <$_>\n" }
465
466=item B<-pe> I<string>
467
468Colon-separated list of perl extension scripts to use in this terminal
469instance. See resource B<perl-ext>.
457 470
458=back 471=back
459 472
460=head1 RESOURCES (available also as long-options) 473=head1 RESOURCES (available also as long-options)
461 474
637 650
638Select the fonts to be used. This is a comma separated list of font 651Select the fonts to be used. This is a comma separated list of font
639names that are used in turn when trying to display Unicode characters. 652names that are used in turn when trying to display Unicode characters.
640The first font defines the cell size for characters; other fonts might 653The first font defines the cell size for characters; other fonts might
641be smaller, but not larger. A reasonable default font list is always 654be smaller, but not larger. A reasonable default font list is always
642appended to it. option B<-fn>. 655appended to it; option B<-fn>.
643 656
644Each font can either be a standard X11 core font (XLFD) name, with 657Each font can either be a standard X11 core font (XLFD) name, with
645optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>. 658optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
646 659
647In addition, each font can be prefixed with additional hints and 660In addition, each font can be prefixed with additional hints and
820=item B<borderLess:> I<boolean> 833=item B<borderLess:> I<boolean>
821 834
822Set MWM hints to request a borderless window, i.e. if honoured by the 835Set MWM hints to request a borderless window, i.e. if honoured by the
823WM, the rxvt-unicode window will not have window decorations; option B<-bl>. 836WM, the rxvt-unicode window will not have window decorations; option B<-bl>.
824 837
838=item B<skipBuiltinGlyphs:> I<boolean>
839
840Compile I<frills>: Disable the usage of the built-in block graphics/line
841drawing characters and just rely on what the specified fonts provide. Use
842this if you have a good font and want to use its block graphic glyphs;
843option B<-sbg>.
844
825=item B<termName:> I<termname> 845=item B<termName:> I<termname>
826 846
827Specifies the terminal type name to be set in the B<TERM> environment 847Specifies the terminal type name to be set in the B<TERM> environment
828variable; option B<-tn>. 848variable; option B<-tn>.
829 849
902=item B<imLocale:> I<name> 922=item B<imLocale:> I<name>
903 923
904The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g. 924The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
905C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the 925C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
906input extension to be able to input japanese characters while staying in 926input extension to be able to input japanese characters while staying in
907another locale. option B<-imlocale>. 927another locale; option B<-imlocale>.
908 928
909=item B<imFont:> I<fontset> 929=item B<imFont:> I<fontset>
910 930
911Specify the font-set used for XIM styles C<OverTheSpot> or 931Specify the font-set used for XIM styles C<OverTheSpot> or
912C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated 932C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated
917 937
918=item B<tripleclickwords:> I<boolean> 938=item B<tripleclickwords:> I<boolean>
919 939
920Change the meaning of triple-click selection with the left mouse 940Change the meaning of triple-click selection with the left mouse
921button. Instead of selecting a full line it will extend the selection to 941button. Instead of selecting a full line it will extend the selection to
922the end of the logical line only. option B<-tcw>. 942the end of the logical line only; option B<-tcw>.
923 943
924=item B<insecure:> I<boolean> 944=item B<insecure:> I<boolean>
925 945
926Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 946Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
927echo arbitrary strings like the icon name or the locale. This could be 947echo arbitrary strings like the icon name or the locale. This could be
1018example the following means "change the current locale to C<zh_CN.GBK> 1038example the following means "change the current locale to C<zh_CN.GBK>
1019when Control-Meta-c is being pressed": 1039when Control-Meta-c is being pressed":
1020 1040
1021 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 1041 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
1022 1042
1043If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
1044is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
1045manpage. For example, the F<selection> extension (activated via
1046C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
1047
1048 URxvt.keysym.M-C-c: perl:selection:rot13
1049
1023Due the the large number of modifier combinations, a defined key mapping 1050Due the the large number of modifier combinations, a defined key mapping
1024will match if at I<at least> the specified identifiers are being set, and 1051will match if at I<at least> the specified identifiers are being set, and
1025no other key mappings with those and more bits are being defined. That 1052no other key mappings with those and more bits are being defined. That
1026means that defining a key map for C<a> will automatically provide 1053means that defining a key map for C<a> will automatically provide
1027definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined 1054definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
1049Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more 1076Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
1050info): 1077info):
1051 1078
1052 URxvt.keysym.M-C-3: command:\033[8;25;80t 1079 URxvt.keysym.M-C-3: command:\033[8;25;80t
1053 URxvt.keysym.M-C-4: command:\033[8;48;110t 1080 URxvt.keysym.M-C-4: command:\033[8;48;110t
1081
1082=item B<perl-ext-common>: I<string>
1083
1084=item B<perl-ext>: I<string>
1085
1086Colon-separated list(s) of perl extension scripts to use in this terminal
1087instance. Each extension is looked up in the library directories, loaded
1088if necessary, and bound to the current terminal instance. If this
1089resource is empty or missing, then the perl interpreter will not be
1090initialized. The idea behind two options is that B<perl-ext-common> will
1091be used for extensions that should be available to all instances, while
1092B<perl-ext> is used for specific instances; option B<-pe>.
1093
1094=item B<perl-eval>: I<string>
1095
1096Perl code to be evaluated when all extensions have been registered. See the
1097@@RXVT_NAME@@perl(3) manpage.
1098
1099=item B<perl-lib>: I<path>
1100
1101Colon-separated list of additional directories that hold extension
1102scripts. When looking for extensions specified by the C<perl> resource,
1103@@RXVT_NAME@@ will first look in these directories and then in
1104F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1105
1106See the @@RXVT_NAME@@perl(3) manpage.
1054 1107
1055=back 1108=back
1056 1109
1057=head1 THE SCROLLBAR 1110=head1 THE SCROLLBAR
1058 1111

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines