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.113 by root, Fri Jan 20 10:27:08 2006 UTC vs.
Revision 1.118 by root, Fri Jan 20 18:50:49 2006 UTC

… …
91 91
92=item selection-popup (enabled by default) 92=item selection-popup (enabled by default)
93 93
94Binds a popup menu to Ctrl-Button3 that lets you convert the selection 94Binds a popup menu to Ctrl-Button3 that lets you convert the selection
95text into various other formats/action (such as uri unescaping, perl 95text into various other formats/action (such as uri unescaping, perl
96evalution, web-browser starting etc.), depending on content. 96evaluation, web-browser starting etc.), depending on content.
97 97
98Other extensions can extend this popup menu by pushing a code reference 98Other extensions can extend this popup menu by pushing a code reference
99onto C<@{ $term->{selection_popup_hook} }>, that is called whenever the 99onto C<@{ $term->{selection_popup_hook} }>, that is called whenever the
100popup is displayed. 100popup is displayed.
101 101
… …
162 162
163The first line tells the selection code to treat the unchanging part of 163The first line tells the selection code to treat the unchanging part of
164every error message as a selection pattern, and the second line transforms 164every error message as a selection pattern, and the second line transforms
165the message into vi commands to load the file. 165the message into vi commands to load the file.
166 166
167=item tabbed
168
169This transforms the terminal into a tabbar with additional terminals, that
170is, it implements what is commonly refered to as "tabbed terminal". The topmost line
171displays a "[NEW]" button, which, when clicked, will add a new tab, followed by one
172button per tab.
173
174Clicking a button will activate that tab. Pressing B<Shift-Left> and
175B<Shift-Right> will switch to the tab left or right of the current one,
176while B<Shift-Down> creates a new tab.
177
167=item mark-urls 178=item mark-urls
168 179
169Uses per-line display filtering (C<on_line_update>) to underline urls and 180Uses per-line display filtering (C<on_line_update>) to underline urls and
170make them clickable. When middle-clicked, the program specified in the 181make them clickable. When middle-clicked, the program specified in the
171resource C<urlLauncher> (default C<x-www-browser>) will be started with 182resource C<urlLauncher> (default C<x-www-browser>) will be started with
… …
465Called wheneever the window loses keyboard focus, before rxvt-unicode does 476Called wheneever the window loses keyboard focus, before rxvt-unicode does
466focus out processing. 477focus out processing.
467 478
468=item on_configure_notify $term, $event 479=item on_configure_notify $term, $event
469 480
481=item on_property_notify $term, $event
482
470=item on_key_press $term, $event, $keysym, $octets 483=item on_key_press $term, $event, $keysym, $octets
471 484
472=item on_key_release $term, $event, $keysym 485=item on_key_release $term, $event, $keysym
473 486
474=item on_button_press $term, $event 487=item on_button_press $term, $event
… …
490 503
491C<on_key_press> additionally receives the string rxvt-unicode would 504C<on_key_press> additionally receives the string rxvt-unicode would
492output, if any, in locale-specific encoding. 505output, if any, in locale-specific encoding.
493 506
494subwindow. 507subwindow.
508
509=item on_client_message $term, $event
510
511=item on_wm_protocols $term, $event
512
513=item on_wm_delete_window $term, $event
514
515Called when various types of ClientMessage events are received (all with
516format=32, WM_PROTOCOLS or WM_PROTOCOLS:WM_DELETE_WINDOW).
495 517
496=back 518=back
497 519
498=cut 520=cut
499 521
… …
1790 1812
1791Stop watching for events on the given filehandle. 1813Stop watching for events on the given filehandle.
1792 1814
1793=back 1815=back
1794 1816
1817=head2 The C<urxvt::iw> Class
1818
1819This class implements idle watchers, that get called automatically when
1820the process is idle. They should return as fast as possible, after doing
1821some useful work.
1822
1823=over 4
1824
1825=item $iw = new urxvt::iw
1826
1827Create a new idle watcher object in stopped state.
1828
1829=item $iw = $iw->cb (sub { my ($iw) = @_; ... })
1830
1831Set the callback to be called when the watcher triggers.
1832
1833=item $timer = $timer->start
1834
1835Start the watcher.
1836
1837=item $timer = $timer->stop
1838
1839Stop the watcher.
1840
1841=back
1842
1843=head2 The C<urxvt::pw> Class
1844
1845This class implements process watchers. They create an event whenever a
1846process exits, after which they stop automatically.
1847
1848 my $pid = fork;
1849 ...
1850 $term->{pw} = urxvt::pw
1851 ->new
1852 ->start ($pid)
1853 ->cb (sub {
1854 my ($pw, $exit_status) = @_;
1855 ...
1856 });
1857
1858=over 4
1859
1860=item $pw = new urxvt::pw
1861
1862Create a new process watcher in stopped state.
1863
1864=item $pw = $pw->cb (sub { my ($pw, $exit_status) = @_; ... })
1865
1866Set the callback to be called when the timer triggers.
1867
1868=item $pw = $timer->start ($pid)
1869
1870Tells the wqtcher to start watching for process C<$pid>.
1871
1872=item $pw = $pw->stop
1873
1874Stop the watcher.
1875
1876=back
1877
1795=head1 ENVIRONMENT 1878=head1 ENVIRONMENT
1796 1879
1797=head2 URXVT_PERL_VERBOSITY 1880=head2 URXVT_PERL_VERBOSITY
1798 1881
1799This variable controls the verbosity level of the perl extension. Higher 1882This variable controls the verbosity level of the perl extension. Higher

Diff Legend

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