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.35 by root, Fri Jan 6 01:27:27 2006 UTC vs.
Revision 1.37 by root, Fri Jan 6 03:40:19 2006 UTC

… …
137=over 4 137=over 4
138 138
139=item on_init $term 139=item on_init $term
140 140
141Called after a new terminal object has been initialized, but before 141Called after a new terminal object has been initialized, but before
142windows are created or the command gets run. 142windows are created or the command gets run. Most methods are unsafe to
143call or deliver senseless data, as terminal size and other characteristics
144have not yet been determined. You can safely query and change resources,
145though.
143 146
144=item on_reset $term 147=item on_reset $term
145 148
146Called after the screen is "reset" for any reason, such as resizing or 149Called after the screen is "reset" for any reason, such as resizing or
147control sequences. Here is where you can react on changes to size-related 150control sequences. Here is where you can react on changes to size-related
… …
258 261
259Called whenever the user presses a key combination that has a 262Called whenever the user presses a key combination that has a
260C<perl:string> action bound to it (see description of the B<keysym> 263C<perl:string> action bound to it (see description of the B<keysym>
261resource in the @@RXVT_NAME@@(1) manpage). 264resource in the @@RXVT_NAME@@(1) manpage).
262 265
266=item on_key_press $term, $event
267
268=item on_key_release $term, $event
269
270=item on_button_press $term, $event
271
272=item on_button_release $term, $event
273
274=item on_motion_notify $term, $event
275
276Called whenever the corresponding X event is received for the terminal. If
277the hook returns true, then the even will be ignored by rxvt-unicode.
278
279subwindow.
280
263=back 281=back
264 282
265=head2 Variables in the C<urxvt> Package 283=head2 Variables in the C<urxvt> Package
266 284
267=over 4 285=over 4
… …
274=back 292=back
275 293
276=head2 Functions in the C<urxvt> Package 294=head2 Functions in the C<urxvt> Package
277 295
278=over 4 296=over 4
297
298=item $term = new urxvt [arg...]
299
300Creates a new terminal, very similar as if you had started it with
301C<system $binfile, arg...>. Croaks (and probably outputs an error message)
302if the new instance couldn't be created. Returns C<undef> if the new
303instance didn't initialise perl, and the terminal object otherwise. The
304C<init> and C<start> hooks will be called during the call.
279 305
280=item urxvt::fatal $errormessage 306=item urxvt::fatal $errormessage
281 307
282Fatally aborts execution with the given error message. Avoid at all 308Fatally aborts execution with the given error message. Avoid at all
283costs! The only time this is acceptable is when the terminal process 309costs! The only time this is acceptable is when the terminal process
… …
500} 526}
501 527
502=head2 The C<urxvt::term> Class 528=head2 The C<urxvt::term> Class
503 529
504=over 4 530=over 4
531
532=item $term->destroy
533
534Destroy the terminal object (close the window, free resources etc.).
505 535
506=item $value = $term->resource ($name[, $newval]) 536=item $value = $term->resource ($name[, $newval])
507 537
508Returns the current resource value associated with a given name and 538Returns the current resource value associated with a given name and
509optionally sets a new value. Setting values is most useful in the C<init> 539optionally sets a new value. Setting values is most useful in the C<init>
… …
650 680
651Normally its not a good idea to use this function, as programs might be 681Normally its not a good idea to use this function, as programs might be
652confused by changes in cursor position or scrolling. Its useful inside a 682confused by changes in cursor position or scrolling. Its useful inside a
653C<on_add_lines> hook, though. 683C<on_add_lines> hook, though.
654 684
685=item $term->cmd_parse ($octets)
686
687Similar to C<scr_add_lines>, but the argument must be in the
688locale-specific encoding of the terminal and can contain command sequences
689(escape codes) that will be interpreted.
690
655=item $term->tt_write ($octets) 691=item $term->tt_write ($octets)
656 692
657Write the octets given in C<$data> to the tty (i.e. as program input). To 693Write the octets given in C<$data> to the tty (i.e. as program input). To
658pass characters instead of octets, you should convert your strings first 694pass characters instead of octets, you should convert your strings first
659to the locale-specific encoding using C<< $term->locale_encode >>. 695to the locale-specific encoding using C<< $term->locale_encode >>.

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines