Everytime a terminal object gets created, extension scripts specified via +
Every time a terminal object gets created, extension scripts specified via
the perl resource are loaded and associated with it.
Scripts are compiled in a 'use strict' and 'use utf8' environment, and thus must be encoded as UTF-8.
@@ -117,7 +117,7 @@The index number (0, 1...) must not have any holes, and each regex must contain at least one pair of capturing parentheses, which will be used for -the match. For example, the followign adds a regex that matches everything +the match. For example, the following adds a regex that matches everything between two vertical bars:
It's sole argument is the popup menu, which can be modified. The selection
-is in $_, which can be used to decide wether to add something or not.
+is in $_, which can be used to decide whether to add something or not.
It should either return nothing or a string and a code reference. The
string will be used as button text and the code reference will be called
when the button gets activated and should transform $_.
This transforms the terminal into a tabbar with additional terminals, that -is, it implements what is commonly refered to as ``tabbed terminal''. The topmost line +is, it implements what is commonly referred to as ``tabbed terminal''. The topmost line displays a ``[NEW]'' button, which, when clicked, will add a new tab, followed by one button per tab.
The accelerator key is grabbed regardless of any modifers, so this +
The accelerator key is grabbed regardless of any modifiers, so this extension will actually grab a physical key just for this function.
This is basically a very small extension that dynamically changes the background pixmap offset to the window position, in effect creating the same effect as pseudo transparency with a custom pixmap. No scaling is -supported in this mode. Exmaple:
+supported in this mode. Example:@@ -583,7 +583,7 @@Hooks
The following subroutines can be declared in extension files, and will be called whenever the relevant event happens.
-The first argument passed to them is an extension oject as described in +
The first argument passed to them is an extension object as described in the in the
Extension Objectssection.All of these hooks must return a boolean value. If any of the called hooks returns true, then the event counts as being consumed, and the @@ -605,7 +605,7 @@
Called at the very end of initialisation of a new terminal, just before -trying to map (display) the toplevel and returning to the mainloop.
+trying to map (display) the toplevel and returning to the main loop.$term->selection.
Returning a true value aborts selection grabbing. It will still be hilighted.
+Returning a true value aborts selection grabbing. It will still be highlighted.
Called whenever the user tries to extend the selection (e.g. with a double click) and is either supposed to return false (normal operation), or -should extend the selection itelf and return true to suppress the built-in +should extend the selection itself and return true to suppress the built-in processing. This can happen multiple times, as long as the callback returns true, it will be called on every further click by the user and is supposed to enlarge the selection more and more, if possible.
@@ -676,7 +676,7 @@Called whenever the view offset changes, i..e the user or program +
Called whenever the view offset changes, i.e. the user or program
scrolls. Offset 0 means display the normal terminal, positive values
show this many lines of scrollback.
Be careful not ever to trust (in a security sense) the data you receive, -as its source can not easily be controleld (e-mail content, messages from +as its source can not easily be controlled (e-mail content, messages from other users on the same system etc.).
Called whenever the a user-configured event is being activated (e.g. via +
Called whenever a user-configured event is being activated (e.g. via
a perl:string action bound to a key, see description of the keysym
resource in the rxvt(1) manpage).
Called just after the new window size has been calculcated, but before +
Called just after the new window size has been calculated, but before windows are actually being resized or hints are being set. If this hook returns TRUE, setting of the window hints is being skipped.
Called wheneever the window loses keyboard focus, before rxvt-unicode does +
Called whenever the window loses keyboard focus, before rxvt-unicode does focus out processing.
All coderefs in this array will be called as methods of the next newly +
All code references in this array will be called as methods of the next newly
created urxvt::term object (during the on_init phase). The array
-gets cleared before the codereferences that were in it are being executed,
-so coderefs can push themselves onto it again if they so desire.
This complements to the perl-eval commandline option, but gets executed +
This complements to the perl-eval command line option, but gets executed first.
Returns all urxvt::term objects that exist in this process, regardless of -wether they are started, being destroyed etc., so be careful. Only term +whether they are started, being destroyed etc., so be careful. Only term objects that have perl extensions attached will be returned (because there is no urxvt::term objet associated with others).
%urxvt::OPTION. Options not enabled in this binary are not in the hash.
Here is a a likely non-exhaustive list of option names, please see the +
Here is a likely non-exhaustive list of option names, please see the source file /src/optinc.h to see the actual list:
Here is a a likely non-exhaustive list of resource names, not all of which +
Here is a likely non-exhaustive list of resource names, not all of which are supported in every build, please see the source file /src/rsinc.h to see the actual list:
Returns wether the cursor is currently hidden or not.
+Returns whether the cursor is currently hidden or not.
Converts rxvt-unicodes text reprsentation into a perl string. See +
Converts rxvt-unicodes text representation into a perl string. See
$term->ROW_t for details.
Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
-synchronous ($sync is true). Also remembers the grab timestampe.
$sync is true). Also remembers the grab timestamp.
Set the filedescriptor (not handle) to watch.
+Set the file descriptor (not handle) to watch.
Stop watching for events on the given filehandle.
+Stop watching for events on the given file handle.
Tells the wqtcher to start watching for process $pid.
Tells the watcher to start watching for process $pid.