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.123 by root, Sat Jan 21 14:49:18 2006 UTC vs.
Revision 1.127 by root, Wed Jan 25 00:42:21 2006 UTC

66contain at least one pair of capturing parentheses, which will be used for 66contain at least one pair of capturing parentheses, which will be used for
67the match. For example, the followign adds a regex that matches everything 67the match. For example, the followign adds a regex that matches everything
68between two vertical bars: 68between two vertical bars:
69 69
70 URxvt.selection.pattern-0: \\|([^|]+)\\| 70 URxvt.selection.pattern-0: \\|([^|]+)\\|
71
72Another example: Programs I use often output "absolute path: " at the
73beginning of a line when they process multiple files. The following
74pattern matches the filename (note, there is a single space at the very
75end):
76
77 URxvt.selection.pattern-0: ^(/[^:]+):\
71 78
72You can look at the source of the selection extension to see more 79You can look at the source of the selection extension to see more
73interesting uses, such as parsing a line from beginning to end. 80interesting uses, such as parsing a line from beginning to end.
74 81
75This extension also offers following bindable keyboard commands: 82This extension also offers following bindable keyboard commands:
139 146
140To avoid too many false positives, this is only done when: 147To avoid too many false positives, this is only done when:
141 148
142=over 4 149=over 4
143 150
151=item - the tty is in ICANON state.
152
153=item - the text cursor is visible.
154
155=item - the primary screen is currently being displayed.
156
144=item - the mouse is on the same (multi-row-) line as the text cursor. 157=item - the mouse is on the same (multi-row-) line as the text cursor.
145
146=item - the primary screen is currently being displayed.
147
148=item - the text cursor is visible.
149 158
150=back 159=back
151 160
152The normal selection mechanism isn't disabled, so quick successive clicks 161The normal selection mechanism isn't disabled, so quick successive clicks
153might interfere with selection creation in harmless ways. 162might interfere with selection creation in harmless ways.
361Called at the very end of initialisation of a new terminal, just before 370Called at the very end of initialisation of a new terminal, just before
362trying to map (display) the toplevel and returning to the mainloop. 371trying to map (display) the toplevel and returning to the mainloop.
363 372
364=item on_destroy $term 373=item on_destroy $term
365 374
366Called whenever something tries to destroy terminal, before doing anything 375Called whenever something tries to destroy terminal, when the terminal is
367yet. If this hook returns true, then destruction is skipped, but this is 376still fully functional (not for long, though).
368rarely a good idea.
369 377
370=item on_reset $term 378=item on_reset $term
371 379
372Called after the screen is "reset" for any reason, such as resizing or 380Called after the screen is "reset" for any reason, such as resizing or
373control sequences. Here is where you can react on changes to size-related 381control sequences. Here is where you can react on changes to size-related
561our $LIBDIR; 569our $LIBDIR;
562our $RESNAME; 570our $RESNAME;
563our $RESCLASS; 571our $RESCLASS;
564our $RXVTNAME; 572our $RXVTNAME;
565 573
566our $NOCHAR = chr 0xfffe; 574our $NOCHAR = chr 0xffff;
567 575
568=head2 Variables in the C<urxvt> Package 576=head2 Variables in the C<urxvt> Package
569 577
570=over 4 578=over 4
571 579
718 unless $msg =~ /\n$/; 726 unless $msg =~ /\n$/;
719 urxvt::warn ($msg); 727 urxvt::warn ($msg);
720 }; 728 };
721} 729}
722 730
731no warnings 'utf8';
732
723my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 733my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
724 734
725sub verbose { 735sub verbose {
726 my ($level, $msg) = @_; 736 my ($level, $msg) = @_;
727 warn "$msg\n" if $level <= $verbosity; 737 warn "$msg\n" if $level <= $verbosity;
743 753
744 open my $fh, "<:raw", $path 754 open my $fh, "<:raw", $path
745 or die "$path: $!"; 755 or die "$path: $!";
746 756
747 my $source = 757 my $source =
748 "package $pkg; use strict; use utf8;\n" 758 "package $pkg; use strict; use utf8; no warnings 'utf8';\n"
749 . "#line 1 \"$path\"\n{\n" 759 . "#line 1 \"$path\"\n{\n"
750 . (do { local $/; <$fh> }) 760 . (do { local $/; <$fh> })
751 . "\n};\n1"; 761 . "\n};\n1";
752 762
753 eval $source 763 eval $source
1308Replaces the event mask of the pty watcher by the given event mask. Can 1318Replaces the event mask of the pty watcher by the given event mask. Can
1309be used to suppress input and output handling to the pty/tty. See the 1319be used to suppress input and output handling to the pty/tty. See the
1310description of C<< urxvt::timer->events >>. Make sure to always restore 1320description of C<< urxvt::timer->events >>. Make sure to always restore
1311the previous value. 1321the previous value.
1312 1322
1323=item $fd = $term->pty_fd
1324
1325Returns the master file descriptor for the pty in use, or C<-1> if no pty
1326is used.
1327
1313=item $windowid = $term->parent 1328=item $windowid = $term->parent
1314 1329
1315Return the window id of the toplevel window. 1330Return the window id of the toplevel window.
1316 1331
1317=item $windowid = $term->vt 1332=item $windowid = $term->vt
1416If C<$new_text> is specified, it will replace characters in the current 1431If C<$new_text> is specified, it will replace characters in the current
1417line, starting at column C<$start_col> (default C<0>), which is useful 1432line, starting at column C<$start_col> (default C<0>), which is useful
1418to replace only parts of a line. The font index in the rendition will 1433to replace only parts of a line. The font index in the rendition will
1419automatically be updated. 1434automatically be updated.
1420 1435
1421C<$text> is in a special encoding: tabs and wide characters that use 1436C<$text> is in a special encoding: tabs and wide characters that use more
1422more than one cell when displayed are padded with C<$urxvt::NOCHAR> 1437than one cell when displayed are padded with C<$urxvt::NOCHAR> (chr 65535)
1423characters. Characters with combining characters and other characters that 1438characters. Characters with combining characters and other characters that
1424do not fit into the normal tetx encoding will be replaced with characters 1439do not fit into the normal tetx encoding will be replaced with characters
1425in the private use area. 1440in the private use area.
1426 1441
1427You have to obey this encoding when changing text. The advantage is 1442You have to obey this encoding when changing text. The advantage is

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines