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.128 by root, Wed Jan 25 00:57:57 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.
202 211
203Uses per-line display filtering (C<on_line_update>) to underline urls and 212Uses per-line display filtering (C<on_line_update>) to underline urls and
204make them clickable. When middle-clicked, the program specified in the 213make them clickable. When middle-clicked, the program specified in the
205resource C<urlLauncher> (default C<x-www-browser>) will be started with 214resource C<urlLauncher> (default C<x-www-browser>) will be started with
206the URL as first argument. 215the URL as first argument.
216
217=item xim-onthespot
218
219This (experimental) perl extension implements OnTheSpot editing. It does
220not work perfectly, and some input methods don't seem to work well with
221OnTheSpot editing in general, but it seems to work at leats for SCIM and
222kinput2.
223
224You enable it by specifying this extension and a preedit style of
225C<OnTheSpot>, i.e.:
226
227 @@RXVT_NAME@@ -pt OnTheSpot -pe xim-onthespot
207 228
208=item automove-background 229=item automove-background
209 230
210This is basically a one-line extension that dynamically changes the background pixmap offset 231This is basically a one-line extension that dynamically changes the background pixmap offset
211to the window position, in effect creating the same effect as pseudo transparency with 232to the window position, in effect creating the same effect as pseudo transparency with
361Called at the very end of initialisation of a new terminal, just before 382Called at the very end of initialisation of a new terminal, just before
362trying to map (display) the toplevel and returning to the mainloop. 383trying to map (display) the toplevel and returning to the mainloop.
363 384
364=item on_destroy $term 385=item on_destroy $term
365 386
366Called whenever something tries to destroy terminal, before doing anything 387Called whenever something tries to destroy terminal, when the terminal is
367yet. If this hook returns true, then destruction is skipped, but this is 388still fully functional (not for long, though).
368rarely a good idea.
369 389
370=item on_reset $term 390=item on_reset $term
371 391
372Called after the screen is "reset" for any reason, such as resizing or 392Called 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 393control sequences. Here is where you can react on changes to size-related
561our $LIBDIR; 581our $LIBDIR;
562our $RESNAME; 582our $RESNAME;
563our $RESCLASS; 583our $RESCLASS;
564our $RXVTNAME; 584our $RXVTNAME;
565 585
566our $NOCHAR = chr 0xfffe; 586our $NOCHAR = chr 0xffff;
567 587
568=head2 Variables in the C<urxvt> Package 588=head2 Variables in the C<urxvt> Package
569 589
570=over 4 590=over 4
571 591
718 unless $msg =~ /\n$/; 738 unless $msg =~ /\n$/;
719 urxvt::warn ($msg); 739 urxvt::warn ($msg);
720 }; 740 };
721} 741}
722 742
743no warnings 'utf8';
744
723my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 745my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
724 746
725sub verbose { 747sub verbose {
726 my ($level, $msg) = @_; 748 my ($level, $msg) = @_;
727 warn "$msg\n" if $level <= $verbosity; 749 warn "$msg\n" if $level <= $verbosity;
743 765
744 open my $fh, "<:raw", $path 766 open my $fh, "<:raw", $path
745 or die "$path: $!"; 767 or die "$path: $!";
746 768
747 my $source = 769 my $source =
748 "package $pkg; use strict; use utf8;\n" 770 "package $pkg; use strict; use utf8; no warnings 'utf8';\n"
749 . "#line 1 \"$path\"\n{\n" 771 . "#line 1 \"$path\"\n{\n"
750 . (do { local $/; <$fh> }) 772 . (do { local $/; <$fh> })
751 . "\n};\n1"; 773 . "\n};\n1";
752 774
753 eval $source 775 eval $source
1308Replaces the event mask of the pty watcher by the given event mask. Can 1330Replaces 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 1331be used to suppress input and output handling to the pty/tty. See the
1310description of C<< urxvt::timer->events >>. Make sure to always restore 1332description of C<< urxvt::timer->events >>. Make sure to always restore
1311the previous value. 1333the previous value.
1312 1334
1335=item $fd = $term->pty_fd
1336
1337Returns the master file descriptor for the pty in use, or C<-1> if no pty
1338is used.
1339
1313=item $windowid = $term->parent 1340=item $windowid = $term->parent
1314 1341
1315Return the window id of the toplevel window. 1342Return the window id of the toplevel window.
1316 1343
1317=item $windowid = $term->vt 1344=item $windowid = $term->vt
1416If C<$new_text> is specified, it will replace characters in the current 1443If 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 1444line, 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 1445to replace only parts of a line. The font index in the rendition will
1419automatically be updated. 1446automatically be updated.
1420 1447
1421C<$text> is in a special encoding: tabs and wide characters that use 1448C<$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> 1449than one cell when displayed are padded with C<$urxvt::NOCHAR> (chr 65535)
1423characters. Characters with combining characters and other characters that 1450characters. Characters with combining characters and other characters that
1424do not fit into the normal tetx encoding will be replaced with characters 1451do not fit into the normal tetx encoding will be replaced with characters
1425in the private use area. 1452in the private use area.
1426 1453
1427You have to obey this encoding when changing text. The advantage is 1454You have to obey this encoding when changing text. The advantage is

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines