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.85 by root, Wed Jan 4 20:43:37 2006 UTC vs.
Revision 1.92 by root, Wed Jan 11 02:13:55 2006 UTC

… …
435 $rxvt->signal_connect_after (realize => sub { 435 $rxvt->signal_connect_after (realize => sub {
436 my $xid = $_[0]->window->get_xid; 436 my $xid = $_[0]->window->get_xid;
437 system "@@RXVT_NAME@@ -embed $xid &"; 437 system "@@RXVT_NAME@@ -embed $xid &";
438 }); 438 });
439 439
440=item B<-pty-fd> I<fileno> 440=item B<-pty-fd> I<file descriptor>
441 441
442Tells @@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
443pair 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
444useful 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
445without having to run a program within it. 445without having to run a program within it.
446 446
447If 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
448entries 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
449yourself if you want that. 449yourself if you want that.
450 450
451As an extremely special case, specifying C<-1> will completely suppress
452pty/tty operations.
453
451Here 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
452longer example is in F<doc/pty-fd>): 455longer example is in F<doc/pty-fd>):
453 456
454 use IO::Pty; 457 use IO::Pty;
455 use Fcntl; 458 use Fcntl;
… …
463 my $slave = $pty->slave; 466 my $slave = $pty->slave;
464 while (<$slave>) { print $slave "got <$_>\n" } 467 while (<$slave>) { print $slave "got <$_>\n" }
465 468
466=item B<-pe> I<string> 469=item B<-pe> I<string>
467 470
468Colon-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
469instance. See resource B<perl-ext>. 472this terminal instance. See resource B<perl-ext> for details.
470 473
471=back 474=back
472 475
473=head1 RESOURCES (available also as long-options) 476=head1 RESOURCES (available also as long-options)
474 477
… …
1081 1084
1082=item B<perl-ext-common>: I<string> 1085=item B<perl-ext-common>: I<string>
1083 1086
1084=item B<perl-ext>: I<string> 1087=item B<perl-ext>: I<string>
1085 1088
1086Colon-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
1087instance. Each extension is looked up in the library directories, loaded 1104Each extension is looked up in the library directories, loaded if
1088if necessary, and bound to the current terminal instance. If this 1105necessary, and bound to the current terminal instance.
1089resource is empty or missing, then the perl interpreter will not be 1106
1090initialized. The idea behind two options is that B<perl-ext-common> will 1107If both of these resources are the empty string, then the perl
1091be used for extensions that should be available to all instances, while 1108interpreter will not be initialized. The idea behind two options is that
1092B<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.
1093 1111
1094=item B<perl-eval>: I<string> 1112=item B<perl-eval>: I<string>
1095 1113
1096Perl code to be evaluated when all extensions have been registered. See the 1114Perl code to be evaluated when all extensions have been registered. See
1097@@RXVT_NAME@@perl(3) manpage. 1115the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource
1116will be ignored when running setuid/setgid.
1098 1117
1099=item B<perl-lib>: I<path> 1118=item B<perl-lib>: I<path>
1100 1119
1101Colon-separated list of additional directories that hold extension 1120Colon-separated list of additional directories that hold extension
1102scripts. When looking for extensions specified by the C<perl> resource, 1121scripts. When looking for extensions specified by the C<perl> resource,
1103@@RXVT_NAME@@ will first look in these directories and then in 1122@@RXVT_NAME@@ will first look in these directories and then in
1104F<@@RXVT_LIBDIR@@/urxvt/perl/>. 1123F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource
1124will be ignored when running setuid/setgid.
1105 1125
1106See the @@RXVT_NAME@@perl(3) manpage. 1126See the @@RXVT_NAME@@perl(3) manpage.
1127
1128=item B<urlLauncher>: I<string>
1129
1130Specifies the program to be started with a URL argument. Used by the
1131C<selection-popup> and C<mark-urls> perl extensions.
1132
1133=item B<transient-for>: I<windowid>
1134
1135Sets the WM_TRANSIENT_FOR property to the given window iw.
1107 1136
1108=back 1137=back
1109 1138
1110=head1 THE SCROLLBAR 1139=head1 THE SCROLLBAR
1111 1140

Diff Legend

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