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.188 by sf-exg, Sat Jul 24 13:04:27 2010 UTC vs.
Revision 1.200 by sf-exg, Sun Nov 20 10:58:58 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
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
441=back 451=back
442 452
443=head2 Extension Objects 453=head2 Extension Objects
444 454
445Every perl extension is a perl class. A separate perl object is created 455Every perl extension is a perl class. A separate perl object is created
446for each terminal, and each terminal has its own set of extenion objects, 456for each terminal, and each terminal has its own set of extension objects,
447which are passed as the first parameter to hooks. So extensions can use 457which are passed as the first parameter to hooks. So extensions can use
448their C<$self> object without having to think about clashes with other 458their C<$self> object without having to think about clashes with other
449extensions or other terminals, with the exception of methods and members 459extensions or other terminals, with the exception of methods and members
450that begin with an underscore character C<_>: these are reserved for 460that begin with an underscore character C<_>: these are reserved for
451internal use. 461internal use.
798 808
799=over 4 809=over 4
800 810
801=item urxvt::fatal $errormessage 811=item urxvt::fatal $errormessage
802 812
803Fatally aborts execution with the given error message. Avoid at all 813Fatally aborts execution with the given error message (which should
804costs! The only time this is acceptable is when the terminal process 814include a trailing newline). Avoid at all costs! The only time this
805starts up. 815is acceptable (and useful) is in the init hook, where it prevents the
816terminal from starting up.
806 817
807=item urxvt::warn $string 818=item urxvt::warn $string
808 819
809Calls C<rxvt_warn> with the given string which should not include a 820Calls C<rxvt_warn> with the given string which should include a trailing
810newline. The module also overwrites the C<warn> builtin with a function 821newline. The module also overwrites the C<warn> builtin with a function
811that calls this function. 822that calls this function.
812 823
813Using this function has the advantage that its output ends up in the 824Using this function has the advantage that its output ends up in the
814correct place, e.g. on stderr of the connecting urxvtc client. 825correct place, e.g. on stderr of the connecting urxvtc client.
818=item @terms = urxvt::termlist 829=item @terms = urxvt::termlist
819 830
820Returns all urxvt::term objects that exist in this process, regardless of 831Returns all urxvt::term objects that exist in this process, regardless of
821whether they are started, being destroyed etc., so be careful. Only term 832whether they are started, being destroyed etc., so be careful. Only term
822objects that have perl extensions attached will be returned (because there 833objects that have perl extensions attached will be returned (because there
823is no urxvt::term objet associated with others). 834is no urxvt::term object associated with others).
824 835
825=item $time = urxvt::NOW 836=item $time = urxvt::NOW
826 837
827Returns the "current time" (as per the event loop). 838Returns the "current time" (as per the event loop).
828 839
871 882
872=item $rend = urxvt::OVERLAY_RSTYLE 883=item $rend = urxvt::OVERLAY_RSTYLE
873 884
874Return the rendition mask used for overlays by default. 885Return the rendition mask used for overlays by default.
875 886
876=item $rendbit = urxvt::RS_Bold, RS_Italic, RS_Blink, RS_RVid, RS_Uline 887=item $rendbit = urxvt::RS_Bold, urxvt::RS_Italic, urxvt::RS_Blink,
888urxvt::RS_RVid, urxvt::RS_Uline
877 889
878Return the bit that enabled bold, italic, blink, reverse-video and 890Return the bit that enabled bold, italic, blink, reverse-video and
879underline, respectively. To enable such a style, just logically OR it into 891underline, respectively. To enable such a style, just logically OR it into
880the bitset. 892the bitset.
881 893
963sub invoke { 975sub invoke {
964 local $TERM = shift; 976 local $TERM = shift;
965 my $htype = shift; 977 my $htype = shift;
966 978
967 if ($htype == 0) { # INIT 979 if ($htype == 0) { # INIT
968 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); 980 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$ENV{HOME}/.urxvt/ext", "$LIBDIR/perl");
969 981
970 my %ext_arg; 982 my %ext_arg;
971 983
972 { 984 {
973 my @init = @TERM_INIT; 985 my @init = @TERM_INIT;
1205 1217
1206sub DESTROY { 1218sub DESTROY {
1207 $_[0][1]->stop; 1219 $_[0][1]->stop;
1208} 1220}
1209 1221
1222# only needed for AnyEvent < 6 compatibility
1210sub one_event { 1223sub one_event {
1211 Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API"; 1224 Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API";
1212} 1225}
1213 1226
1214package urxvt::term; 1227package urxvt::term;
1306C<%urxvt::OPTION>. Options not enabled in this binary are not in the hash. 1319C<%urxvt::OPTION>. Options not enabled in this binary are not in the hash.
1307 1320
1308Here is a likely non-exhaustive list of option names, please see the 1321Here is a likely non-exhaustive list of option names, please see the
1309source file F</src/optinc.h> to see the actual list: 1322source file F</src/optinc.h> to see the actual list:
1310 1323
1311 borderLess console cursorBlink cursorUnderline hold iconic insecure 1324 borderLess buffered console cursorBlink cursorUnderline hold iconic
1312 intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage 1325 insecure intensityStyles iso14755 iso14755_52 jumpScroll loginShell
1313 override-redirect pastableTabs pointerBlank reverseVideo scrollBar 1326 mapAlert meta8 mouseWheelScrollPage override_redirect pastableTabs
1314 scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput 1327 pointerBlank reverseVideo scrollBar scrollBar_floating scrollBar_right
1315 scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs 1328 scrollTtyKeypress scrollTtyOutput scrollWithBuffer secondaryScreen
1316 transparent tripleclickwords utmpInhibit visualBell 1329 secondaryScroll skipBuiltinGlyphs skipScroll transparent tripleclickwords
1330 urgentOnBell utmpInhibit visualBell
1317 1331
1318=item $value = $term->resource ($name[, $newval]) 1332=item $value = $term->resource ($name[, $newval])
1319 1333
1320Returns the current resource value associated with a given name and 1334Returns the current resource value associated with a given name and
1321optionally sets a new value. Setting values is most useful in the C<init> 1335optionally sets a new value. Setting values is most useful in the C<init>
1334 1348
1335Here is a likely non-exhaustive list of resource names, not all of which 1349Here is a likely non-exhaustive list of resource names, not all of which
1336are supported in every build, please see the source file F</src/rsinc.h> 1350are supported in every build, please see the source file F</src/rsinc.h>
1337to see the actual list: 1351to see the actual list:
1338 1352
1339 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont 1353 answerbackstring backgroundPixmap backspace_key blendtype blurradius
1340 borderLess chdir color cursorBlink cursorUnderline cutchars delete_key 1354 boldFont boldItalicFont borderLess buffered chdir color cursorBlink
1341 display_name embed ext_bwidth fade font geometry hold iconName 1355 cursorUnderline cutchars delete_key depth display_name embed ext_bwidth
1342 imFont imLocale inputMethod insecure int_bwidth intensityStyles 1356 fade font geometry hold iconName iconfile imFont imLocale inputMethod
1343 italicFont jumpScroll lineSpace letterSpace loginShell mapAlert meta8 1357 insecure int_bwidth intensityStyles iso14755 iso14755_52 italicFont
1358 jumpScroll letterSpace lineSpace loginShell mapAlert meta8 modifier
1344 modifier mouseWheelScrollPage name override_redirect pastableTabs path 1359 mouseWheelScrollPage name override_redirect pastableTabs path perl_eval
1345 perl_eval perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay 1360 perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
1346 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar 1361 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
1347 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness 1362 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
1348 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle 1363 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
1349 secondaryScreen secondaryScroll shade term_name title 1364 secondaryScreen secondaryScroll shade skipBuiltinGlyphs skipScroll
1350 transient_for transparent transparent_all tripleclickwords utmpInhibit 1365 term_name title transient_for transparent tripleclickwords urgentOnBell
1351 visualBell 1366 utmpInhibit visualBell
1352 1367
1353=cut 1368=cut
1354 1369
1355sub resource($$;$) { 1370sub resource($$;$) {
1356 my ($self, $name) = (shift, shift); 1371 my ($self, $name) = (shift, shift);
2249 2264
2250=back 2265=back
2251 2266
2252=head1 AUTHOR 2267=head1 AUTHOR
2253 2268
2254 Marc Lehmann <pcg@goof.com> 2269 Marc Lehmann <schmorp@schmorp.de>
2255 http://software.schmorp.de/pkg/rxvt-unicode 2270 http://software.schmorp.de/pkg/rxvt-unicode
2256 2271
2257=cut 2272=cut
2258 2273
22591 22741

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines