ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/urxvt.pm
(Generate patch)

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.77 by root, Wed Jan 11 00:59:58 2006 UTC vs.
Revision 1.84 by root, Thu Jan 12 02:20:56 2006 UTC

… …
84 84
85Displays a digital clock using the built-in overlay. 85Displays a digital clock using the built-in overlay.
86 86
87=item mark-urls 87=item mark-urls
88 88
89Uses per-line display filtering (C<on_line_update>) to underline urls. 89Uses per-line display filtering (C<on_line_update>) to underline urls and
90make them clickable. When middle-clicked, the program specified in the
91resource C<urlLauncher> (default C<x-www-browser>) will be started.
90 92
91=item block-graphics-to-ascii 93=item block-graphics-to-ascii
92 94
93A not very useful example of filtering all text output to the terminal, 95A not very useful example of filtering all text output to the terminal,
94by replacing all line-drawing characters (U+2500 .. U+259F) by a 96by replacing all line-drawing characters (U+2500 .. U+259F) by a
… …
123=over 4 125=over 4
124 126
125=item $text 127=item $text
126 128
127Rxvt-unicodes special way of encoding text, where one "unicode" character 129Rxvt-unicodes special way of encoding text, where one "unicode" character
128always represents one screen cell. See L<row_t> for a discussion of this format. 130always represents one screen cell. See L<ROW_t> for a discussion of this format.
129 131
130=item $string 132=item $string
131 133
132A perl text string, with an emphasis on I<text>. It can store all unicode 134A perl text string, with an emphasis on I<text>. It can store all unicode
133characters and is to be distinguished with text encoded in a specific 135characters and is to be distinguished with text encoded in a specific
… …
385 387
386=item $urxvt::TERM 388=item $urxvt::TERM
387 389
388The current terminal. This variable stores the current C<urxvt::term> 390The current terminal. This variable stores the current C<urxvt::term>
389object, whenever a callback/hook is executing. 391object, whenever a callback/hook is executing.
390
391=item
392 392
393=back 393=back
394 394
395=head2 Functions in the C<urxvt> Package 395=head2 Functions in the C<urxvt> Package
396 396
… …
496 $msg .= "\n" 496 $msg .= "\n"
497 unless $msg =~ /\n$/; 497 unless $msg =~ /\n$/;
498 urxvt::warn ($msg); 498 urxvt::warn ($msg);
499 }; 499 };
500 500
501 # %ENV is the original startup environment
501 delete $ENV{IFS}; 502 delete $ENV{IFS};
502 delete $ENV{CDPATH}; 503 delete $ENV{CDPATH};
503 delete $ENV{BASH_ENV}; 504 delete $ENV{BASH_ENV};
504 $ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin"; 505 $ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin";
505} 506}
… …
614 } 615 }
615 616
616 $retval 617 $retval
617} 618}
618 619
620sub exec_async(@) {
621 my $pid = fork;
622
623 return
624 if !defined $pid or $pid;
625
626 %ENV = %{ $TERM->env };
627
628 exec @_;
629 _exit 255;
630}
631
619# urxvt::term::extension 632# urxvt::term::extension
620 633
621package urxvt::term::extension; 634package urxvt::term::extension;
622 635
623sub enable { 636sub enable {
… …
782} 795}
783 796
784=item $term = new urxvt::term $envhashref, $rxvtname, [arg...] 797=item $term = new urxvt::term $envhashref, $rxvtname, [arg...]
785 798
786Creates a new terminal, very similar as if you had started it with system 799Creates a new terminal, very similar as if you had started it with system
787C<$rxvtname, arg...>. C<$envhashref> must be a reference to a %ENV>-like 800C<$rxvtname, arg...>. C<$envhashref> must be a reference to a C<%ENV>-like
788C<hash which defines the environment of the new terminal. 801hash which defines the environment of the new terminal.
789 802
790Croaks (and probably outputs an error message) if the new instance 803Croaks (and probably outputs an error message) if the new instance
791couldn't be created. Returns C<undef> if the new instance didn't 804couldn't be created. Returns C<undef> if the new instance didn't
792initialise perl, and the terminal object otherwise. The C<init> and 805initialise perl, and the terminal object otherwise. The C<init> and
793C<start> hooks will be called during this call. 806C<start> hooks will be called during this call.
… …
862 my ($self, $name) = (shift, shift); 875 my ($self, $name) = (shift, shift);
863 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 876 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
864 &urxvt::term::_resource 877 &urxvt::term::_resource
865} 878}
866 879
880=item $value = $term->x_resource ($pattern)
881
882Returns the X-Resource for the given pattern, excluding the program or
883class name, i.e. C<< $term->x_resource ("boldFont") >> should return the
884same value as used by this instance of rxvt-unicode. Returns C<undef> if no
885resource with that pattern exists.
886
887This method should only be called during the C<on_start> hook, as there is
888only one resource database per display, and later invocations might return
889the wrong resources.
890
867=item $success = $term->parse_keysym ($keysym_spec, $command_string) 891=item $success = $term->parse_keysym ($keysym_spec, $command_string)
868 892
869Adds a keymap translation exactly as specified via a resource. See the 893Adds a keymap translation exactly as specified via a resource. See the
870C<keysym> resource in the @@RXVT_NAME@@(1) manpage. 894C<keysym> resource in the @@RXVT_NAME@@(1) manpage.
871 895
… …
1441 my ($self) = @_; 1465 my ($self) = @_;
1442 1466
1443 delete $self->{term}{_destroy}{$self}; 1467 delete $self->{term}{_destroy}{$self};
1444 $self->{term}->ungrab; 1468 $self->{term}->ungrab;
1445} 1469}
1470
1471=back
1446 1472
1447=head2 The C<urxvt::timer> Class 1473=head2 The C<urxvt::timer> Class
1448 1474
1449This class implements timer watchers/events. Time is represented as a 1475This class implements timer watchers/events. Time is represented as a
1450fractional number of seconds since the epoch. Example: 1476fractional number of seconds since the epoch. Example:

Diff Legend

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