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.24 by root, Tue Jan 3 20:47:36 2006 UTC vs.
Revision 1.43 by root, Sat Jan 7 04:19:43 2006 UTC

39 39
40=over 4 40=over 4
41 41
42=item selection 42=item selection
43 43
44Intelligent selection. This etxension tries to be more intelligent when the user 44Intelligent selection. This extension tries to be more intelligent when
45extends selections (double-click). 45the user extends selections (double-click). Right now, it tries to select
46urls and complete shell-quoted arguments, which is very convenient, too,
47if your F<ls> supports C<--quoting-style=shell>.
46 48
47It also offers the following bindable event: 49It also offers the following bindable event:
48 50
49=over 4 51=over 4
50 52
57=back 59=back
58 60
59=item digital-clock 61=item digital-clock
60 62
61Displays a digital clock using the built-in overlay. 63Displays a digital clock using the built-in overlay.
64
65=item mark-urls
66
67Uses per-line display filtering (C<on_line_update>) to underline urls.
68
69=item block-graphics-to-ascii
70
71A not very useful example of filtering all text output to the terminal,
72by replacing all line-drawing characters (U+2500 .. U+259F) by a
73similar-looking ascii character.
62 74
63=item example-refresh-hooks 75=item example-refresh-hooks
64 76
65Displays a very simple digital clock in the upper right corner of the 77Displays a very simple digital clock in the upper right corner of the
66window. Illustrates overwriting the refresh callbacks to create your own 78window. Illustrates overwriting the refresh callbacks to create your own
79When objects are destroyed on the C++ side, the perl object hashes are 91When objects are destroyed on the C++ side, the perl object hashes are
80emptied, so its best to store related objects such as time watchers and 92emptied, so its best to store related objects such as time watchers and
81the like inside the terminal object so they get destroyed as soon as the 93the like inside the terminal object so they get destroyed as soon as the
82terminal is destroyed. 94terminal is destroyed.
83 95
96Argument names also often indicate the type of a parameter. Here are some
97hints on what they mean:
98
99=over 4
100
101=item $text
102
103Rxvt-unicodes special way of encoding text, where one "unicode" character
104always represents one screen cell. See L<row_t> for a discussion of this format.
105
106=item $string
107
108A perl text string, with an emphasis on I<text>. It can store all unicode
109characters and is to be distinguished with text encoded in a specific
110encoding (often locale-specific) and binary data.
111
112=item $octets
113
114Either binary data or - more common - a text string encoded in a
115locale-specific way.
116
117=back
118
84=head2 Hooks 119=head2 Hooks
85 120
86The following subroutines can be declared in loaded scripts, and will be 121The following subroutines can be declared in extension files, and will be
87called whenever the relevant event happens. 122called whenever the relevant event happens.
88 123
89The first argument passed to them is an object private to each terminal 124The first argument passed to them is an object private to each terminal
90and extension package. You can call all C<urxvt::term> methods on it, but 125and extension package. You can call all C<urxvt::term> methods on it, but
91its not a real C<urxvt::term> object. Instead, the real C<urxvt::term> 126its not a real C<urxvt::term> object. Instead, the real C<urxvt::term>
101=over 4 136=over 4
102 137
103=item on_init $term 138=item on_init $term
104 139
105Called after a new terminal object has been initialized, but before 140Called after a new terminal object has been initialized, but before
106windows are created or the command gets run. 141windows are created or the command gets run. Most methods are unsafe to
142call or deliver senseless data, as terminal size and other characteristics
143have not yet been determined. You can safely query and change resources,
144though.
107 145
108=item on_reset $term 146=item on_reset $term
109 147
110Called after the screen is "reset" for any reason, such as resizing or 148Called after the screen is "reset" for any reason, such as resizing or
111control sequences. Here is where you can react on changes to size-related 149control sequences. Here is where you can react on changes to size-related
170 208
171=item on_tty_activity $term *NYI* 209=item on_tty_activity $term *NYI*
172 210
173Called whenever the program(s) running in the urxvt window send output. 211Called whenever the program(s) running in the urxvt window send output.
174 212
213=item on_osc_seq $term, $string
214
215Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC =
216operating system command) is processed. Cursor position and other state
217information is up-to-date when this happens. For interoperability, the
218string should start with the extension name and a colon, to distinguish
219it from commands for other extensions, and this might be enforced in the
220future.
221
222Be careful not ever to trust (in a security sense) the data you receive,
223as its source can not easily be controleld (e-mail content, messages from
224other users on the same system etc.).
225
226=item on_add_lines $term, $string
227
228Called whenever text is about to be output, with the text as argument. You
229can filter/change and output the text yourself by returning a true value
230and calling C<< $term->scr_add_lines >> yourself. Please note that this
231might be very slow, however, as your hook is called for B<all> text being
232output.
233
234=item on_line_update $term, $row
235
236Called whenever a line was updated or changed. Can be used to filter
237screen output (e.g. underline urls or other useless stuff). Only lines
238that are being shown will be filtered, and, due to performance reasons,
239not always immediately.
240
241The row number is always the topmost row of the line if the line spans
242multiple rows.
243
244Please note that, if you change the line, then the hook might get called
245later with the already-modified line (e.g. if unrelated parts change), so
246you cannot just toggle rendition bits, but only set them.
247
175=item on_refresh_begin $term 248=item on_refresh_begin $term
176 249
177Called just before the screen gets redrawn. Can be used for overlay 250Called just before the screen gets redrawn. Can be used for overlay
178or similar effects by modify terminal contents in refresh_begin, and 251or similar effects by modify terminal contents in refresh_begin, and
179restoring them in refresh_end. The built-in overlay and selection display 252restoring them in refresh_end. The built-in overlay and selection display
187 260
188Called whenever the user presses a key combination that has a 261Called whenever the user presses a key combination that has a
189C<perl:string> action bound to it (see description of the B<keysym> 262C<perl:string> action bound to it (see description of the B<keysym>
190resource in the @@RXVT_NAME@@(1) manpage). 263resource in the @@RXVT_NAME@@(1) manpage).
191 264
265=item on_key_press $term, $event, $octets
266
267=item on_key_release $term, $event
268
269=item on_button_press $term, $event
270
271=item on_button_release $term, $event
272
273=item on_motion_notify $term, $event
274
275Called whenever the corresponding X event is received for the terminal If
276the hook returns true, then the even will be ignored by rxvt-unicode.
277
278The event is a hash with most values as named by Xlib (see the XEvent
279manpage), with the additional members C<row> and C<col>, which are the row
280and column under the mouse cursor.
281
282C<on_key_press> additionally receives the string rxvt-unicode would
283output, if any, in locale-specific encoding.
284
285subwindow.
286
192=back 287=back
193 288
194=head2 Variables in the C<urxvt> Package 289=head2 Variables in the C<urxvt> Package
195 290
196=over 4 291=over 4
197 292
198=item $urxvt::TERM 293=item $urxvt::TERM
199 294
200The current terminal. Whenever a callback/Hook is bein executed, this 295The current terminal. This variable stores the current C<urxvt::term>
201variable stores the current C<urxvt::term> object. 296object, whenever a callback/hook is executing.
202 297
203=back 298=back
204 299
205=head2 Functions in the C<urxvt> Package 300=head2 Functions in the C<urxvt> Package
206 301
207=over 4 302=over 4
303
304=item $term = new urxvt [arg...]
305
306Creates a new terminal, very similar as if you had started it with
307C<system $binfile, arg...>. Croaks (and probably outputs an error message)
308if the new instance couldn't be created. Returns C<undef> if the new
309instance didn't initialise perl, and the terminal object otherwise. The
310C<init> and C<start> hooks will be called during the call.
208 311
209=item urxvt::fatal $errormessage 312=item urxvt::fatal $errormessage
210 313
211Fatally aborts execution with the given error message. Avoid at all 314Fatally aborts execution with the given error message. Avoid at all
212costs! The only time this is acceptable is when the terminal process 315costs! The only time this is acceptable is when the terminal process
351 454
352 $pkg 455 $pkg
353 } 456 }
354} 457}
355 458
459our $retval; # return value for urxvt
460
356# called by the rxvt core 461# called by the rxvt core
357sub invoke { 462sub invoke {
358 local $TERM = shift; 463 local $TERM = shift;
359 my $htype = shift; 464 my $htype = shift;
360 465
361 if ($htype == 0) { # INIT 466 if ($htype == 0) { # INIT
362 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); 467 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl");
363 468
364 for my $ext (split /:/, $TERM->resource ("perl_ext")) { 469 for my $ext (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
365 my @files = grep -f $_, map "$_/$ext", @dirs; 470 my @files = grep -f $_, map "$_/$ext", @dirs;
366 471
367 if (@files) { 472 if (@files) {
368 register_package script_package $files[0]; 473 register_package script_package $files[0];
369 } else { 474 } else {
370 warn "perl extension '$ext' not found in perl library search path\n"; 475 warn "perl extension '$ext' not found in perl library search path\n";
371 } 476 }
372 } 477 }
478 }
373 479
480 $retval = undef;
481
482 if (my $cb = $TERM->{_hook}[$htype]) {
483 verbose 10, "$HOOKNAME[$htype] (" . (join ", ", $TERM, @_) . ")"
484 if $verbosity >= 10;
485
486 keys %$cb;
487
488 while (my ($pkg, $cb) = each %$cb) {
489 $retval = $cb->(
490 $TERM->{_pkg}{$pkg} ||= do {
491 my $proxy = bless { }, urxvt::term::proxy::;
492 Scalar::Util::weaken ($proxy->{term} = $TERM);
493 $proxy
494 },
495 @_,
496 ) and last;
497 }
498 }
499
374 } elsif ($htype == 1) { # DESTROY 500 if ($htype == 1) { # DESTROY
501 # remove hooks if unused
375 if (my $hook = $TERM->{_hook}) { 502 if (my $hook = $TERM->{_hook}) {
376 for my $htype (0..$#$hook) { 503 for my $htype (0..$#$hook) {
377 $hook_count[$htype] -= scalar keys %{ $hook->[$htype] || {} } 504 $hook_count[$htype] -= scalar keys %{ $hook->[$htype] || {} }
378 or set_should_invoke $htype, 0; 505 or set_should_invoke $htype, 0;
379 } 506 }
380 } 507 }
508
509 # clear package objects
510 %$_ = () for values %{ $TERM->{_pkg} };
511
512 # clear package
513 %$TERM = ();
381 } 514 }
382 515
383 my $cb = $TERM->{_hook}[$htype] 516 $retval
384 or return;
385
386 verbose 10, "$HOOKNAME[$htype] (" . (join ", ", $TERM, @_) . ")"
387 if $verbosity >= 10;
388
389 while (my ($pkg, $cb) = each %$cb) {
390 return 1
391 if $cb->(
392 $TERM->{$pkg} ||= do {
393 my $proxy = bless { }, urxvt::term::proxy::;
394 Scalar::Util::weaken ($proxy->{term} = $TERM);
395 $proxy
396 },
397 @_,
398 );
399 }
400
401 0
402} 517}
403 518
404sub urxvt::term::proxy::AUTOLOAD { 519sub urxvt::term::proxy::AUTOLOAD {
405 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/ 520 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/
406 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable"; 521 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable";
418 533
419=head2 The C<urxvt::term> Class 534=head2 The C<urxvt::term> Class
420 535
421=over 4 536=over 4
422 537
538=item $term->destroy
539
540Destroy the terminal object (close the window, free resources etc.).
541
423=item $value = $term->resource ($name[, $newval]) 542=item $value = $term->resource ($name[, $newval])
424 543
425Returns the current resource value associated with a given name and 544Returns the current resource value associated with a given name and
426optionally sets a new value. Setting values is most useful in the C<init> 545optionally sets a new value. Setting values is most useful in the C<init>
427hook. Unset resources are returned and accepted as C<undef>. 546hook. Unset resources are returned and accepted as C<undef>.
444 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont 563 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont
445 borderLess color cursorBlink cursorUnderline cutchars delete_key 564 borderLess color cursorBlink cursorUnderline cutchars delete_key
446 display_name embed ext_bwidth fade font geometry hold iconName 565 display_name embed ext_bwidth fade font geometry hold iconName
447 imFont imLocale inputMethod insecure int_bwidth intensityStyles 566 imFont imLocale inputMethod insecure int_bwidth intensityStyles
448 italicFont jumpScroll lineSpace loginShell mapAlert menu meta8 modifier 567 italicFont jumpScroll lineSpace loginShell mapAlert menu meta8 modifier
449 mouseWheelScrollPage name pastableTabs path perl_eval perl_ext 568 mouseWheelScrollPage name pastableTabs path perl_eval perl_ext_1 perl_ext_2
450 perl_lib pointerBlank pointerBlankDelay preeditType print_pipe pty_fd 569 perl_lib pointerBlank pointerBlankDelay preeditType print_pipe pty_fd
451 reverseVideo saveLines scrollBar scrollBar_align scrollBar_floating 570 reverseVideo saveLines scrollBar scrollBar_align scrollBar_floating
452 scrollBar_right scrollBar_thickness scrollTtyKeypress scrollTtyOutput 571 scrollBar_right scrollBar_thickness scrollTtyKeypress scrollTtyOutput
453 scrollWithBuffer scrollstyle secondaryScreen secondaryScroll selectstyle 572 scrollWithBuffer scrollstyle secondaryScreen secondaryScroll selectstyle
454 shade term_name title transparent transparent_all tripleclickwords 573 shade term_name title transparent transparent_all tripleclickwords
460 my ($self, $name) = (shift, shift); 579 my ($self, $name) = (shift, shift);
461 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 580 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
462 goto &urxvt::term::_resource; 581 goto &urxvt::term::_resource;
463} 582}
464 583
584=item $rend = $term->rstyle ([$new_rstyle])
585
586Return and optionally change the current rendition. Text that is output by
587the terminal application will use this style.
588
589=item ($row, $col) = $term->screen_cur ([$row, $col])
590
591Return the current coordinates of the text cursor position and optionally
592set it (which is usually bad as applications don't expect that).
593
465=item ($row, $col) = $term->selection_mark ([$row, $col]) 594=item ($row, $col) = $term->selection_mark ([$row, $col])
466 595
467=item ($row, $col) = $term->selection_beg ([$row, $col]) 596=item ($row, $col) = $term->selection_beg ([$row, $col])
468 597
469=item ($row, $col) = $term->selection_end ([$row, $col]) 598=item ($row, $col) = $term->selection_end ([$row, $col])
483#=item $term->overlay ($x, $y, $text) 612#=item $term->overlay ($x, $y, $text)
484# 613#
485#Create a simple multi-line overlay box. See the next method for details. 614#Create a simple multi-line overlay box. See the next method for details.
486# 615#
487#=cut 616#=cut
488 617#
489sub urxvt::term::scr_overlay { 618#sub urxvt::term::scr_overlay {
490die;
491 my ($self, $x, $y, $text) = @_; 619# my ($self, $x, $y, $text) = @_;
492 620#
493 my @lines = split /\n/, $text; 621# my @lines = split /\n/, $text;
494 622#
495 my $w = 0; 623# my $w = 0;
496 for (map $self->strwidth ($_), @lines) { 624# for (map $self->strwidth ($_), @lines) {
497 $w = $_ if $w < $_; 625# $w = $_ if $w < $_;
498 } 626# }
499 627#
500 $self->scr_overlay_new ($x, $y, $w, scalar @lines); 628# $self->scr_overlay_new ($x, $y, $w, scalar @lines);
501 $self->scr_overlay_set (0, $_, $lines[$_]) for 0.. $#lines; 629# $self->scr_overlay_set (0, $_, $lines[$_]) for 0.. $#lines;
502} 630#}
503 631
504=item $term->overlay ($x, $y, $width, $height[, $rstyle[, $border]]) 632=item $term->overlay ($x, $y, $width, $height[, $rstyle[, $border]])
505 633
506Create a new (empty) overlay at the given position with the given 634Create a new (empty) overlay at the given position with the given
507width/height. C<$rstyle> defines the initial rendition style 635width/height. C<$rstyle> defines the initial rendition style
534 662
535If hidden, display the overlay again. 663If hidden, display the overlay again.
536 664
537=back 665=back
538 666
539=item $cellwidth = $term->strwidth $string 667=item $cellwidth = $term->strwidth ($string)
540 668
541Returns the number of screen-cells this string would need. Correctly 669Returns the number of screen-cells this string would need. Correctly
542accounts for wide and combining characters. 670accounts for wide and combining characters.
543 671
544=item $octets = $term->locale_encode $string 672=item $octets = $term->locale_encode ($string)
545 673
546Convert the given text string into the corresponding locale encoding. 674Convert the given text string into the corresponding locale encoding.
547 675
548=item $string = $term->locale_decode $octets 676=item $string = $term->locale_decode ($octets)
549 677
550Convert the given locale-encoded octets into a perl string. 678Convert the given locale-encoded octets into a perl string.
679
680=item $term->scr_add_lines ($string)
681
682Write the given text string to the screen, as if output by the application
683running inside the terminal. It may not contain command sequences (escape
684codes), but is free to use line feeds, carriage returns and tabs. The
685string is a normal text string, not in locale-dependent encoding.
686
687Normally its not a good idea to use this function, as programs might be
688confused by changes in cursor position or scrolling. Its useful inside a
689C<on_add_lines> hook, though.
690
691=item $term->cmd_parse ($octets)
692
693Similar to C<scr_add_lines>, but the argument must be in the
694locale-specific encoding of the terminal and can contain command sequences
695(escape codes) that will be interpreted.
551 696
552=item $term->tt_write ($octets) 697=item $term->tt_write ($octets)
553 698
554Write the octets given in C<$data> to the tty (i.e. as program input). To 699Write the octets given in C<$data> to the tty (i.e. as program input). To
555pass characters instead of octets, you should convert your strings first 700pass characters instead of octets, you should convert your strings first
556to the locale-specific encoding using C<< $term->locale_encode >>. 701to the locale-specific encoding using C<< $term->locale_encode >>.
557 702
703=item $windowid = $term->parent
704
705Return the window id of the toplevel window.
706
707=item $windowid = $term->vt
708
709Return the window id of the terminal window.
710
711=item $window_width = $term->width
712
713=item $window_height = $term->height
714
715=item $font_width = $term->fwidth
716
717=item $font_height = $term->fheight
718
719=item $font_ascent = $term->fbase
720
558=item $nrow = $term->nrow 721=item $terminal_rows = $term->nrow
559 722
560=item $ncol = $term->ncol 723=item $terminal_columns = $term->ncol
561 724
562Return the number of rows/columns of the terminal window (i.e. as 725=item $has_focus = $term->focus
563specified by C<-geometry>, excluding any scrollback).
564 726
565=item $nsaved = $term->nsaved 727=item $is_mapped = $term->mapped
566 728
567Returns the number of lines in the scrollback buffer. 729=item $max_scrollback = $term->saveLines
730
731=item $nrow_plus_saveLines = $term->total_rows
732
733=item $lines_in_scrollback = $term->nsaved
734
735Return various integers describing terminal characteristics.
568 736
569=item $view_start = $term->view_start ([$newvalue]) 737=item $view_start = $term->view_start ([$newvalue])
570 738
571Returns the negative row number of the topmost line. Minimum value is 739Returns the negative row number of the topmost line. Minimum value is
572C<0>, which displays the normal terminal contents. Larger values scroll 740C<0>, which displays the normal terminal contents. Larger values scroll
635about the logical line that row C<$row_number> is part of. It supports the 803about the logical line that row C<$row_number> is part of. It supports the
636following methods: 804following methods:
637 805
638=over 4 806=over 4
639 807
640=item $text = $line->t 808=item $text = $line->t ([$new_text])
641 809
642Returns the full text of the line, similar to C<ROW_t> 810Returns or replaces the full text of the line, similar to C<ROW_t>
643 811
644=item $rend = $line->r 812=item $rend = $line->r ([$new_rend])
645 813
646Returns the full rendition array of the line, similar to C<ROW_r> 814Returns or replaces the full rendition array of the line, similar to C<ROW_r>
647 815
648=item $length = $line->l 816=item $length = $line->l
649 817
650Returns the length of the line in cells, similar to C<ROW_l>. 818Returns the length of the line in cells, similar to C<ROW_l>.
651 819
680 848
681 bless { 849 bless {
682 term => $self, 850 term => $self,
683 beg => $beg, 851 beg => $beg,
684 end => $end, 852 end => $end,
853 ncol => $self->ncol,
685 len => ($end - $beg) * $self->ncol + $self->ROW_l ($end), 854 len => ($end - $beg) * $self->ncol + $self->ROW_l ($end),
686 }, urxvt::line:: 855 }, urxvt::line::
687} 856}
688 857
689sub urxvt::line::t { 858sub urxvt::line::t {
690 my ($self) = @_; 859 my ($self) = @_;
691 860
861 if (@_ > 1)
862 {
863 $self->{term}->ROW_t ($_, $_[1], 0, ($_ - $self->{beg}) * $self->{ncol}, $self->{ncol})
864 for $self->{beg} .. $self->{end};
865 }
866
867 defined wantarray &&
692 substr +(join "", map $self->{term}->ROW_t ($_), $self->{beg} .. $self->{end}), 868 substr +(join "", map $self->{term}->ROW_t ($_), $self->{beg} .. $self->{end}),
693 0, $self->{len} 869 0, $self->{len}
694} 870}
695 871
696sub urxvt::line::r { 872sub urxvt::line::r {
697 my ($self) = @_; 873 my ($self) = @_;
698 874
875 if (@_ > 1)
876 {
877 $self->{term}->ROW_r ($_, $_[1], 0, ($_ - $self->{beg}) * $self->{ncol}, $self->{ncol})
878 for $self->{beg} .. $self->{end};
879 }
880
881 if (defined wantarray) {
699 my $rend = [ 882 my $rend = [
700 map @{ $self->{term}->ROW_r ($_) }, $self->{beg} .. $self->{end} 883 map @{ $self->{term}->ROW_r ($_) }, $self->{beg} .. $self->{end}
701 ]; 884 ];
702 $#$rend = $self->{len} - 1; 885 $#$rend = $self->{len} - 1;
703 $rend 886 return $rend;
887 }
888
889 ()
704} 890}
705 891
706sub urxvt::line::beg { $_[0]{beg} } 892sub urxvt::line::beg { $_[0]{beg} }
707sub urxvt::line::end { $_[0]{end} } 893sub urxvt::line::end { $_[0]{end} }
708sub urxvt::line::l { $_[0]{len} } 894sub urxvt::line::l { $_[0]{len} }
709 895
710sub urxvt::line::offset_of { 896sub urxvt::line::offset_of {
711 my ($self, $row, $col) = @_; 897 my ($self, $row, $col) = @_;
712 898
713 ($row - $self->{beg}) * $self->{term}->ncol + $col 899 ($row - $self->{beg}) * $self->{ncol} + $col
714} 900}
715 901
716sub urxvt::line::coord_of { 902sub urxvt::line::coord_of {
717 my ($self, $offset) = @_; 903 my ($self, $offset) = @_;
718 904
719 use integer; 905 use integer;
720 906
721 ( 907 (
722 $offset / $self->{term}->ncol + $self->{beg}, 908 $offset / $self->{ncol} + $self->{beg},
723 $offset % $self->{term}->ncol 909 $offset % $self->{ncol}
724 ) 910 )
725} 911}
726 912
727=item ($row, $col) = $line->coord_of ($offset) 913=item ($row, $col) = $line->coord_of ($offset)
728=item $text = $term->special_encode $string 914=item $text = $term->special_encode $string
846This variable controls the verbosity level of the perl extension. Higher 1032This variable controls the verbosity level of the perl extension. Higher
847numbers indicate more verbose output. 1033numbers indicate more verbose output.
848 1034
849=over 4 1035=over 4
850 1036
851=item 0 - only fatal messages 1037=item =0 - only fatal messages
852 1038
853=item 3 - script loading and management 1039=item =3 - script loading and management
854 1040
855=item 10 - all events received 1041=item =10 - all events received
856 1042
857=back 1043=back
858 1044
859=head1 AUTHOR 1045=head1 AUTHOR
860 1046

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines