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.174 by root, Sat May 30 08:47:07 2009 UTC vs.
Revision 1.198 by root, Tue Oct 4 22:25:14 2011 UTC

… …
259The default pattern to match URLs can be overridden with the 259The default pattern to match URLs can be overridden with the
260C<matcher.pattern.0> resource, and additional patterns can be specified 260C<matcher.pattern.0> resource, and additional patterns can be specified
261with numbered patterns, in a manner similar to the "selection" extension. 261with numbered patterns, in a manner similar to the "selection" extension.
262The launcher can also be overridden on a per-pattern basis. 262The launcher can also be overridden on a per-pattern basis.
263 263
264It is possible to activate the most recently seen match from the keyboard. 264It is possible to activate the most recently seen match or a list of matches
265from the keyboard. Simply bind a keysym to "perl:matcher:last" or
265Simply bind a keysym to "perl:matcher" as seen in the example below. 266"perl:matcher:list" as seen in the example below.
266 267
267Example configuration: 268Example configuration:
268 269
269 URxvt.perl-ext: default,matcher 270 URxvt.perl-ext: default,matcher
270 URxvt.urlLauncher: sensible-browser 271 URxvt.urlLauncher: sensible-browser
271 URxvt.keysym.C-Delete: perl:matcher 272 URxvt.keysym.C-Delete: perl:matcher:last
273 URxvt.keysym.M-Delete: perl:matcher:list
272 URxvt.matcher.button: 1 274 URxvt.matcher.button: 1
273 URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-] 275 URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
274 URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$) 276 URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$)
275 URxvt.matcher.launcher.2: gvim +$2 $1 277 URxvt.matcher.launcher.2: gvim +$2 $1
276 278
… …
341 URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection' 343 URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
342 URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection' 344 URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'
343 345
344=item selection-pastebin 346=item selection-pastebin
345 347
346This is a little rarely useful extension that Uploads the selection as 348This is a little rarely useful extension that uploads the selection as
347textfile to a remote site (or does other things). (The implementation is 349textfile to a remote site (or does other things). (The implementation is
348not currently secure for use in a multiuser environment as it writes to 350not currently secure for use in a multiuser environment as it writes to
349F</tmp> directly.). 351F</tmp> directly.).
350 352
351It listens to the C<selection-pastebin:remote-pastebin> keyboard command, 353It listens to the C<selection-pastebin:remote-pastebin> keyboard command,
… …
370 372
371 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% 373 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
372 374
373I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret 375I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret
374the double C</> characters as comment start. Use C<\057\057> instead, 376the double C</> characters as comment start. Use C<\057\057> instead,
375which works regardless of wether xrdb is used to parse the resource file 377which works regardless of whether xrdb is used to parse the resource file
376or not. 378or not.
377 379
378=item macosx-pastebin and macosx-pastebin-native 380=item macosx-clipboard and macosx-clipboard-native
379 381
380These two modules implement an extended clipboard for Mac OS X. They are 382These two modules implement an extended clipboard for Mac OS X. They are
381used like this: 383used like this:
382 384
383 URxvt.perl-ext-common: default,macosx-clipboard 385 URxvt.perl-ext-common: default,macosx-clipboard
384 URxvt.keysym.M-c: perl:macosx-clipboard:copy 386 URxvt.keysym.M-c: perl:macosx-clipboard:copy
385 URxvt.keysym.M-v: perl:macosx-clipboard:paste 387 URxvt.keysym.M-v: perl:macosx-clipboard:paste
386 388
387The difference between them is that the native variant requires a 389The difference between them is that the native variant requires a
388perl from apple's devkit or so, and C<maxosx-pastebin> requires the 390perl from apple's devkit or so, and C<macosx-clipboard> requires the
389C<Mac::Pasteboard> module, works with other perls, has fewer bugs, is 391C<Mac::Pasteboard> module, works with other perls, has fewer bugs, is
390simpler etc. etc. 392simpler etc. etc.
391 393
392=item example-refresh-hooks 394=item example-refresh-hooks
393 395
394Displays a very simple digital clock in the upper right corner of the 396Displays a very simple digital clock in the upper right corner of the
395window. Illustrates overwriting the refresh callbacks to create your own 397window. Illustrates overwriting the refresh callbacks to create your own
396overlays or changes. 398overlays or changes.
399
400=item confirm-paste
401
402Displays a confirmation dialog when a paste containing at least a full
403line is detected.
397 404
398=back 405=back
399 406
400=head1 API DOCUMENTATION 407=head1 API DOCUMENTATION
401 408
… …
417 424
418=over 4 425=over 4
419 426
420=item $text 427=item $text
421 428
422Rxvt-unicodes special way of encoding text, where one "unicode" character 429Rxvt-unicode's special way of encoding text, where one "unicode" character
423always represents one screen cell. See L<ROW_t> for a discussion of this format. 430always represents one screen cell. See L<ROW_t> for a discussion of this format.
424 431
425=item $string 432=item $string
426 433
427A perl text string, with an emphasis on I<text>. It can store all unicode 434A perl text string, with an emphasis on I<text>. It can store all unicode
… …
436=back 443=back
437 444
438=head2 Extension Objects 445=head2 Extension Objects
439 446
440Every perl extension is a perl class. A separate perl object is created 447Every perl extension is a perl class. A separate perl object is created
441for each terminal, and each terminal has its own set of extenion objects, 448for each terminal, and each terminal has its own set of extension objects,
442which are passed as the first parameter to hooks. So extensions can use 449which are passed as the first parameter to hooks. So extensions can use
443their C<$self> object without having to think about clashes with other 450their C<$self> object without having to think about clashes with other
444extensions or other terminals, with the exception of methods and members 451extensions or other terminals, with the exception of methods and members
445that begin with an underscore character C<_>: these are reserved for 452that begin with an underscore character C<_>: these are reserved for
446internal use. 453internal use.
… …
610=item on_tt_write $term, $octets 617=item on_tt_write $term, $octets
611 618
612Called whenever some data is written to the tty/pty and can be used to 619Called whenever some data is written to the tty/pty and can be used to
613suppress or filter tty input. 620suppress or filter tty input.
614 621
622=item on_tt_paste $term, $octets
623
624Called whenever text is about to be pasted, with the text as argument. You
625can filter/change and paste the text yourself by returning a true value
626and calling C<< $term->tt_paste >> yourself. C<$octets> is
627locale-encoded.
628
615=item on_line_update $term, $row 629=item on_line_update $term, $row
616 630
617Called whenever a line was updated or changed. Can be used to filter 631Called whenever a line was updated or changed. Can be used to filter
618screen output (e.g. underline urls or other useless stuff). Only lines 632screen output (e.g. underline urls or other useless stuff). Only lines
619that are being shown will be filtered, and, due to performance reasons, 633that are being shown will be filtered, and, due to performance reasons,
… …
644resource in the @@RXVT_NAME@@(1) manpage). 658resource in the @@RXVT_NAME@@(1) manpage).
645 659
646The event is simply the action string. This interface is assumed to change 660The event is simply the action string. This interface is assumed to change
647slightly in the future. 661slightly in the future.
648 662
649=item on_resize_all_windows $tern, $new_width, $new_height 663=item on_resize_all_windows $term, $new_width, $new_height
650 664
651Called just after the new window size has been calculated, but before 665Called just after the new window size has been calculated, but before
652windows are actually being resized or hints are being set. If this hook 666windows are actually being resized or hints are being set. If this hook
653returns TRUE, setting of the window hints is being skipped. 667returns TRUE, setting of the window hints is being skipped.
654 668
… …
688 702
689=item on_map_notify $term, $event 703=item on_map_notify $term, $event
690 704
691=item on_unmap_notify $term, $event 705=item on_unmap_notify $term, $event
692 706
693Called whenever the corresponding X event is received for the terminal If 707Called whenever the corresponding X event is received for the terminal. If
694the hook returns true, then the even will be ignored by rxvt-unicode. 708the hook returns true, then the event will be ignored by rxvt-unicode.
695 709
696The event is a hash with most values as named by Xlib (see the XEvent 710The event is a hash with most values as named by Xlib (see the XEvent
697manpage), with the additional members C<row> and C<col>, which are the 711manpage), with the additional members C<row> and C<col>, which are the
698(real, not screen-based) row and column under the mouse cursor. 712(real, not screen-based) row and column under the mouse cursor.
699 713
… …
708 722
709=item on_wm_delete_window $term, $event 723=item on_wm_delete_window $term, $event
710 724
711Called when various types of ClientMessage events are received (all with 725Called when various types of ClientMessage events are received (all with
712format=32, WM_PROTOCOLS or WM_PROTOCOLS:WM_DELETE_WINDOW). 726format=32, WM_PROTOCOLS or WM_PROTOCOLS:WM_DELETE_WINDOW).
727
728=item on_bell $term
729
730Called on receipt of a bell character.
713 731
714=back 732=back
715 733
716=cut 734=cut
717 735
… …
782 800
783=over 4 801=over 4
784 802
785=item urxvt::fatal $errormessage 803=item urxvt::fatal $errormessage
786 804
787Fatally aborts execution with the given error message. Avoid at all 805Fatally aborts execution with the given error message (which should
788costs! The only time this is acceptable is when the terminal process 806include a trailing newline). Avoid at all costs! The only time this
789starts up. 807is acceptable (and useful) is in the init hook, where it prevents the
808terminal from starting up.
790 809
791=item urxvt::warn $string 810=item urxvt::warn $string
792 811
793Calls C<rxvt_warn> with the given string which should not include a 812Calls C<rxvt_warn> with the given string which should include a trailing
794newline. The module also overwrites the C<warn> builtin with a function 813newline. The module also overwrites the C<warn> builtin with a function
795that calls this function. 814that calls this function.
796 815
797Using this function has the advantage that its output ends up in the 816Using this function has the advantage that its output ends up in the
798correct place, e.g. on stderr of the connecting urxvtc client. 817correct place, e.g. on stderr of the connecting urxvtc client.
… …
802=item @terms = urxvt::termlist 821=item @terms = urxvt::termlist
803 822
804Returns all urxvt::term objects that exist in this process, regardless of 823Returns all urxvt::term objects that exist in this process, regardless of
805whether they are started, being destroyed etc., so be careful. Only term 824whether they are started, being destroyed etc., so be careful. Only term
806objects that have perl extensions attached will be returned (because there 825objects that have perl extensions attached will be returned (because there
807is no urxvt::term objet associated with others). 826is no urxvt::term object associated with others).
808 827
809=item $time = urxvt::NOW 828=item $time = urxvt::NOW
810 829
811Returns the "current time" (as per the event loop). 830Returns the "current time" (as per the event loop).
812 831
… …
855 874
856=item $rend = urxvt::OVERLAY_RSTYLE 875=item $rend = urxvt::OVERLAY_RSTYLE
857 876
858Return the rendition mask used for overlays by default. 877Return the rendition mask used for overlays by default.
859 878
860=item $rendbit = urxvt::RS_Bold, RS_Italic, RS_Blink, RS_RVid, RS_Uline 879=item $rendbit = urxvt::RS_Bold, urxvt::RS_Italic, urxvt::RS_Blink,
880urxvt::RS_RVid, urxvt::RS_Uline
861 881
862Return the bit that enabled bold, italic, blink, reverse-video and 882Return the bit that enabled bold, italic, blink, reverse-video and
863underline, respectively. To enable such a style, just logically OR it into 883underline, respectively. To enable such a style, just logically OR it into
864the bitset. 884the bitset.
865 885
… …
1124is that you cannot use blocking APIs, but the non-blocking variant should 1144is that you cannot use blocking APIs, but the non-blocking variant should
1125work. 1145work.
1126 1146
1127=cut 1147=cut
1128 1148
1129our $VERSION = '3.4'; 1149our $VERSION = '5.23';
1130 1150
1131$INC{"urxvt/anyevent.pm"} = 1; # mark us as there 1151$INC{"urxvt/anyevent.pm"} = 1; # mark us as there
1132push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::]; 1152push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::];
1133 1153
1134sub timer { 1154sub timer {
… …
1136 1156
1137 my $cb = $arg{cb}; 1157 my $cb = $arg{cb};
1138 1158
1139 urxvt::timer 1159 urxvt::timer
1140 ->new 1160 ->new
1141 ->start (urxvt::NOW + $arg{after}) 1161 ->after ($arg{after}, $arg{interval})
1142 ->cb (sub { 1162 ->cb ($arg{interval} ? $cb : sub {
1143 $_[0]->stop; # need to cancel manually 1163 $_[0]->stop; # need to cancel manually
1144 $cb->(); 1164 $cb->();
1145 }) 1165 })
1146} 1166}
1147 1167
1148sub io { 1168sub io {
1149 my ($class, %arg) = @_; 1169 my ($class, %arg) = @_;
1150 1170
1151 my $cb = $arg{cb}; 1171 my $cb = $arg{cb};
1172 my $fd = fileno $arg{fh};
1173 defined $fd or $fd = $arg{fh};
1152 1174
1153 bless [$arg{fh}, urxvt::iow 1175 bless [$arg{fh}, urxvt::iow
1154 ->new 1176 ->new
1155 ->fd (fileno $arg{fh}) 1177 ->fd ($fd)
1156 ->events (($arg{poll} =~ /r/ ? 1 : 0) 1178 ->events (($arg{poll} =~ /r/ ? 1 : 0)
1157 | ($arg{poll} =~ /w/ ? 2 : 0)) 1179 | ($arg{poll} =~ /w/ ? 2 : 0))
1158 ->start 1180 ->start
1159 ->cb (sub { 1181 ->cb ($cb)
1160 $cb->(($_[1] & 1 ? 'r' : '')
1161 . ($_[1] & 2 ? 'w' : ''));
1162 })],
1163 urxvt::anyevent:: 1182 ], urxvt::anyevent::
1183}
1184
1185sub idle {
1186 my ($class, %arg) = @_;
1187
1188 my $cb = $arg{cb};
1189
1190 urxvt::iw
1191 ->new
1192 ->start
1193 ->cb ($cb)
1194}
1195
1196sub child {
1197 my ($class, %arg) = @_;
1198
1199 my $cb = $arg{cb};
1200
1201 urxvt::pw
1202 ->new
1203 ->start ($arg{pid})
1204 ->cb (sub {
1205 $_[0]->stop; # need to cancel manually
1206 $cb->($_[0]->rpid, $_[0]->rstatus);
1207 })
1164} 1208}
1165 1209
1166sub DESTROY { 1210sub DESTROY {
1167 $_[0][1]->stop; 1211 $_[0][1]->stop;
1168} 1212}
1169 1213
1214# only needed for AnyEvent < 6 compatibility
1170sub one_event { 1215sub one_event {
1171 Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API"; 1216 Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API";
1172} 1217}
1173 1218
1174package urxvt::term; 1219package urxvt::term;
… …
1266C<%urxvt::OPTION>. Options not enabled in this binary are not in the hash. 1311C<%urxvt::OPTION>. Options not enabled in this binary are not in the hash.
1267 1312
1268Here is a likely non-exhaustive list of option names, please see the 1313Here is a likely non-exhaustive list of option names, please see the
1269source file F</src/optinc.h> to see the actual list: 1314source file F</src/optinc.h> to see the actual list:
1270 1315
1271 borderLess console cursorBlink cursorUnderline hold iconic insecure 1316 borderLess buffered console cursorBlink cursorUnderline hold iconic
1272 intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage 1317 insecure intensityStyles iso14755 iso14755_52 jumpScroll loginShell
1273 override-redirect pastableTabs pointerBlank reverseVideo scrollBar 1318 mapAlert meta8 mouseWheelScrollPage override_redirect pastableTabs
1274 scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput 1319 pointerBlank reverseVideo scrollBar scrollBar_floating scrollBar_right
1275 scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs 1320 scrollTtyKeypress scrollTtyOutput scrollWithBuffer secondaryScreen
1276 transparent tripleclickwords utmpInhibit visualBell 1321 secondaryScroll skipBuiltinGlyphs skipScroll transparent tripleclickwords
1322 urgentOnBell utmpInhibit visualBell
1277 1323
1278=item $value = $term->resource ($name[, $newval]) 1324=item $value = $term->resource ($name[, $newval])
1279 1325
1280Returns the current resource value associated with a given name and 1326Returns the current resource value associated with a given name and
1281optionally sets a new value. Setting values is most useful in the C<init> 1327optionally sets a new value. Setting values is most useful in the C<init>
… …
1294 1340
1295Here is a likely non-exhaustive list of resource names, not all of which 1341Here is a likely non-exhaustive list of resource names, not all of which
1296are supported in every build, please see the source file F</src/rsinc.h> 1342are supported in every build, please see the source file F</src/rsinc.h>
1297to see the actual list: 1343to see the actual list:
1298 1344
1299 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont 1345 answerbackstring backgroundPixmap backspace_key blendtype blurradius
1300 borderLess chdir color cursorBlink cursorUnderline cutchars delete_key 1346 boldFont boldItalicFont borderLess buffered chdir color cursorBlink
1301 display_name embed ext_bwidth fade font geometry hold iconName 1347 cursorUnderline cutchars delete_key depth display_name embed ext_bwidth
1302 imFont imLocale inputMethod insecure int_bwidth intensityStyles 1348 fade font geometry hold iconName iconfile imFont imLocale inputMethod
1349 insecure int_bwidth intensityStyles iso14755 iso14755_52 italicFont
1303 italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier 1350 jumpScroll letterSpace lineSpace loginShell mapAlert meta8 modifier
1304 mouseWheelScrollPage name override_redirect pastableTabs path perl_eval 1351 mouseWheelScrollPage name override_redirect pastableTabs path perl_eval
1305 perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay 1352 perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
1306 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar 1353 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
1307 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness 1354 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
1308 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle 1355 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
1309 secondaryScreen secondaryScroll shade term_name title 1356 secondaryScreen secondaryScroll shade skipBuiltinGlyphs skipScroll
1310 transient_for transparent transparent_all tripleclickwords utmpInhibit 1357 term_name title transient_for transparent tripleclickwords urgentOnBell
1311 visualBell 1358 utmpInhibit visualBell
1312 1359
1313=cut 1360=cut
1314 1361
1315sub resource($$;$) { 1362sub resource($$;$) {
1316 my ($self, $name) = (shift, shift); 1363 my ($self, $name) = (shift, shift);
… …
1348 1395
1349=item ($row, $col) = $term->selection_beg ([$row, $col]) 1396=item ($row, $col) = $term->selection_beg ([$row, $col])
1350 1397
1351=item ($row, $col) = $term->selection_end ([$row, $col]) 1398=item ($row, $col) = $term->selection_end ([$row, $col])
1352 1399
1353Return the current values of the selection mark, begin or end positions, 1400Return the current values of the selection mark, begin or end positions.
1354and optionally set them to new values. 1401
1402When arguments are given, then the selection coordinates are set to
1403C<$row> and C<$col>, and the selection screen is set to the current
1404screen.
1405
1406=item $screen = $term->selection_screen ([$screen])
1407
1408Returns the current selection screen, and then optionally sets it.
1355 1409
1356=item $term->selection_make ($eventtime[, $rectangular]) 1410=item $term->selection_make ($eventtime[, $rectangular])
1357 1411
1358Tries to make a selection as set by C<selection_beg> and 1412Tries to make a selection as set by C<selection_beg> and
1359C<selection_end>. If C<$rectangular> is true (default: false), a 1413C<selection_end>. If C<$rectangular> is true (default: false), a
1360rectangular selection will be made. This is the prefered function to make 1414rectangular selection will be made. This is the preferred function to make
1361a selection. 1415a selection.
1362 1416
1363=item $success = $term->selection_grab ($eventtime) 1417=item $success = $term->selection_grab ($eventtime[, $clipboard])
1364 1418
1365Try to request the primary selection text from the server (for example, as 1419Try to acquire ownership of the primary (clipboard if C<$clipboard> is
1420true) selection from the server. The corresponding text can be set
1366set by the next method). No visual feedback will be given. This function 1421with the next method. No visual feedback will be given. This function
1367is mostly useful from within C<on_sel_grab> hooks. 1422is mostly useful from within C<on_sel_grab> hooks.
1368 1423
1369=item $oldtext = $term->selection ([$newtext]) 1424=item $oldtext = $term->selection ([$newtext, $clipboard])
1370 1425
1371Return the current selection text and optionally replace it by C<$newtext>. 1426Return the current selection (clipboard if C<$clipboard> is true) text
1427and optionally replace it by C<$newtext>.
1428
1429=item $term->selection_clear ([$clipboard])
1430
1431Revoke ownership of the primary (clipboard if C<$clipboard> is true) selection.
1372 1432
1373=item $term->overlay_simple ($x, $y, $text) 1433=item $term->overlay_simple ($x, $y, $text)
1374 1434
1375Create a simple multi-line overlay box. See the next method for details. 1435Create a simple multi-line overlay box. See the next method for details.
1376 1436
… …
1504locale-specific encoding of the terminal and can contain command sequences 1564locale-specific encoding of the terminal and can contain command sequences
1505(escape codes) that will be interpreted. 1565(escape codes) that will be interpreted.
1506 1566
1507=item $term->tt_write ($octets) 1567=item $term->tt_write ($octets)
1508 1568
1509Write the octets given in C<$data> to the tty (i.e. as program input). To 1569Write the octets given in C<$octets> to the tty (i.e. as program input). To
1510pass characters instead of octets, you should convert your strings first 1570pass characters instead of octets, you should convert your strings first
1511to the locale-specific encoding using C<< $term->locale_encode >>. 1571to the locale-specific encoding using C<< $term->locale_encode >>.
1572
1573=item $term->tt_paste ($octets)
1574
1575Write the octets given in C<$octets> to the tty as a paste, converting NL to
1576CR and bracketing the data with control sequences if bracketed paste mode
1577is set.
1512 1578
1513=item $old_events = $term->pty_ev_events ([$new_events]) 1579=item $old_events = $term->pty_ev_events ([$new_events])
1514 1580
1515Replaces the event mask of the pty watcher by the given event mask. Can 1581Replaces the event mask of the pty watcher by the given event mask. Can
1516be used to suppress input and output handling to the pty/tty. See the 1582be used to suppress input and output handling to the pty/tty. See the
… …
1830Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most 1896Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most
1831recent grab. 1897recent grab.
1832 1898
1833=item $term->ungrab 1899=item $term->ungrab
1834 1900
1835Calls XUngrab for the most recent grab. Is called automatically on 1901Calls XUngrabPointer and XUngrabKeyboard for the most recent grab. Is called automatically on
1836evaluation errors, as it is better to lose the grab in the error case as 1902evaluation errors, as it is better to lose the grab in the error case as
1837the session. 1903the session.
1838 1904
1839=item $atom = $term->XInternAtom ($atom_name[, $only_if_exists]) 1905=item $atom = $term->XInternAtom ($atom_name[, $only_if_exists])
1840 1906
… …
1862 1928
1863=item $term->XChangeInput ($window, $add_events[, $del_events]) 1929=item $term->XChangeInput ($window, $add_events[, $del_events])
1864 1930
1865Various X or X-related functions. The C<$term> object only serves as 1931Various X or X-related functions. The C<$term> object only serves as
1866the source of the display, otherwise those functions map more-or-less 1932the source of the display, otherwise those functions map more-or-less
1867directory onto the X functions of the same name. 1933directly onto the X functions of the same name.
1868 1934
1869=back 1935=back
1870 1936
1871=cut 1937=cut
1872 1938
… …
2029 2095
2030=item $timer = $timer->cb (sub { my ($timer) = @_; ... }) 2096=item $timer = $timer->cb (sub { my ($timer) = @_; ... })
2031 2097
2032Set the callback to be called when the timer triggers. 2098Set the callback to be called when the timer triggers.
2033 2099
2034=item $tstamp = $timer->at
2035
2036Return the time this watcher will fire next.
2037
2038=item $timer = $timer->set ($tstamp) 2100=item $timer = $timer->set ($tstamp[, $interval])
2039 2101
2040Set the time the event is generated to $tstamp. 2102Set the time the event is generated to $tstamp (and optionally specifies a
2103new $interval).
2041 2104
2042=item $timer = $timer->interval ($interval) 2105=item $timer = $timer->interval ($interval)
2043 2106
2044Normally (and when C<$interval> is C<0>), the timer will automatically 2107By default (and when C<$interval> is C<0>), the timer will automatically
2045stop after it has fired once. If C<$interval> is non-zero, then the timer 2108stop after it has fired once. If C<$interval> is non-zero, then the timer
2046is automatically rescheduled at the given intervals. 2109is automatically rescheduled at the given intervals.
2047 2110
2048=item $timer = $timer->start 2111=item $timer = $timer->start
2049 2112
2050Start the timer. 2113Start the timer.
2051 2114
2052=item $timer = $timer->start ($tstamp) 2115=item $timer = $timer->start ($tstamp[, $interval])
2053 2116
2054Set the event trigger time to C<$tstamp> and start the timer. 2117Set the event trigger time to C<$tstamp> and start the timer. Optionally
2118also replaces the interval.
2055 2119
2056=item $timer = $timer->after ($delay) 2120=item $timer = $timer->after ($delay[, $interval])
2057 2121
2058Like C<start>, but sets the expiry timer to c<urxvt::NOW + $delay>. 2122Like C<start>, but sets the expiry timer to c<urxvt::NOW + $delay>.
2059 2123
2060=item $timer = $timer->stop 2124=item $timer = $timer->stop
2061 2125
… …
2192 2256
2193=back 2257=back
2194 2258
2195=head1 AUTHOR 2259=head1 AUTHOR
2196 2260
2197 Marc Lehmann <pcg@goof.com> 2261 Marc Lehmann <schmorp@schmorp.de>
2198 http://software.schmorp.de/pkg/rxvt-unicode 2262 http://software.schmorp.de/pkg/rxvt-unicode
2199 2263
2200=cut 2264=cut
2201 2265
22021 22661

Diff Legend

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