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.84 by root, Wed Jan 4 05:35:34 2006 UTC vs.
Revision 1.91 by root, Mon Jan 9 23:00: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 B<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 I<italic> 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 B<< I<bold 204Compile I<font-styles>: The bold italic font list to use when B<< I<bold
205italic> >> characters are to be printed. See resource B<boldItalicFont> 205italic> >> characters are to be printed. See resource B<boldItalicFont>
206for details. 206for details.
207 207
208=item B<-is>|B<+is> 208=item B<-is>|B<+is>
209 209
210Compile font-styles: Bold/Italic font styles imply high intensity 210Compile I<font-styles>: Bold/Italic font styles imply high intensity
211foreground/background (default). See resource B<intensityStyles> for 211foreground/background (default). See resource B<intensityStyles> for
212details. 212details.
213 213
214=item B<-name> I<name> 214=item B<-name> I<name>
215 215
… …
296=item B<-bl> 296=item B<-bl>
297 297
298Compile 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.
299if 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
300decorations; 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>.
301 308
302=item B<-lsp> I<number> 309=item B<-lsp> I<number>
303 310
304Compile I<frills>: Lines (pixel height) to insert between each row of 311Compile I<frills>: Lines (pixel height) to insert between each row of
305the display. Useful to work around font rendering problems; resource 312the display. Useful to work around font rendering problems; resource
… …
428 $rxvt->signal_connect_after (realize => sub { 435 $rxvt->signal_connect_after (realize => sub {
429 my $xid = $_[0]->window->get_xid; 436 my $xid = $_[0]->window->get_xid;
430 system "@@RXVT_NAME@@ -embed $xid &"; 437 system "@@RXVT_NAME@@ -embed $xid &";
431 }); 438 });
432 439
433=item B<-pty-fd> I<fileno> 440=item B<-pty-fd> I<file descriptor>
434 441
435Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty 442Tells @@RXVT_NAME@@ NOT to execute any commands or create a new pty/tty
436pair but instead use the given filehandle as the tty master. This is 443pair but instead use the given filehandle as the tty master. This is
437useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator 444useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator
438without having to run a program within it. 445without having to run a program within it.
439 446
440If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp 447If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp
441entries and will not tinker with pty/tty permissions - you have to do that 448entries and will not tinker with pty/tty permissions - you have to do that
442yourself if you want that. 449yourself if you want that.
443 450
451As an extremely special case, specifying C<-1> will completely suppress
452pty/tty operations.
453
444Here is a example in perl that illustrates how this option can be used (a 454Here is a example in perl that illustrates how this option can be used (a
445longer example is in F<doc/pty-fd>): 455longer example is in F<doc/pty-fd>):
446 456
447 use IO::Pty; 457 use IO::Pty;
448 use Fcntl; 458 use Fcntl;
… …
456 my $slave = $pty->slave; 466 my $slave = $pty->slave;
457 while (<$slave>) { print $slave "got <$_>\n" } 467 while (<$slave>) { print $slave "got <$_>\n" }
458 468
459=item B<-pe> I<string> 469=item B<-pe> I<string>
460 470
461Colon-separated list of perl extension scripts to use in this terminal 471Comma-separated list of perl extension scripts to use (or not to use) in
462instance. See resource B<perl-ext>. 472this terminal instance. See resource B<perl-ext> for details.
463 473
464=back 474=back
465 475
466=head1 RESOURCES (available also as long-options) 476=head1 RESOURCES (available also as long-options)
467 477
… …
826=item B<borderLess:> I<boolean> 836=item B<borderLess:> I<boolean>
827 837
828Set MWM hints to request a borderless window, i.e. if honoured by the 838Set MWM hints to request a borderless window, i.e. if honoured by the
829WM, the rxvt-unicode window will not have window decorations; option B<-bl>. 839WM, the rxvt-unicode window will not have window decorations; option B<-bl>.
830 840
841=item B<skipBuiltinGlyphs:> I<boolean>
842
843Compile I<frills>: Disable the usage of the built-in block graphics/line
844drawing characters and just rely on what the specified fonts provide. Use
845this if you have a good font and want to use its block graphic glyphs;
846option B<-sbg>.
847
831=item B<termName:> I<termname> 848=item B<termName:> I<termname>
832 849
833Specifies the terminal type name to be set in the B<TERM> environment 850Specifies the terminal type name to be set in the B<TERM> environment
834variable; option B<-tn>. 851variable; option B<-tn>.
835 852
… …
1067 1084
1068=item B<perl-ext-common>: I<string> 1085=item B<perl-ext-common>: I<string>
1069 1086
1070=item B<perl-ext>: I<string> 1087=item B<perl-ext>: I<string>
1071 1088
1072Colon-separated list(s) of perl extension scripts to use in this terminal 1089Comma-separated list(s) of perl extension scripts (default: C<default>) to
1090use in this terminal instance; option B<-pe>.
1091
1092Extension names can be prefixed with a C<-> sign to prohibit using
1093them. This can be useful to selectively disable some extensions loaded
1094by default, or specified via the C<perl-ext-common> resource. For
1095example, C<default,-selection> will use all the default extension except
1096C<selection>.
1097
1098Extension names can also be followed by an argument in angle brackets
1099(e.g. C<< searchable-scrollback<M-s> >>, which binds the hotkey for
1100searchable scorllback to Alt/Meta-s). Mentioning the same extension
1101multiple times with different arguments will pass multiple arguments to
1102the extension.
1103
1073instance. Each extension is looked up in the library directories, loaded 1104Each extension is looked up in the library directories, loaded if
1074if necessary, and bound to the current terminal instance. If this 1105necessary, and bound to the current terminal instance.
1075resource is empty or missing, then the perl interpreter will not be 1106
1076initialized. The idea behind two options is that B<perl-ext-common> will 1107If both of these resources are the empty string, then the perl
1077be used for extensions that should be available to all instances, while 1108interpreter will not be initialized. The idea behind two options is that
1078B<perl-ext> is used for specific instances; option B<-pe>. 1109B<perl-ext-common> will be used for extensions that should be available to
1110all instances, while B<perl-ext> is used for specific instances.
1079 1111
1080=item B<perl-eval>: I<string> 1112=item B<perl-eval>: I<string>
1081 1113
1082Perl code to be evaluated when all extensions have been registered. See the 1114Perl code to be evaluated when all extensions have been registered. See
1083@@RXVT_NAME@@perl(3) manpage. 1115the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource
1116will be ignored when running setuid/setgid.
1084 1117
1085=item B<perl-lib>: I<path> 1118=item B<perl-lib>: I<path>
1086 1119
1087Colon-separated list of additional directories that hold extension 1120Colon-separated list of additional directories that hold extension
1088scripts. When looking for extensions specified by the C<perl> resource, 1121scripts. When looking for extensions specified by the C<perl> resource,
1089@@RXVT_NAME@@ will first look in these directories and then in 1122@@RXVT_NAME@@ will first look in these directories and then in
1090F<@@RXVT_LIBDIR@@/urxvt/perl/>. 1123F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource
1124will be ignored when running setuid/setgid.
1091 1125
1092See the @@RXVT_NAME@@perl(3) manpage. 1126See the @@RXVT_NAME@@perl(3) manpage.
1127
1128=item B<transient-for>: I<windowid>
1129
1130Sets the WM_TRANSIENT_FOR property to the given window iw.
1093 1131
1094=back 1132=back
1095 1133
1096=head1 THE SCROLLBAR 1134=head1 THE SCROLLBAR
1097 1135

Diff Legend

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