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.189 by root, Sat Dec 18 15:37:10 2010 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
441=back 443=back
442 444
443=head2 Extension Objects 445=head2 Extension Objects
444 446
445Every 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
446for 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,
447which 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
448their C<$self> object without having to think about clashes with other 450their C<$self> object without having to think about clashes with other
449extensions or other terminals, with the exception of methods and members 451extensions or other terminals, with the exception of methods and members
450that begin with an underscore character C<_>: these are reserved for 452that begin with an underscore character C<_>: these are reserved for
451internal use. 453internal use.
798 800
799=over 4 801=over 4
800 802
801=item urxvt::fatal $errormessage 803=item urxvt::fatal $errormessage
802 804
803Fatally aborts execution with the given error message. Avoid at all 805Fatally aborts execution with the given error message (which should
804costs! The only time this is acceptable is when the terminal process 806include a trailing newline). Avoid at all costs! The only time this
805starts up. 807is acceptable (and useful) is in the init hook, where it prevents the
808terminal from starting up.
806 809
807=item urxvt::warn $string 810=item urxvt::warn $string
808 811
809Calls 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
810newline. The module also overwrites the C<warn> builtin with a function 813newline. The module also overwrites the C<warn> builtin with a function
811that calls this function. 814that calls this function.
812 815
813Using 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
814correct place, e.g. on stderr of the connecting urxvtc client. 817correct place, e.g. on stderr of the connecting urxvtc client.
818=item @terms = urxvt::termlist 821=item @terms = urxvt::termlist
819 822
820Returns all urxvt::term objects that exist in this process, regardless of 823Returns all urxvt::term objects that exist in this process, regardless of
821whether they are started, being destroyed etc., so be careful. Only term 824whether they are started, being destroyed etc., so be careful. Only term
822objects that have perl extensions attached will be returned (because there 825objects that have perl extensions attached will be returned (because there
823is no urxvt::term objet associated with others). 826is no urxvt::term object associated with others).
824 827
825=item $time = urxvt::NOW 828=item $time = urxvt::NOW
826 829
827Returns the "current time" (as per the event loop). 830Returns the "current time" (as per the event loop).
828 831
1206 1209
1207sub DESTROY { 1210sub DESTROY {
1208 $_[0][1]->stop; 1211 $_[0][1]->stop;
1209} 1212}
1210 1213
1214# only needed for AnyEvent < 6 compatibility
1211sub one_event { 1215sub one_event {
1212 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";
1213} 1217}
1214 1218
1215package urxvt::term; 1219package urxvt::term;
1307C<%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.
1308 1312
1309Here 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
1310source file F</src/optinc.h> to see the actual list: 1314source file F</src/optinc.h> to see the actual list:
1311 1315
1312 borderLess console cursorBlink cursorUnderline hold iconic insecure 1316 borderLess buffered console cursorBlink cursorUnderline hold iconic
1313 intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage 1317 insecure intensityStyles iso14755 iso14755_52 jumpScroll loginShell
1314 override-redirect pastableTabs pointerBlank reverseVideo scrollBar 1318 mapAlert meta8 mouseWheelScrollPage override_redirect pastableTabs
1315 scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput 1319 pointerBlank reverseVideo scrollBar scrollBar_floating scrollBar_right
1316 scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs 1320 scrollTtyKeypress scrollTtyOutput scrollWithBuffer secondaryScreen
1317 transparent tripleclickwords utmpInhibit visualBell 1321 secondaryScroll skipBuiltinGlyphs skipScroll transparent tripleclickwords
1322 urgentOnBell utmpInhibit visualBell
1318 1323
1319=item $value = $term->resource ($name[, $newval]) 1324=item $value = $term->resource ($name[, $newval])
1320 1325
1321Returns the current resource value associated with a given name and 1326Returns the current resource value associated with a given name and
1322optionally 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>
1335 1340
1336Here 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
1337are 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>
1338to see the actual list: 1343to see the actual list:
1339 1344
1340 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont 1345 answerbackstring backgroundPixmap backspace_key blendtype blurradius
1341 borderLess chdir color cursorBlink cursorUnderline cutchars delete_key 1346 boldFont boldItalicFont borderLess buffered chdir color cursorBlink
1342 display_name embed ext_bwidth fade font geometry hold iconName 1347 cursorUnderline cutchars delete_key depth display_name embed ext_bwidth
1343 imFont imLocale inputMethod insecure int_bwidth intensityStyles 1348 fade font geometry hold iconName iconfile imFont imLocale inputMethod
1344 italicFont jumpScroll lineSpace letterSpace loginShell mapAlert meta8 1349 insecure int_bwidth intensityStyles iso14755 iso14755_52 italicFont
1350 jumpScroll letterSpace lineSpace loginShell mapAlert meta8 modifier
1345 modifier mouseWheelScrollPage name override_redirect pastableTabs path 1351 mouseWheelScrollPage name override_redirect pastableTabs path perl_eval
1346 perl_eval perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay 1352 perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
1347 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar 1353 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
1348 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness 1354 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
1349 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle 1355 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
1350 secondaryScreen secondaryScroll shade term_name title 1356 secondaryScreen secondaryScroll shade skipBuiltinGlyphs skipScroll
1351 transient_for transparent transparent_all tripleclickwords utmpInhibit 1357 term_name title transient_for transparent tripleclickwords urgentOnBell
1352 visualBell 1358 utmpInhibit visualBell
1353 1359
1354=cut 1360=cut
1355 1361
1356sub resource($$;$) { 1362sub resource($$;$) {
1357 my ($self, $name) = (shift, shift); 1363 my ($self, $name) = (shift, shift);
2250 2256
2251=back 2257=back
2252 2258
2253=head1 AUTHOR 2259=head1 AUTHOR
2254 2260
2255 Marc Lehmann <pcg@goof.com> 2261 Marc Lehmann <schmorp@schmorp.de>
2256 http://software.schmorp.de/pkg/rxvt-unicode 2262 http://software.schmorp.de/pkg/rxvt-unicode
2257 2263
2258=cut 2264=cut
2259 2265
22601 22661

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines