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.194 by sf-exg, Wed Jun 29 21:59:36 2011 UTC vs.
Revision 1.206 by root, Tue Jun 5 21:06:15 2012 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
398=item confirm-paste 400=item confirm-paste
399 401
400Displays a confirmation dialog when a paste containing at least a full 402Displays a confirmation dialog when a paste containing at least a full
401line is detected. 403line is detected.
402 404
405=item bell-command
406
407Runs the command specified by the C<URxvt.bell-command> resource when
408a bell event occurs. For example, the following pops up a notification
409bubble with the text "Beep, Beep" using notify-send:
410
411 URxvt.bell-command: notify-send "Beep, Beep"
412
403=back 413=back
404 414
405=head1 API DOCUMENTATION 415=head1 API DOCUMENTATION
406 416
407=head2 General API Considerations 417=head2 General API Considerations
435 445
436=item $octets 446=item $octets
437 447
438Either binary data or - more common - a text string encoded in a 448Either binary data or - more common - a text string encoded in a
439locale-specific way. 449locale-specific way.
450
451=item $keysym
452
453an integer that is a valid X11 keysym code. You can convert a string
454into a keysym and viceversa by using C<XStringToKeysym> and
455C<XKeysymToString>.
440 456
441=back 457=back
442 458
443=head2 Extension Objects 459=head2 Extension Objects
444 460
655a C<perl:string> action bound to a key, see description of the B<keysym> 671a C<perl:string> action bound to a key, see description of the B<keysym>
656resource in the @@RXVT_NAME@@(1) manpage). 672resource in the @@RXVT_NAME@@(1) manpage).
657 673
658The event is simply the action string. This interface is assumed to change 674The event is simply the action string. This interface is assumed to change
659slightly in the future. 675slightly in the future.
676
677=item on_register_command $term, $keysym, $modifiermask, $string
678
679Called after parsing a keysym resource but before registering the
680associated binding. If this hook returns TRUE the binding is not
681registered. It can be used to modify a binding by calling
682C<register_command>.
660 683
661=item on_resize_all_windows $term, $new_width, $new_height 684=item on_resize_all_windows $term, $new_width, $new_height
662 685
663Called just after the new window size has been calculated, but before 686Called just after the new window size has been calculated, but before
664windows are actually being resized or hints are being set. If this hook 687windows are actually being resized or hints are being set. If this hook
920 }; 943 };
921} 944}
922 945
923no warnings 'utf8'; 946no warnings 'utf8';
924 947
948sub resource {
949 my ($term, $name, $isarg, $flag, $value) = @_;
950
951 warn "resourece<@_>\n";#d#
952
953 0
954}
955
925my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 956my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
926 957
927sub verbose { 958sub verbose {
928 my ($level, $msg) = @_; 959 my ($level, $msg) = @_;
929 warn "$msg\n" if $level <= $verbosity; 960 warn "$msg\n" if $level <= $verbosity;
965sub invoke { 996sub invoke {
966 local $TERM = shift; 997 local $TERM = shift;
967 my $htype = shift; 998 my $htype = shift;
968 999
969 if ($htype == 0) { # INIT 1000 if ($htype == 0) { # INIT
970 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); 1001 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$ENV{HOME}/.urxvt/ext", "$LIBDIR/perl");
971 1002
972 my %ext_arg; 1003 my %ext_arg;
973 1004
974 { 1005 {
975 my @init = @TERM_INIT; 1006 my @init = @TERM_INIT;
1207 1238
1208sub DESTROY { 1239sub DESTROY {
1209 $_[0][1]->stop; 1240 $_[0][1]->stop;
1210} 1241}
1211 1242
1243# only needed for AnyEvent < 6 compatibility
1212sub one_event { 1244sub one_event {
1213 Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API"; 1245 Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API";
1214} 1246}
1215 1247
1216package urxvt::term; 1248package urxvt::term;
1308C<%urxvt::OPTION>. Options not enabled in this binary are not in the hash. 1340C<%urxvt::OPTION>. Options not enabled in this binary are not in the hash.
1309 1341
1310Here is a likely non-exhaustive list of option names, please see the 1342Here is a likely non-exhaustive list of option names, please see the
1311source file F</src/optinc.h> to see the actual list: 1343source file F</src/optinc.h> to see the actual list:
1312 1344
1313 borderLess console cursorBlink cursorUnderline hold iconic insecure 1345 borderLess buffered console cursorBlink cursorUnderline hold iconic
1314 intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage 1346 insecure intensityStyles iso14755 iso14755_52 jumpScroll loginShell
1315 override-redirect pastableTabs pointerBlank reverseVideo scrollBar 1347 mapAlert meta8 mouseWheelScrollPage override_redirect pastableTabs
1316 scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput 1348 pointerBlank reverseVideo scrollBar scrollBar_floating scrollBar_right
1317 scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs 1349 scrollTtyKeypress scrollTtyOutput scrollWithBuffer secondaryScreen
1318 transparent tripleclickwords utmpInhibit visualBell 1350 secondaryScroll skipBuiltinGlyphs skipScroll transparent tripleclickwords
1351 urgentOnBell utmpInhibit visualBell
1319 1352
1320=item $value = $term->resource ($name[, $newval]) 1353=item $value = $term->resource ($name[, $newval])
1321 1354
1322Returns the current resource value associated with a given name and 1355Returns the current resource value associated with a given name and
1323optionally sets a new value. Setting values is most useful in the C<init> 1356optionally sets a new value. Setting values is most useful in the C<init>
1370 1403
1371This method should only be called during the C<on_start> hook, as there is 1404This method should only be called during the C<on_start> hook, as there is
1372only one resource database per display, and later invocations might return 1405only one resource database per display, and later invocations might return
1373the wrong resources. 1406the wrong resources.
1374 1407
1375=item $success = $term->parse_keysym ($keysym_spec, $command_string) 1408=item $success = $term->parse_keysym ($key, $octets)
1376 1409
1377Adds a keymap translation exactly as specified via a resource. See the 1410Adds a key binding exactly as specified via a resource. See the
1378C<keysym> resource in the @@RXVT_NAME@@(1) manpage. 1411C<keysym> resource in the @@RXVT_NAME@@(1) manpage.
1412
1413=item $term->register_command ($keysym, $modifiermask, $string)
1414
1415Adds a key binding. This is a lower level api compared to
1416C<parse_keysym>, as it expects a parsed key description, and can be
1417used only inside either the C<on_init> hook, to add a binding, or the
1418C<on_register_command> hook, to modify a parsed binding.
1379 1419
1380=item $rend = $term->rstyle ([$new_rstyle]) 1420=item $rend = $term->rstyle ([$new_rstyle])
1381 1421
1382Return and optionally change the current rendition. Text that is output by 1422Return and optionally change the current rendition. Text that is output by
1383the terminal application will use this style. 1423the terminal application will use this style.
1596 1636
1597Adds the specified events to the vt event mask. Useful e.g. when you want 1637Adds the specified events to the vt event mask. Useful e.g. when you want
1598to receive pointer events all the times: 1638to receive pointer events all the times:
1599 1639
1600 $term->vt_emask_add (urxvt::PointerMotionMask); 1640 $term->vt_emask_add (urxvt::PointerMotionMask);
1641
1642=item $term->set_urgency ($set)
1643
1644Enable/disable the urgency hint on the toplevel window.
1601 1645
1602=item $term->focus_in 1646=item $term->focus_in
1603 1647
1604=item $term->focus_out 1648=item $term->focus_out
1605 1649
1921=item $term->XMoveResizeWindow ($window, $x, $y, $width, $height) 1965=item $term->XMoveResizeWindow ($window, $x, $y, $width, $height)
1922 1966
1923=item ($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y) 1967=item ($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y)
1924 1968
1925=item $term->XChangeInput ($window, $add_events[, $del_events]) 1969=item $term->XChangeInput ($window, $add_events[, $del_events])
1970
1971=item $keysym = $term->XStringToKeysym ($string)
1972
1973=item $string = $term->XKeysymToString ($keysym)
1926 1974
1927Various X or X-related functions. The C<$term> object only serves as 1975Various X or X-related functions. The C<$term> object only serves as
1928the source of the display, otherwise those functions map more-or-less 1976the source of the display, otherwise those functions map more-or-less
1929directly onto the X functions of the same name. 1977directly onto the X functions of the same name.
1930 1978

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines