-.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
.\"
.\" Standard preamble:
.\" ========================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
.el .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 3"
-.TH @@RXVT_NAME@@ 3 "2008-11-08" "@@RXVT_VERSION@@" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 3 "2009-12-30" "@@RXVT_VERSION@@" "RXVT-UNICODE"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
the double \f(CW\*(C`/\*(C'\fR characters as comment start. Use \f(CW\*(C`\e057\e057\*(C'\fR instead,
which works regardless of wether xrdb is used to parse the resource file
or not.
+.IP "macosx-pastebin and macosx-pastebin-native" 4
+.IX Item "macosx-pastebin and macosx-pastebin-native"
+These two modules implement an extended clipboard for Mac \s-1OS\s0 X. They are
+used like this:
+.Sp
+.Vb 3
+\& URxvt.perl\-ext\-common: default,macosx\-clipboard
+\& URxvt.keysym.M\-c: perl:macosx\-clipboard:copy
+\& URxvt.keysym.M\-v: perl:macosx\-clipboard:paste
+.Ve
+.Sp
+The difference between them is that the native variant requires a
+perl from apple's devkit or so, and \f(CW\*(C`maxosx\-pastebin\*(C'\fR requires the
+\&\f(CW\*(C`Mac::Pasteboard\*(C'\fR module, works with other perls, has fewer bugs, is
+simpler etc. etc.
.IP "example-refresh-hooks" 4
.IX Item "example-refresh-hooks"
Displays a very simple digital clock in the upper right corner of the
overlays or changes.
.SH "API DOCUMENTATION"
.IX Header "API DOCUMENTATION"
-.Sh "General \s-1API\s0 Considerations"
+.SS "General \s-1API\s0 Considerations"
.IX Subsection "General API Considerations"
All objects (such as terminals, time watchers etc.) are typical
reference-to-hash objects. The hash can be used to store anything you
.IX Item "$octets"
Either binary data or \- more common \- a text string encoded in a
locale-specific way.
-.Sh "Extension Objects"
+.SS "Extension Objects"
.IX Subsection "Extension Objects"
Every perl extension is a perl class. A separate perl object is created
for each terminal, and each terminal has its own set of extenion objects,
\&\f(CW\*(C`urxvt::term\*(C'\fR class on this object.
.PP
It has the following methods and data members:
-.ie n .IP "$urxvt_term\fR = \f(CW$self\->{term}" 4
+.ie n .IP "$urxvt_term = $self\->{term}" 4
.el .IP "\f(CW$urxvt_term\fR = \f(CW$self\fR\->{term}" 4
.IX Item "$urxvt_term = $self->{term}"
Returns the \f(CW\*(C`urxvt::term\*(C'\fR object associated with this instance of the
extension. This member \fImust not\fR be changed in any way.
-.ie n .IP "$self\fR\->enable ($hook_name => \f(CW$cb\fR, [$hook_name => \f(CW$cb..])" 4
+.ie n .IP "$self\->enable ($hook_name => $cb, [$hook_name => $cb..])" 4
.el .IP "\f(CW$self\fR\->enable ($hook_name => \f(CW$cb\fR, [$hook_name => \f(CW$cb\fR..])" 4
.IX Item "$self->enable ($hook_name => $cb, [$hook_name => $cb..])"
Dynamically enable the given hooks (named without the \f(CW\*(C`on_\*(C'\fR prefix) for
this extension, replacing any previous hook. This is useful when you want
to overwrite time-critical hooks only temporarily.
-.ie n .IP "$self\fR\->disable ($hook_name[, \f(CW$hook_name..])" 4
+.ie n .IP "$self\->disable ($hook_name[, $hook_name..])" 4
.el .IP "\f(CW$self\fR\->disable ($hook_name[, \f(CW$hook_name\fR..])" 4
.IX Item "$self->disable ($hook_name[, $hook_name..])"
Dynamically disable the given hooks.
-.Sh "Hooks"
+.SS "Hooks"
.IX Subsection "Hooks"
The following subroutines can be declared in extension files, and will be
called whenever the relevant event happens.
Called after the screen is \*(L"reset\*(R" for any reason, such as resizing or
control sequences. Here is where you can react on changes to size-related
variables.
-.ie n .IP "on_child_start $term\fR, \f(CW$pid" 4
+.ie n .IP "on_child_start $term, $pid" 4
.el .IP "on_child_start \f(CW$term\fR, \f(CW$pid\fR" 4
.IX Item "on_child_start $term, $pid"
Called just after the child process has been \f(CW\*(C`fork\*(C'\fRed.
-.ie n .IP "on_child_exit $term\fR, \f(CW$status" 4
+.ie n .IP "on_child_exit $term, $status" 4
.el .IP "on_child_exit \f(CW$term\fR, \f(CW$status\fR" 4
.IX Item "on_child_exit $term, $status"
Called just after the child process has exited. \f(CW$status\fR is the status
from \f(CW\*(C`waitpid\*(C'\fR.
-.ie n .IP "on_sel_make $term\fR, \f(CW$eventtime" 4
+.ie n .IP "on_sel_make $term, $eventtime" 4
.el .IP "on_sel_make \f(CW$term\fR, \f(CW$eventtime\fR" 4
.IX Item "on_sel_make $term, $eventtime"
Called whenever a selection has been made by the user, but before the
.Sp
Returning a true value aborts selection making by urxvt, in which case you
have to make a selection yourself by calling \f(CW\*(C`$term\->selection_grab\*(C'\fR.
-.ie n .IP "on_sel_grab $term\fR, \f(CW$eventtime" 4
+.ie n .IP "on_sel_grab $term, $eventtime" 4
.el .IP "on_sel_grab \f(CW$term\fR, \f(CW$eventtime\fR" 4
.IX Item "on_sel_grab $term, $eventtime"
Called whenever a selection has been copied, but before the selection is
supposed to enlarge the selection more and more, if possible.
.Sp
See the \fIselection\fR example extension.
-.ie n .IP "on_view_change $term\fR, \f(CW$offset" 4
+.ie n .IP "on_view_change $term, $offset" 4
.el .IP "on_view_change \f(CW$term\fR, \f(CW$offset\fR" 4
.IX Item "on_view_change $term, $offset"
Called whenever the view offset changes, i.e. the user or program
scrolls. Offset \f(CW0\fR means display the normal terminal, positive values
show this many lines of scrollback.
-.ie n .IP "on_scroll_back $term\fR, \f(CW$lines\fR, \f(CW$saved" 4
+.ie n .IP "on_scroll_back $term, $lines, $saved" 4
.el .IP "on_scroll_back \f(CW$term\fR, \f(CW$lines\fR, \f(CW$saved\fR" 4
.IX Item "on_scroll_back $term, $lines, $saved"
Called whenever lines scroll out of the terminal area into the scrollback
It is called before lines are scrolled out (so rows 0 .. min ($lines \- 1,
\&\f(CW$nrow\fR \- 1) represent the lines to be scrolled out). \f(CW$saved\fR is the total
number of lines that will be in the scrollback buffer.
-.ie n .IP "on_osc_seq $term\fR, \f(CW$op\fR, \f(CW$args\fR, \f(CW$resp" 4
+.ie n .IP "on_osc_seq $term, $op, $args, $resp" 4
.el .IP "on_osc_seq \f(CW$term\fR, \f(CW$op\fR, \f(CW$args\fR, \f(CW$resp\fR" 4
.IX Item "on_osc_seq $term, $op, $args, $resp"
Called on every \s-1OSC\s0 sequence and can be used to suppress it or modify its
this callback.
.Sp
\&\f(CW\*(C`on_osc_seq_perl\*(C'\fR should be used for new behaviour.
-.ie n .IP "on_osc_seq_perl $term\fR, \f(CW$args\fR, \f(CW$resp" 4
+.ie n .IP "on_osc_seq_perl $term, $args, $resp" 4
.el .IP "on_osc_seq_perl \f(CW$term\fR, \f(CW$args\fR, \f(CW$resp\fR" 4
.IX Item "on_osc_seq_perl $term, $args, $resp"
Called whenever the \fB\s-1ESC\s0 ] 777 ; string \s-1ST\s0\fR command sequence (\s-1OSC\s0 =
.Sp
For responses, \f(CW$resp\fR contains the end-of-args separator used by the
sender.
-.ie n .IP "on_add_lines $term\fR, \f(CW$string" 4
+.ie n .IP "on_add_lines $term, $string" 4
.el .IP "on_add_lines \f(CW$term\fR, \f(CW$string\fR" 4
.IX Item "on_add_lines $term, $string"
Called whenever text is about to be output, with the text as argument. You
and calling \f(CW\*(C`$term\->scr_add_lines\*(C'\fR yourself. Please note that this
might be very slow, however, as your hook is called for \fBall\fR text being
output.
-.ie n .IP "on_tt_write $term\fR, \f(CW$octets" 4
+.ie n .IP "on_tt_write $term, $octets" 4
.el .IP "on_tt_write \f(CW$term\fR, \f(CW$octets\fR" 4
.IX Item "on_tt_write $term, $octets"
Called whenever some data is written to the tty/pty and can be used to
suppress or filter tty input.
-.ie n .IP "on_line_update $term\fR, \f(CW$row" 4
+.ie n .IP "on_line_update $term, $row" 4
.el .IP "on_line_update \f(CW$term\fR, \f(CW$row\fR" 4
.IX Item "on_line_update $term, $row"
Called whenever a line was updated or changed. Can be used to filter
.el .IP "on_refresh_end \f(CW$term\fR" 4
.IX Item "on_refresh_end $term"
Called just after the screen gets redrawn. See \f(CW\*(C`on_refresh_begin\*(C'\fR.
-.ie n .IP "on_user_command $term\fR, \f(CW$string" 4
+.ie n .IP "on_user_command $term, $string" 4
.el .IP "on_user_command \f(CW$term\fR, \f(CW$string\fR" 4
.IX Item "on_user_command $term, $string"
Called whenever a user-configured event is being activated (e.g. via
.Sp
The event is simply the action string. This interface is assumed to change
slightly in the future.
-.ie n .IP "on_resize_all_windows $tern\fR, \f(CW$new_width\fR, \f(CW$new_height" 4
+.ie n .IP "on_resize_all_windows $tern, $new_width, $new_height" 4
.el .IP "on_resize_all_windows \f(CW$tern\fR, \f(CW$new_width\fR, \f(CW$new_height\fR" 4
.IX Item "on_resize_all_windows $tern, $new_width, $new_height"
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 \s-1TRUE\s0, setting of the window hints is being skipped.
-.ie n .IP "on_x_event $term\fR, \f(CW$event" 4
+.ie n .IP "on_x_event $term, $event" 4
.el .IP "on_x_event \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_x_event $term, $event"
Called on every X event received on the vt window (and possibly other
windows). Should only be used as a last resort. Most event structure
members are not passed.
-.ie n .IP "on_root_event $term\fR, \f(CW$event" 4
+.ie n .IP "on_root_event $term, $event" 4
.el .IP "on_root_event \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_root_event $term, $event"
Like \f(CW\*(C`on_x_event\*(C'\fR, but is called for events on the root window.
.IX Item "on_focus_out $term"
Called whenever the window loses keyboard focus, before rxvt-unicode does
focus out processing.
-.ie n .IP "on_configure_notify $term\fR, \f(CW$event" 4
+.ie n .IP "on_configure_notify $term, $event" 4
.el .IP "on_configure_notify \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_configure_notify $term, $event"
.PD 0
-.ie n .IP "on_property_notify $term\fR, \f(CW$event" 4
+.ie n .IP "on_property_notify $term, $event" 4
.el .IP "on_property_notify \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_property_notify $term, $event"
-.ie n .IP "on_key_press $term\fR, \f(CW$event\fR, \f(CW$keysym\fR, \f(CW$octets" 4
+.ie n .IP "on_key_press $term, $event, $keysym, $octets" 4
.el .IP "on_key_press \f(CW$term\fR, \f(CW$event\fR, \f(CW$keysym\fR, \f(CW$octets\fR" 4
.IX Item "on_key_press $term, $event, $keysym, $octets"
-.ie n .IP "on_key_release $term\fR, \f(CW$event\fR, \f(CW$keysym" 4
+.ie n .IP "on_key_release $term, $event, $keysym" 4
.el .IP "on_key_release \f(CW$term\fR, \f(CW$event\fR, \f(CW$keysym\fR" 4
.IX Item "on_key_release $term, $event, $keysym"
-.ie n .IP "on_button_press $term\fR, \f(CW$event" 4
+.ie n .IP "on_button_press $term, $event" 4
.el .IP "on_button_press \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_button_press $term, $event"
-.ie n .IP "on_button_release $term\fR, \f(CW$event" 4
+.ie n .IP "on_button_release $term, $event" 4
.el .IP "on_button_release \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_button_release $term, $event"
-.ie n .IP "on_motion_notify $term\fR, \f(CW$event" 4
+.ie n .IP "on_motion_notify $term, $event" 4
.el .IP "on_motion_notify \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_motion_notify $term, $event"
-.ie n .IP "on_map_notify $term\fR, \f(CW$event" 4
+.ie n .IP "on_map_notify $term, $event" 4
.el .IP "on_map_notify \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_map_notify $term, $event"
-.ie n .IP "on_unmap_notify $term\fR, \f(CW$event" 4
+.ie n .IP "on_unmap_notify $term, $event" 4
.el .IP "on_unmap_notify \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_unmap_notify $term, $event"
.PD
output, if any, in locale-specific encoding.
.Sp
subwindow.
-.ie n .IP "on_client_message $term\fR, \f(CW$event" 4
+.ie n .IP "on_client_message $term, $event" 4
.el .IP "on_client_message \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_client_message $term, $event"
.PD 0
-.ie n .IP "on_wm_protocols $term\fR, \f(CW$event" 4
+.ie n .IP "on_wm_protocols $term, $event" 4
.el .IP "on_wm_protocols \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_wm_protocols $term, $event"
-.ie n .IP "on_wm_delete_window $term\fR, \f(CW$event" 4
+.ie n .IP "on_wm_delete_window $term, $event" 4
.el .IP "on_wm_delete_window \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_wm_delete_window $term, $event"
.PD
Called when various types of ClientMessage events are received (all with
format=32, \s-1WM_PROTOCOLS\s0 or \s-1WM_PROTOCOLS:WM_DELETE_WINDOW\s0).
-.ie n .Sh "Variables in the ""urxvt"" Package"
-.el .Sh "Variables in the \f(CWurxvt\fP Package"
+.ie n .SS "Variables in the ""urxvt"" Package"
+.el .SS "Variables in the \f(CWurxvt\fP Package"
.IX Subsection "Variables in the urxvt Package"
.ie n .IP "$urxvt::LIBDIR" 4
.el .IP "\f(CW$urxvt::LIBDIR\fR" 4
.IX Item "$urxvt::LIBDIR"
The rxvt-unicode library directory, where, among other things, the perl
modules and scripts are stored.
-.ie n .IP "$urxvt::RESCLASS\fR, \f(CW$urxvt::RESCLASS" 4
+.ie n .IP "$urxvt::RESCLASS, $urxvt::RESCLASS" 4
.el .IP "\f(CW$urxvt::RESCLASS\fR, \f(CW$urxvt::RESCLASS\fR" 4
.IX Item "$urxvt::RESCLASS, $urxvt::RESCLASS"
The resource class and name rxvt-unicode uses to look up X resources.
Works similar to \f(CW@TERM_INIT\fR, but contains perl package/class names, which
get registered as normal extensions after calling the hooks in \f(CW@TERM_INIT\fR
but before other extensions. Gets cleared just like \f(CW@TERM_INIT\fR.
-.ie n .Sh "Functions in the ""urxvt"" Package"
-.el .Sh "Functions in the \f(CWurxvt\fP Package"
+.ie n .SS "Functions in the ""urxvt"" Package"
+.el .SS "Functions in the \f(CWurxvt\fP Package"
.IX Subsection "Functions in the urxvt Package"
.ie n .IP "urxvt::fatal $errormessage" 4
.el .IP "urxvt::fatal \f(CW$errormessage\fR" 4
.IX Item "urxvt::KeyPress, KeyRelease, ButtonPress, ButtonRelease, MotionNotify, EnterNotify, LeaveNotify, FocusIn, FocusOut, KeymapNotify, Expose, GraphicsExpose, NoExpose, VisibilityNotify, CreateNotify, DestroyNotify, UnmapNotify, MapNotify, MapRequest, ReparentNotify, ConfigureNotify, ConfigureRequest, GravityNotify, ResizeRequest, CirculateNotify, CirculateRequest, PropertyNotify, SelectionClear, SelectionRequest, SelectionNotify, ColormapNotify, ClientMessage, MappingNotify"
.PD
Various constants for use in X calls and event processing.
-.Sh "\s-1RENDITION\s0"
+.SS "\s-1RENDITION\s0"
.IX Subsection "RENDITION"
Rendition bitsets contain information about colour, font, font styles and
similar information for each screen cell.
Return the bit that enabled bold, italic, blink, reverse-video and
underline, respectively. To enable such a style, just logically \s-1OR\s0 it into
the bitset.
-.ie n .IP "$foreground\fR = urxvt::GET_BASEFG \f(CW$rend" 4
+.ie n .IP "$foreground = urxvt::GET_BASEFG $rend" 4
.el .IP "\f(CW$foreground\fR = urxvt::GET_BASEFG \f(CW$rend\fR" 4
.IX Item "$foreground = urxvt::GET_BASEFG $rend"
.PD 0
-.ie n .IP "$background\fR = urxvt::GET_BASEBG \f(CW$rend" 4
+.ie n .IP "$background = urxvt::GET_BASEBG $rend" 4
.el .IP "\f(CW$background\fR = urxvt::GET_BASEBG \f(CW$rend\fR" 4
.IX Item "$background = urxvt::GET_BASEBG $rend"
.PD
Return the foreground/background colour index, respectively.
-.ie n .IP "$rend\fR = urxvt::SET_FGCOLOR \f(CW$rend\fR, \f(CW$new_colour" 4
+.ie n .IP "$rend = urxvt::SET_FGCOLOR $rend, $new_colour" 4
.el .IP "\f(CW$rend\fR = urxvt::SET_FGCOLOR \f(CW$rend\fR, \f(CW$new_colour\fR" 4
.IX Item "$rend = urxvt::SET_FGCOLOR $rend, $new_colour"
.PD 0
-.ie n .IP "$rend\fR = urxvt::SET_BGCOLOR \f(CW$rend\fR, \f(CW$new_colour" 4
+.ie n .IP "$rend = urxvt::SET_BGCOLOR $rend, $new_colour" 4
.el .IP "\f(CW$rend\fR = urxvt::SET_BGCOLOR \f(CW$rend\fR, \f(CW$new_colour\fR" 4
.IX Item "$rend = urxvt::SET_BGCOLOR $rend, $new_colour"
-.ie n .IP "$rend\fR = urxvt::SET_COLOR \f(CW$rend\fR, \f(CW$new_fg\fR, \f(CW$new_bg" 4
+.ie n .IP "$rend = urxvt::SET_COLOR $rend, $new_fg, $new_bg" 4
.el .IP "\f(CW$rend\fR = urxvt::SET_COLOR \f(CW$rend\fR, \f(CW$new_fg\fR, \f(CW$new_bg\fR" 4
.IX Item "$rend = urxvt::SET_COLOR $rend, $new_fg, $new_bg"
.PD
Replace the foreground/background colour in the rendition mask with the
specified one.
-.ie n .IP "$value\fR = urxvt::GET_CUSTOM \f(CW$rend" 4
+.ie n .IP "$value = urxvt::GET_CUSTOM $rend" 4
.el .IP "\f(CW$value\fR = urxvt::GET_CUSTOM \f(CW$rend\fR" 4
.IX Item "$value = urxvt::GET_CUSTOM $rend"
Return the \*(L"custom\*(R" value: Every rendition has 5 bits for use by
extensions. They can be set and changed as you like and are initially
zero.
-.ie n .IP "$rend\fR = urxvt::SET_CUSTOM \f(CW$rend\fR, \f(CW$new_value" 4
+.ie n .IP "$rend = urxvt::SET_CUSTOM $rend, $new_value" 4
.el .IP "\f(CW$rend\fR = urxvt::SET_CUSTOM \f(CW$rend\fR, \f(CW$new_value\fR" 4
.IX Item "$rend = urxvt::SET_CUSTOM $rend, $new_value"
Change the custom value.
-.ie n .Sh "The ""urxvt::anyevent"" Class"
-.el .Sh "The \f(CWurxvt::anyevent\fP Class"
+.ie n .SS "The ""urxvt::anyevent"" Class"
+.el .SS "The \f(CWurxvt::anyevent\fP Class"
.IX Subsection "The urxvt::anyevent Class"
The sole purpose of this class is to deliver an interface to the
\&\f(CW\*(C`AnyEvent\*(C'\fR module \- any module using it will work inside urxvt without
condition variables, but non-blocking condvar use is ok. What this means
is that you cannot use blocking APIs, but the non-blocking variant should
work.
-.ie n .Sh "The ""urxvt::term"" Class"
-.el .Sh "The \f(CWurxvt::term\fP Class"
+.ie n .SS "The ""urxvt::term"" Class"
+.el .SS "The \f(CWurxvt::term\fP Class"
.IX Subsection "The urxvt::term Class"
-.ie n .IP "$term\fR = new urxvt::term \f(CW$envhashref\fR, \f(CW$rxvtname, [arg...]" 4
+.ie n .IP "$term = new urxvt::term $envhashref, $rxvtname, [arg...]" 4
.el .IP "\f(CW$term\fR = new urxvt::term \f(CW$envhashref\fR, \f(CW$rxvtname\fR, [arg...]" 4
.IX Item "$term = new urxvt::term $envhashref, $rxvtname, [arg...]"
Creates a new terminal, very similar as if you had started it with system
Destroy the terminal object (close the window, free resources
etc.). Please note that @@RXVT_NAME@@ will not exit as long as any event
watchers (timers, io watchers) are still active.
-.ie n .IP "$term\fR\->exec_async ($cmd[, \f(CW@args])" 4
+.ie n .IP "$term\->exec_async ($cmd[, @args])" 4
.el .IP "\f(CW$term\fR\->exec_async ($cmd[, \f(CW@args\fR])" 4
.IX Item "$term->exec_async ($cmd[, @args])"
Works like the combination of the \f(CW\*(C`fork\*(C'\fR/\f(CW\*(C`exec\*(C'\fR builtins, which executes
be preferred over explicit calls to \f(CW\*(C`exec\*(C'\fR or \f(CW\*(C`system\*(C'\fR.
.Sp
Returns the pid of the subprocess or \f(CW\*(C`undef\*(C'\fR on error.
-.ie n .IP "$isset\fR = \f(CW$term\fR\->option ($optval[, \f(CW$set])" 4
+.ie n .IP "$isset = $term\->option ($optval[, $set])" 4
.el .IP "\f(CW$isset\fR = \f(CW$term\fR\->option ($optval[, \f(CW$set\fR])" 4
.IX Item "$isset = $term->option ($optval[, $set])"
Returns true if the option specified by \f(CW$optval\fR is enabled, and
\& scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs
\& transparent tripleclickwords utmpInhibit visualBell
.Ve
-.ie n .IP "$value\fR = \f(CW$term\fR\->resource ($name[, \f(CW$newval])" 4
+.ie n .IP "$value = $term\->resource ($name[, $newval])" 4
.el .IP "\f(CW$value\fR = \f(CW$term\fR\->resource ($name[, \f(CW$newval\fR])" 4
.IX Item "$value = $term->resource ($name[, $newval])"
Returns the current resource value associated with a given name and
\& borderLess chdir color cursorBlink cursorUnderline cutchars delete_key
\& display_name embed ext_bwidth fade font geometry hold iconName
\& imFont imLocale inputMethod insecure int_bwidth intensityStyles
-\& italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier
-\& mouseWheelScrollPage name override_redirect pastableTabs path perl_eval
-\& perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
+\& italicFont jumpScroll lineSpace letterSpace loginShell mapAlert meta8
+\& modifier mouseWheelScrollPage name override_redirect pastableTabs path
+\& perl_eval perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
\& preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
\& scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
\& scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
\& transient_for transparent transparent_all tripleclickwords utmpInhibit
\& visualBell
.Ve
-.ie n .IP "$value\fR = \f(CW$term\->x_resource ($pattern)" 4
+.ie n .IP "$value = $term\->x_resource ($pattern)" 4
.el .IP "\f(CW$value\fR = \f(CW$term\fR\->x_resource ($pattern)" 4
.IX Item "$value = $term->x_resource ($pattern)"
Returns the X\-Resource for the given pattern, excluding the program or
This method should only be called during the \f(CW\*(C`on_start\*(C'\fR hook, as there is
only one resource database per display, and later invocations might return
the wrong resources.
-.ie n .IP "$success\fR = \f(CW$term\fR\->parse_keysym ($keysym_spec, \f(CW$command_string)" 4
+.ie n .IP "$success = $term\->parse_keysym ($keysym_spec, $command_string)" 4
.el .IP "\f(CW$success\fR = \f(CW$term\fR\->parse_keysym ($keysym_spec, \f(CW$command_string\fR)" 4
.IX Item "$success = $term->parse_keysym ($keysym_spec, $command_string)"
Adds a keymap translation exactly as specified via a resource. See the
\&\f(CW\*(C`keysym\*(C'\fR resource in the @@RXVT_NAME@@(1) manpage.
-.ie n .IP "$rend\fR = \f(CW$term\->rstyle ([$new_rstyle])" 4
+.ie n .IP "$rend = $term\->rstyle ([$new_rstyle])" 4
.el .IP "\f(CW$rend\fR = \f(CW$term\fR\->rstyle ([$new_rstyle])" 4
.IX Item "$rend = $term->rstyle ([$new_rstyle])"
Return and optionally change the current rendition. Text that is output by
the terminal application will use this style.
-.ie n .IP "($row, $col\fR) = \f(CW$term\fR\->screen_cur ([$row, \f(CW$col])" 4
+.ie n .IP "($row, $col) = $term\->screen_cur ([$row, $col])" 4
.el .IP "($row, \f(CW$col\fR) = \f(CW$term\fR\->screen_cur ([$row, \f(CW$col\fR])" 4
.IX Item "($row, $col) = $term->screen_cur ([$row, $col])"
Return the current coordinates of the text cursor position and optionally
set it (which is usually bad as applications don't expect that).
-.ie n .IP "($row, $col\fR) = \f(CW$term\fR\->selection_mark ([$row, \f(CW$col])" 4
+.ie n .IP "($row, $col) = $term\->selection_mark ([$row, $col])" 4
.el .IP "($row, \f(CW$col\fR) = \f(CW$term\fR\->selection_mark ([$row, \f(CW$col\fR])" 4
.IX Item "($row, $col) = $term->selection_mark ([$row, $col])"
.PD 0
-.ie n .IP "($row, $col\fR) = \f(CW$term\fR\->selection_beg ([$row, \f(CW$col])" 4
+.ie n .IP "($row, $col) = $term\->selection_beg ([$row, $col])" 4
.el .IP "($row, \f(CW$col\fR) = \f(CW$term\fR\->selection_beg ([$row, \f(CW$col\fR])" 4
.IX Item "($row, $col) = $term->selection_beg ([$row, $col])"
-.ie n .IP "($row, $col\fR) = \f(CW$term\fR\->selection_end ([$row, \f(CW$col])" 4
+.ie n .IP "($row, $col) = $term\->selection_end ([$row, $col])" 4
.el .IP "($row, \f(CW$col\fR) = \f(CW$term\fR\->selection_end ([$row, \f(CW$col\fR])" 4
.IX Item "($row, $col) = $term->selection_end ([$row, $col])"
.PD
-Return the current values of the selection mark, begin or end positions,
-and optionally set them to new values.
-.ie n .IP "$term\fR\->selection_make ($eventtime[, \f(CW$rectangular])" 4
+Return the current values of the selection mark, begin or end positions.
+.Sp
+When arguments are given, then the selection coordinates are set to
+\&\f(CW$row\fR and \f(CW$col\fR, and the selection screen is set to the current
+screen.
+.ie n .IP "$screen = $term\->selection_screen ([$screen])" 4
+.el .IP "\f(CW$screen\fR = \f(CW$term\fR\->selection_screen ([$screen])" 4
+.IX Item "$screen = $term->selection_screen ([$screen])"
+Returns the current selection screen, and then optionally sets it.
+.ie n .IP "$term\->selection_make ($eventtime[, $rectangular])" 4
.el .IP "\f(CW$term\fR\->selection_make ($eventtime[, \f(CW$rectangular\fR])" 4
.IX Item "$term->selection_make ($eventtime[, $rectangular])"
Tries to make a selection as set by \f(CW\*(C`selection_beg\*(C'\fR and
\&\f(CW\*(C`selection_end\*(C'\fR. If \f(CW$rectangular\fR is true (default: false), a
rectangular selection will be made. This is the prefered function to make
a selection.
-.ie n .IP "$success\fR = \f(CW$term\->selection_grab ($eventtime)" 4
+.ie n .IP "$success = $term\->selection_grab ($eventtime)" 4
.el .IP "\f(CW$success\fR = \f(CW$term\fR\->selection_grab ($eventtime)" 4
.IX Item "$success = $term->selection_grab ($eventtime)"
Try to request the primary selection text from the server (for example, as
set by the next method). No visual feedback will be given. This function
is mostly useful from within \f(CW\*(C`on_sel_grab\*(C'\fR hooks.
-.ie n .IP "$oldtext\fR = \f(CW$term\->selection ([$newtext])" 4
+.ie n .IP "$oldtext = $term\->selection ([$newtext])" 4
.el .IP "\f(CW$oldtext\fR = \f(CW$term\fR\->selection ([$newtext])" 4
.IX Item "$oldtext = $term->selection ([$newtext])"
Return the current selection text and optionally replace it by \f(CW$newtext\fR.
-.ie n .IP "$term\fR\->overlay_simple ($x, \f(CW$y\fR, \f(CW$text)" 4
+.ie n .IP "$term\->overlay_simple ($x, $y, $text)" 4
.el .IP "\f(CW$term\fR\->overlay_simple ($x, \f(CW$y\fR, \f(CW$text\fR)" 4
.IX Item "$term->overlay_simple ($x, $y, $text)"
Create a simple multi-line overlay box. See the next method for details.
-.ie n .IP "$term\fR\->overlay ($x, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR[, \f(CW$rstyle\fR[, \f(CW$border]])" 4
+.ie n .IP "$term\->overlay ($x, $y, $width, $height[, $rstyle[, $border]])" 4
.el .IP "\f(CW$term\fR\->overlay ($x, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR[, \f(CW$rstyle\fR[, \f(CW$border\fR]])" 4
.IX Item "$term->overlay ($x, $y, $width, $height[, $rstyle[, $border]])"
Create a new (empty) overlay at the given position with the given
.Sp
The methods currently supported on \f(CW\*(C`urxvt::overlay\*(C'\fR objects are:
.RS 4
-.ie n .IP "$overlay\fR\->set ($x, \f(CW$y\fR, \f(CW$text\fR[, \f(CW$rend])" 4
+.ie n .IP "$overlay\->set ($x, $y, $text[, $rend])" 4
.el .IP "\f(CW$overlay\fR\->set ($x, \f(CW$y\fR, \f(CW$text\fR[, \f(CW$rend\fR])" 4
.IX Item "$overlay->set ($x, $y, $text[, $rend])"
Similar to \f(CW\*(C`$term\->ROW_t\*(C'\fR and \f(CW\*(C`$term\->ROW_r\*(C'\fR in that it puts
.RE
.RS 4
.RE
-.ie n .IP "$popup\fR = \f(CW$term\->popup ($event)" 4
+.ie n .IP "$popup = $term\->popup ($event)" 4
.el .IP "\f(CW$popup\fR = \f(CW$term\fR\->popup ($event)" 4
.IX Item "$popup = $term->popup ($event)"
Creates a new \f(CW\*(C`urxvt::popup\*(C'\fR object that implements a popup menu. The
\&\f(CW$event\fR \fImust\fR be the event causing the menu to pop up (a button event,
currently).
-.ie n .IP "$cellwidth\fR = \f(CW$term\->strwidth ($string)" 4
+.ie n .IP "$cellwidth = $term\->strwidth ($string)" 4
.el .IP "\f(CW$cellwidth\fR = \f(CW$term\fR\->strwidth ($string)" 4
.IX Item "$cellwidth = $term->strwidth ($string)"
Returns the number of screen-cells this string would need. Correctly
accounts for wide and combining characters.
-.ie n .IP "$octets\fR = \f(CW$term\->locale_encode ($string)" 4
+.ie n .IP "$octets = $term\->locale_encode ($string)" 4
.el .IP "\f(CW$octets\fR = \f(CW$term\fR\->locale_encode ($string)" 4
.IX Item "$octets = $term->locale_encode ($string)"
Convert the given text string into the corresponding locale encoding.
-.ie n .IP "$string\fR = \f(CW$term\->locale_decode ($octets)" 4
+.ie n .IP "$string = $term\->locale_decode ($octets)" 4
.el .IP "\f(CW$string\fR = \f(CW$term\fR\->locale_decode ($octets)" 4
.IX Item "$string = $term->locale_decode ($octets)"
Convert the given locale-encoded octets into a perl string.
-.ie n .IP "$term\fR\->scr_xor_span ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle])" 4
+.ie n .IP "$term\->scr_xor_span ($beg_row, $beg_col, $end_row, $end_col[, $rstyle])" 4
.el .IP "\f(CW$term\fR\->scr_xor_span ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle\fR])" 4
.IX Item "$term->scr_xor_span ($beg_row, $beg_col, $end_row, $end_col[, $rstyle])"
XORs the rendition values in the given span with the provided value
(default: \f(CW\*(C`RS_RVid\*(C'\fR), which \fI\s-1MUST\s0 \s-1NOT\s0\fR contain font styles. Useful in
refresh hooks to provide effects similar to the selection.
-.ie n .IP "$term\fR\->scr_xor_rect ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle1\fR[, \f(CW$rstyle2]])" 4
+.ie n .IP "$term\->scr_xor_rect ($beg_row, $beg_col, $end_row, $end_col[, $rstyle1[, $rstyle2]])" 4
.el .IP "\f(CW$term\fR\->scr_xor_rect ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle1\fR[, \f(CW$rstyle2\fR]])" 4
.IX Item "$term->scr_xor_rect ($beg_row, $beg_col, $end_row, $end_col[, $rstyle1[, $rstyle2]])"
Similar to \f(CW\*(C`scr_xor_span\*(C'\fR, but xors a rectangle instead. Trailing
Write the octets given in \f(CW$data\fR to the tty (i.e. as program input). To
pass characters instead of octets, you should convert your strings first
to the locale-specific encoding using \f(CW\*(C`$term\->locale_encode\*(C'\fR.
-.ie n .IP "$old_events\fR = \f(CW$term\->pty_ev_events ([$new_events])" 4
+.ie n .IP "$old_events = $term\->pty_ev_events ([$new_events])" 4
.el .IP "\f(CW$old_events\fR = \f(CW$term\fR\->pty_ev_events ([$new_events])" 4
.IX Item "$old_events = $term->pty_ev_events ([$new_events])"
Replaces the event mask of the pty watcher by the given event mask. Can
be used to suppress input and output handling to the pty/tty. See the
description of \f(CW\*(C`urxvt::timer\->events\*(C'\fR. Make sure to always restore
the previous value.
-.ie n .IP "$fd\fR = \f(CW$term\->pty_fd" 4
+.ie n .IP "$fd = $term\->pty_fd" 4
.el .IP "\f(CW$fd\fR = \f(CW$term\fR\->pty_fd" 4
.IX Item "$fd = $term->pty_fd"
Returns the master file descriptor for the pty in use, or \f(CW\*(C`\-1\*(C'\fR if no pty
is used.
-.ie n .IP "$windowid\fR = \f(CW$term\->parent" 4
+.ie n .IP "$windowid = $term\->parent" 4
.el .IP "\f(CW$windowid\fR = \f(CW$term\fR\->parent" 4
.IX Item "$windowid = $term->parent"
Return the window id of the toplevel window.
-.ie n .IP "$windowid\fR = \f(CW$term\->vt" 4
+.ie n .IP "$windowid = $term\->vt" 4
.el .IP "\f(CW$windowid\fR = \f(CW$term\fR\->vt" 4
.IX Item "$windowid = $term->vt"
Return the window id of the terminal window.
.ie n .IP "$term\->focus_out" 4
.el .IP "\f(CW$term\fR\->focus_out" 4
.IX Item "$term->focus_out"
-.ie n .IP "$term\fR\->key_press ($state, \f(CW$keycode\fR[, \f(CW$time])" 4
+.ie n .IP "$term\->key_press ($state, $keycode[, $time])" 4
.el .IP "\f(CW$term\fR\->key_press ($state, \f(CW$keycode\fR[, \f(CW$time\fR])" 4
.IX Item "$term->key_press ($state, $keycode[, $time])"
-.ie n .IP "$term\fR\->key_release ($state, \f(CW$keycode\fR[, \f(CW$time])" 4
+.ie n .IP "$term\->key_release ($state, $keycode[, $time])" 4
.el .IP "\f(CW$term\fR\->key_release ($state, \f(CW$keycode\fR[, \f(CW$time\fR])" 4
.IX Item "$term->key_release ($state, $keycode[, $time])"
.PD
Deliver various fake events to to terminal.
-.ie n .IP "$window_width\fR = \f(CW$term\->width" 4
+.ie n .IP "$window_width = $term\->width" 4
.el .IP "\f(CW$window_width\fR = \f(CW$term\fR\->width" 4
.IX Item "$window_width = $term->width"
.PD 0
-.ie n .IP "$window_height\fR = \f(CW$term\->height" 4
+.ie n .IP "$window_height = $term\->height" 4
.el .IP "\f(CW$window_height\fR = \f(CW$term\fR\->height" 4
.IX Item "$window_height = $term->height"
-.ie n .IP "$font_width\fR = \f(CW$term\->fwidth" 4
+.ie n .IP "$font_width = $term\->fwidth" 4
.el .IP "\f(CW$font_width\fR = \f(CW$term\fR\->fwidth" 4
.IX Item "$font_width = $term->fwidth"
-.ie n .IP "$font_height\fR = \f(CW$term\->fheight" 4
+.ie n .IP "$font_height = $term\->fheight" 4
.el .IP "\f(CW$font_height\fR = \f(CW$term\fR\->fheight" 4
.IX Item "$font_height = $term->fheight"
-.ie n .IP "$font_ascent\fR = \f(CW$term\->fbase" 4
+.ie n .IP "$font_ascent = $term\->fbase" 4
.el .IP "\f(CW$font_ascent\fR = \f(CW$term\fR\->fbase" 4
.IX Item "$font_ascent = $term->fbase"
-.ie n .IP "$terminal_rows\fR = \f(CW$term\->nrow" 4
+.ie n .IP "$terminal_rows = $term\->nrow" 4
.el .IP "\f(CW$terminal_rows\fR = \f(CW$term\fR\->nrow" 4
.IX Item "$terminal_rows = $term->nrow"
-.ie n .IP "$terminal_columns\fR = \f(CW$term\->ncol" 4
+.ie n .IP "$terminal_columns = $term\->ncol" 4
.el .IP "\f(CW$terminal_columns\fR = \f(CW$term\fR\->ncol" 4
.IX Item "$terminal_columns = $term->ncol"
-.ie n .IP "$has_focus\fR = \f(CW$term\->focus" 4
+.ie n .IP "$has_focus = $term\->focus" 4
.el .IP "\f(CW$has_focus\fR = \f(CW$term\fR\->focus" 4
.IX Item "$has_focus = $term->focus"
-.ie n .IP "$is_mapped\fR = \f(CW$term\->mapped" 4
+.ie n .IP "$is_mapped = $term\->mapped" 4
.el .IP "\f(CW$is_mapped\fR = \f(CW$term\fR\->mapped" 4
.IX Item "$is_mapped = $term->mapped"
-.ie n .IP "$max_scrollback\fR = \f(CW$term\->saveLines" 4
+.ie n .IP "$max_scrollback = $term\->saveLines" 4
.el .IP "\f(CW$max_scrollback\fR = \f(CW$term\fR\->saveLines" 4
.IX Item "$max_scrollback = $term->saveLines"
-.ie n .IP "$nrow_plus_saveLines\fR = \f(CW$term\->total_rows" 4
+.ie n .IP "$nrow_plus_saveLines = $term\->total_rows" 4
.el .IP "\f(CW$nrow_plus_saveLines\fR = \f(CW$term\fR\->total_rows" 4
.IX Item "$nrow_plus_saveLines = $term->total_rows"
-.ie n .IP "$topmost_scrollback_row\fR = \f(CW$term\->top_row" 4
+.ie n .IP "$topmost_scrollback_row = $term\->top_row" 4
.el .IP "\f(CW$topmost_scrollback_row\fR = \f(CW$term\fR\->top_row" 4
.IX Item "$topmost_scrollback_row = $term->top_row"
.PD
Return various integers describing terminal characteristics.
-.ie n .IP "$x_display\fR = \f(CW$term\->display_id" 4
+.ie n .IP "$x_display = $term\->display_id" 4
.el .IP "\f(CW$x_display\fR = \f(CW$term\fR\->display_id" 4
.IX Item "$x_display = $term->display_id"
Return the \s-1DISPLAY\s0 used by rxvt-unicode.
-.ie n .IP "$lc_ctype\fR = \f(CW$term\->locale" 4
+.ie n .IP "$lc_ctype = $term\->locale" 4
.el .IP "\f(CW$lc_ctype\fR = \f(CW$term\fR\->locale" 4
.IX Item "$lc_ctype = $term->locale"
Returns the \s-1LC_CTYPE\s0 category string used by this rxvt-unicode.
-.ie n .IP "$env\fR = \f(CW$term\->env" 4
+.ie n .IP "$env = $term\->env" 4
.el .IP "\f(CW$env\fR = \f(CW$term\fR\->env" 4
.IX Item "$env = $term->env"
Returns a copy of the environment in effect for the terminal as a hashref
similar to \f(CW\*(C`\e%ENV\*(C'\fR.
-.ie n .IP "@envv\fR = \f(CW$term\->envv" 4
+.ie n .IP "@envv = $term\->envv" 4
.el .IP "\f(CW@envv\fR = \f(CW$term\fR\->envv" 4
.IX Item "@envv = $term->envv"
Returns the environment as array of strings of the form \f(CW\*(C`VAR=VALUE\*(C'\fR.
-.ie n .IP "@argv\fR = \f(CW$term\->argv" 4
+.ie n .IP "@argv = $term\->argv" 4
.el .IP "\f(CW@argv\fR = \f(CW$term\fR\->argv" 4
.IX Item "@argv = $term->argv"
Return the argument vector as this terminal, similar to \f(CW@ARGV\fR, but
includes the program name as first element.
-.ie n .IP "$modifiermask\fR = \f(CW$term\->ModLevel3Mask" 4
+.ie n .IP "$modifiermask = $term\->ModLevel3Mask" 4
.el .IP "\f(CW$modifiermask\fR = \f(CW$term\fR\->ModLevel3Mask" 4
.IX Item "$modifiermask = $term->ModLevel3Mask"
.PD 0
-.ie n .IP "$modifiermask\fR = \f(CW$term\->ModMetaMask" 4
+.ie n .IP "$modifiermask = $term\->ModMetaMask" 4
.el .IP "\f(CW$modifiermask\fR = \f(CW$term\fR\->ModMetaMask" 4
.IX Item "$modifiermask = $term->ModMetaMask"
-.ie n .IP "$modifiermask\fR = \f(CW$term\->ModNumLockMask" 4
+.ie n .IP "$modifiermask = $term\->ModNumLockMask" 4
.el .IP "\f(CW$modifiermask\fR = \f(CW$term\fR\->ModNumLockMask" 4
.IX Item "$modifiermask = $term->ModNumLockMask"
.PD
Return the modifier masks corresponding to the \*(L"\s-1ISO\s0 Level 3 Shift\*(R" (often
AltGr), the meta key (often Alt) and the num lock key, if applicable.
-.ie n .IP "$screen\fR = \f(CW$term\->current_screen" 4
+.ie n .IP "$screen = $term\->current_screen" 4
.el .IP "\f(CW$screen\fR = \f(CW$term\fR\->current_screen" 4
.IX Item "$screen = $term->current_screen"
Returns the currently displayed screen (0 primary, 1 secondary).
-.ie n .IP "$cursor_is_hidden\fR = \f(CW$term\->hidden_cursor" 4
+.ie n .IP "$cursor_is_hidden = $term\->hidden_cursor" 4
.el .IP "\f(CW$cursor_is_hidden\fR = \f(CW$term\fR\->hidden_cursor" 4
.IX Item "$cursor_is_hidden = $term->hidden_cursor"
Returns whether the cursor is currently hidden or not.
-.ie n .IP "$view_start\fR = \f(CW$term\->view_start ([$newvalue])" 4
+.ie n .IP "$view_start = $term\->view_start ([$newvalue])" 4
.el .IP "\f(CW$view_start\fR = \f(CW$term\fR\->view_start ([$newvalue])" 4
.IX Item "$view_start = $term->view_start ([$newvalue])"
Returns the row number of the topmost displayed line. Maximum value is
differ, it redraws the differences.
.Sp
Used after changing terminal contents to display them.
-.ie n .IP "$text\fR = \f(CW$term\fR\->ROW_t ($row_number[, \f(CW$new_text\fR[, \f(CW$start_col]])" 4
+.ie n .IP "$text = $term\->ROW_t ($row_number[, $new_text[, $start_col]])" 4
.el .IP "\f(CW$text\fR = \f(CW$term\fR\->ROW_t ($row_number[, \f(CW$new_text\fR[, \f(CW$start_col\fR]])" 4
.IX Item "$text = $term->ROW_t ($row_number[, $new_text[, $start_col]])"
Returns the text of the entire row with number \f(CW$row_number\fR. Row \f(CW\*(C`$term\->top_row\*(C'\fR
.Sp
The methods \f(CW\*(C`$term\->special_encode\*(C'\fR and \f(CW\*(C`$term\->special_decode\*(C'\fR
can be used to convert normal strings into this encoding and vice versa.
-.ie n .IP "$rend\fR = \f(CW$term\fR\->ROW_r ($row_number[, \f(CW$new_rend\fR[, \f(CW$start_col]])" 4
+.ie n .IP "$rend = $term\->ROW_r ($row_number[, $new_rend[, $start_col]])" 4
.el .IP "\f(CW$rend\fR = \f(CW$term\fR\->ROW_r ($row_number[, \f(CW$new_rend\fR[, \f(CW$start_col\fR]])" 4
.IX Item "$rend = $term->ROW_r ($row_number[, $new_rend[, $start_col]])"
Like \f(CW\*(C`$term\->ROW_t\*(C'\fR, but returns an arrayref with rendition
When setting rendition, the font mask will be ignored.
.Sp
See the section on \s-1RENDITION\s0, above.
-.ie n .IP "$length\fR = \f(CW$term\fR\->ROW_l ($row_number[, \f(CW$new_length])" 4
+.ie n .IP "$length = $term\->ROW_l ($row_number[, $new_length])" 4
.el .IP "\f(CW$length\fR = \f(CW$term\fR\->ROW_l ($row_number[, \f(CW$new_length\fR])" 4
.IX Item "$length = $term->ROW_l ($row_number[, $new_length])"
Returns the number of screen cells that are in use (\*(L"the line
length\*(R"). Unlike the urxvt core, this returns \f(CW\*(C`$term\->ncol\*(C'\fR if the
line is joined with the following one.
-.ie n .IP "$bool\fR = \f(CW$term\->is_longer ($row_number)" 4
+.ie n .IP "$bool = $term\->is_longer ($row_number)" 4
.el .IP "\f(CW$bool\fR = \f(CW$term\fR\->is_longer ($row_number)" 4
.IX Item "$bool = $term->is_longer ($row_number)"
Returns true if the row is part of a multiple-row logical \*(L"line\*(R" (i.e.
joined with the following row), which means all characters are in use
and it is continued on the next row (and possibly a continuation of the
previous row(s)).
-.ie n .IP "$line\fR = \f(CW$term\->line ($row_number)" 4
+.ie n .IP "$line = $term\->line ($row_number)" 4
.el .IP "\f(CW$line\fR = \f(CW$term\fR\->line ($row_number)" 4
.IX Item "$line = $term->line ($row_number)"
Create and return a new \f(CW\*(C`urxvt::line\*(C'\fR object that stores information
about the logical line that row \f(CW$row_number\fR is part of. It supports the
following methods:
.RS 4
-.ie n .IP "$text\fR = \f(CW$line\->t ([$new_text])" 4
+.ie n .IP "$text = $line\->t ([$new_text])" 4
.el .IP "\f(CW$text\fR = \f(CW$line\fR\->t ([$new_text])" 4
.IX Item "$text = $line->t ([$new_text])"
Returns or replaces the full text of the line, similar to \f(CW\*(C`ROW_t\*(C'\fR
-.ie n .IP "$rend\fR = \f(CW$line\->r ([$new_rend])" 4
+.ie n .IP "$rend = $line\->r ([$new_rend])" 4
.el .IP "\f(CW$rend\fR = \f(CW$line\fR\->r ([$new_rend])" 4
.IX Item "$rend = $line->r ([$new_rend])"
Returns or replaces the full rendition array of the line, similar to \f(CW\*(C`ROW_r\*(C'\fR
-.ie n .IP "$length\fR = \f(CW$line\->l" 4
+.ie n .IP "$length = $line\->l" 4
.el .IP "\f(CW$length\fR = \f(CW$line\fR\->l" 4
.IX Item "$length = $line->l"
Returns the length of the line in cells, similar to \f(CW\*(C`ROW_l\*(C'\fR.
-.ie n .IP "$rownum\fR = \f(CW$line\->beg" 4
+.ie n .IP "$rownum = $line\->beg" 4
.el .IP "\f(CW$rownum\fR = \f(CW$line\fR\->beg" 4
.IX Item "$rownum = $line->beg"
.PD 0
-.ie n .IP "$rownum\fR = \f(CW$line\->end" 4
+.ie n .IP "$rownum = $line\->end" 4
.el .IP "\f(CW$rownum\fR = \f(CW$line\fR\->end" 4
.IX Item "$rownum = $line->end"
.PD
Return the row number of the first/last row of the line, respectively.
-.ie n .IP "$offset\fR = \f(CW$line\fR\->offset_of ($row, \f(CW$col)" 4
+.ie n .IP "$offset = $line\->offset_of ($row, $col)" 4
.el .IP "\f(CW$offset\fR = \f(CW$line\fR\->offset_of ($row, \f(CW$col\fR)" 4
.IX Item "$offset = $line->offset_of ($row, $col)"
Returns the character offset of the given row|col pair within the logical
line. Works for rows outside the line, too, and returns corresponding
offsets outside the string.
-.ie n .IP "($row, $col\fR) = \f(CW$line\->coord_of ($offset)" 4
+.ie n .IP "($row, $col) = $line\->coord_of ($offset)" 4
.el .IP "($row, \f(CW$col\fR) = \f(CW$line\fR\->coord_of ($offset)" 4
.IX Item "($row, $col) = $line->coord_of ($offset)"
Translates a string offset into terminal coordinates again.
.RE
.RS 4
.RE
-.ie n .IP "$text\fR = \f(CW$term\fR\->special_encode \f(CW$string" 4
+.ie n .IP "$text = $term\->special_encode $string" 4
.el .IP "\f(CW$text\fR = \f(CW$term\fR\->special_encode \f(CW$string\fR" 4
.IX Item "$text = $term->special_encode $string"
Converts a perl string into the special encoding used by rxvt-unicode,
where one character corresponds to one screen cell. See
\&\f(CW\*(C`$term\->ROW_t\*(C'\fR for details.
-.ie n .IP "$string\fR = \f(CW$term\fR\->special_decode \f(CW$text" 4
+.ie n .IP "$string = $term\->special_decode $text" 4
.el .IP "\f(CW$string\fR = \f(CW$term\fR\->special_decode \f(CW$text\fR" 4
.IX Item "$string = $term->special_decode $text"
Converts rxvt-unicodes text representation into a perl string. See
\&\f(CW\*(C`$term\->ROW_t\*(C'\fR for details.
-.ie n .IP "$success\fR = \f(CW$term\fR\->grab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\->vt])" 4
+.ie n .IP "$success = $term\->grab_button ($button, $modifiermask[, $window = $term\->vt])" 4
.el .IP "\f(CW$success\fR = \f(CW$term\fR\->grab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\fR\->vt])" 4
.IX Item "$success = $term->grab_button ($button, $modifiermask[, $window = $term->vt])"
.PD 0
-.ie n .IP "$term\fR\->ungrab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\->vt])" 4
+.ie n .IP "$term\->ungrab_button ($button, $modifiermask[, $window = $term\->vt])" 4
.el .IP "\f(CW$term\fR\->ungrab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\fR\->vt])" 4
.IX Item "$term->ungrab_button ($button, $modifiermask[, $window = $term->vt])"
.PD
Register/unregister a synchronous button grab. See the XGrabButton
manpage.
-.ie n .IP "$success\fR = \f(CW$term\fR\->grab ($eventtime[, \f(CW$sync])" 4
+.ie n .IP "$success = $term\->grab ($eventtime[, $sync])" 4
.el .IP "\f(CW$success\fR = \f(CW$term\fR\->grab ($eventtime[, \f(CW$sync\fR])" 4
.IX Item "$success = $term->grab ($eventtime[, $sync])"
Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
Calls XUngrab for the most recent grab. Is called automatically on
evaluation errors, as it is better to lose the grab in the error case as
the session.
-.ie n .IP "$atom\fR = \f(CW$term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists])" 4
+.ie n .IP "$atom = $term\->XInternAtom ($atom_name[, $only_if_exists])" 4
.el .IP "\f(CW$atom\fR = \f(CW$term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists\fR])" 4
.IX Item "$atom = $term->XInternAtom ($atom_name[, $only_if_exists])"
.PD 0
-.ie n .IP "$atom_name\fR = \f(CW$term\->XGetAtomName ($atom)" 4
+.ie n .IP "$atom_name = $term\->XGetAtomName ($atom)" 4
.el .IP "\f(CW$atom_name\fR = \f(CW$term\fR\->XGetAtomName ($atom)" 4
.IX Item "$atom_name = $term->XGetAtomName ($atom)"
-.ie n .IP "@atoms\fR = \f(CW$term\->XListProperties ($window)" 4
+.ie n .IP "@atoms = $term\->XListProperties ($window)" 4
.el .IP "\f(CW@atoms\fR = \f(CW$term\fR\->XListProperties ($window)" 4
.IX Item "@atoms = $term->XListProperties ($window)"
-.ie n .IP "($type,$format,$octets) = $term\fR\->XGetWindowProperty ($window, \f(CW$property)" 4
+.ie n .IP "($type,$format,$octets) = $term\->XGetWindowProperty ($window, $property)" 4
.el .IP "($type,$format,$octets) = \f(CW$term\fR\->XGetWindowProperty ($window, \f(CW$property\fR)" 4
.IX Item "($type,$format,$octets) = $term->XGetWindowProperty ($window, $property)"
-.ie n .IP "$term\fR\->XChangeProperty ($window, \f(CW$property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets)" 4
+.ie n .IP "$term\->XChangeProperty ($window, $property, $type, $format, $octets)" 4
.el .IP "\f(CW$term\fR\->XChangeProperty ($window, \f(CW$property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets\fR)" 4
.IX Item "$term->XChangeProperty ($window, $property, $type, $format, $octets)"
-.ie n .IP "$term\fR\->XDeleteProperty ($window, \f(CW$property)" 4
+.ie n .IP "$term\->XDeleteProperty ($window, $property)" 4
.el .IP "\f(CW$term\fR\->XDeleteProperty ($window, \f(CW$property\fR)" 4
.IX Item "$term->XDeleteProperty ($window, $property)"
-.ie n .IP "$window\fR = \f(CW$term\->DefaultRootWindow" 4
+.ie n .IP "$window = $term\->DefaultRootWindow" 4
.el .IP "\f(CW$window\fR = \f(CW$term\fR\->DefaultRootWindow" 4
.IX Item "$window = $term->DefaultRootWindow"
-.ie n .IP "$term\fR\->XReparentWindow ($window, \f(CW$parent\fR, [$x, \f(CW$y])" 4
+.ie n .IP "$term\->XReparentWindow ($window, $parent, [$x, $y])" 4
.el .IP "\f(CW$term\fR\->XReparentWindow ($window, \f(CW$parent\fR, [$x, \f(CW$y\fR])" 4
.IX Item "$term->XReparentWindow ($window, $parent, [$x, $y])"
.ie n .IP "$term\->XMapWindow ($window)" 4
.ie n .IP "$term\->XUnmapWindow ($window)" 4
.el .IP "\f(CW$term\fR\->XUnmapWindow ($window)" 4
.IX Item "$term->XUnmapWindow ($window)"
-.ie n .IP "$term\fR\->XMoveResizeWindow ($window, \f(CW$x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height)" 4
+.ie n .IP "$term\->XMoveResizeWindow ($window, $x, $y, $width, $height)" 4
.el .IP "\f(CW$term\fR\->XMoveResizeWindow ($window, \f(CW$x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR)" 4
.IX Item "$term->XMoveResizeWindow ($window, $x, $y, $width, $height)"
-.ie n .IP "($x, $y\fR, \f(CW$child_window\fR) = \f(CW$term\fR\->XTranslateCoordinates ($src, \f(CW$dst\fR, \f(CW$x\fR, \f(CW$y)" 4
+.ie n .IP "($x, $y, $child_window) = $term\->XTranslateCoordinates ($src, $dst, $x, $y)" 4
.el .IP "($x, \f(CW$y\fR, \f(CW$child_window\fR) = \f(CW$term\fR\->XTranslateCoordinates ($src, \f(CW$dst\fR, \f(CW$x\fR, \f(CW$y\fR)" 4
.IX Item "($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y)"
-.ie n .IP "$term\fR\->XChangeInput ($window, \f(CW$add_events\fR[, \f(CW$del_events])" 4
+.ie n .IP "$term\->XChangeInput ($window, $add_events[, $del_events])" 4
.el .IP "\f(CW$term\fR\->XChangeInput ($window, \f(CW$add_events\fR[, \f(CW$del_events\fR])" 4
.IX Item "$term->XChangeInput ($window, $add_events[, $del_events])"
.PD
Various X or X\-related functions. The \f(CW$term\fR object only serves as
the source of the display, otherwise those functions map more-or-less
directory onto the X functions of the same name.
-.ie n .Sh "The ""urxvt::popup"" Class"
-.el .Sh "The \f(CWurxvt::popup\fP Class"
+.ie n .SS "The ""urxvt::popup"" Class"
+.el .SS "The \f(CWurxvt::popup\fP Class"
.IX Subsection "The urxvt::popup Class"
.ie n .IP "$popup\->add_title ($title)" 4
.el .IP "\f(CW$popup\fR\->add_title ($title)" 4
.el .IP "\f(CW$popup\fR\->add_separator ([$sepchr])" 4
.IX Item "$popup->add_separator ([$sepchr])"
Creates a separator, optionally using the character given as \f(CW$sepchr\fR.
-.ie n .IP "$popup\fR\->add_button ($text, \f(CW$cb)" 4
+.ie n .IP "$popup\->add_button ($text, $cb)" 4
.el .IP "\f(CW$popup\fR\->add_button ($text, \f(CW$cb\fR)" 4
.IX Item "$popup->add_button ($text, $cb)"
Adds a clickable button to the popup. \f(CW$cb\fR is called whenever it is
selected.
-.ie n .IP "$popup\fR\->add_toggle ($text, \f(CW$initial_value\fR, \f(CW$cb)" 4
+.ie n .IP "$popup\->add_toggle ($text, $initial_value, $cb)" 4
.el .IP "\f(CW$popup\fR\->add_toggle ($text, \f(CW$initial_value\fR, \f(CW$cb\fR)" 4
.IX Item "$popup->add_toggle ($text, $initial_value, $cb)"
Adds a toggle/checkbox item to the popup. The callback gets called
.el .IP "\f(CW$popup\fR\->show" 4
.IX Item "$popup->show"
Displays the popup (which is initially hidden).
-.ie n .Sh "The ""urxvt::timer"" Class"
-.el .Sh "The \f(CWurxvt::timer\fP Class"
+.ie n .SS "The ""urxvt::timer"" Class"
+.el .SS "The \f(CWurxvt::timer\fP Class"
.IX Subsection "The urxvt::timer Class"
This class implements timer watchers/events. Time is represented as a
fractional number of seconds since the epoch. Example:
.IX Item "$timer = new urxvt::timer"
Create a new timer object in started state. It is scheduled to fire
immediately.
-.ie n .IP "$timer\fR = \f(CW$timer\fR\->cb (sub { my ($timer) = \f(CW@_; ... })" 4
+.ie n .IP "$timer = $timer\->cb (sub { my ($timer) = @_; ... })" 4
.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->cb (sub { my ($timer) = \f(CW@_\fR; ... })" 4
.IX Item "$timer = $timer->cb (sub { my ($timer) = @_; ... })"
Set the callback to be called when the timer triggers.
-.ie n .IP "$tstamp\fR = \f(CW$timer\->at" 4
-.el .IP "\f(CW$tstamp\fR = \f(CW$timer\fR\->at" 4
-.IX Item "$tstamp = $timer->at"
-Return the time this watcher will fire next.
-.ie n .IP "$timer\fR = \f(CW$timer\->set ($tstamp)" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->set ($tstamp)" 4
-.IX Item "$timer = $timer->set ($tstamp)"
-Set the time the event is generated to \f(CW$tstamp\fR.
-.ie n .IP "$timer\fR = \f(CW$timer\->interval ($interval)" 4
+.ie n .IP "$timer = $timer\->set ($tstamp[, $interval])" 4
+.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->set ($tstamp[, \f(CW$interval\fR])" 4
+.IX Item "$timer = $timer->set ($tstamp[, $interval])"
+Set the time the event is generated to \f(CW$tstamp\fR (and optionally specifies a
+new \f(CW$interval\fR).
+.ie n .IP "$timer = $timer\->interval ($interval)" 4
.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->interval ($interval)" 4
.IX Item "$timer = $timer->interval ($interval)"
-Normally (and when \f(CW$interval\fR is \f(CW0\fR), the timer will automatically
+By default (and when \f(CW$interval\fR is \f(CW0\fR), the timer will automatically
stop after it has fired once. If \f(CW$interval\fR is non-zero, then the timer
is automatically rescheduled at the given intervals.
-.ie n .IP "$timer\fR = \f(CW$timer\->start" 4
+.ie n .IP "$timer = $timer\->start" 4
.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->start" 4
.IX Item "$timer = $timer->start"
Start the timer.
-.ie n .IP "$timer\fR = \f(CW$timer\->start ($tstamp)" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->start ($tstamp)" 4
-.IX Item "$timer = $timer->start ($tstamp)"
-Set the event trigger time to \f(CW$tstamp\fR and start the timer.
-.ie n .IP "$timer\fR = \f(CW$timer\->after ($delay)" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->after ($delay)" 4
-.IX Item "$timer = $timer->after ($delay)"
+.ie n .IP "$timer = $timer\->start ($tstamp[, $interval])" 4
+.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->start ($tstamp[, \f(CW$interval\fR])" 4
+.IX Item "$timer = $timer->start ($tstamp[, $interval])"
+Set the event trigger time to \f(CW$tstamp\fR and start the timer. Optionally
+also replaces the interval.
+.ie n .IP "$timer = $timer\->after ($delay[, $interval])" 4
+.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->after ($delay[, \f(CW$interval\fR])" 4
+.IX Item "$timer = $timer->after ($delay[, $interval])"
Like \f(CW\*(C`start\*(C'\fR, but sets the expiry timer to c<urxvt::NOW + \f(CW$delay\fR>.
-.ie n .IP "$timer\fR = \f(CW$timer\->stop" 4
+.ie n .IP "$timer = $timer\->stop" 4
.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->stop" 4
.IX Item "$timer = $timer->stop"
Stop the timer.
-.ie n .Sh "The ""urxvt::iow"" Class"
-.el .Sh "The \f(CWurxvt::iow\fP Class"
+.ie n .SS "The ""urxvt::iow"" Class"
+.el .SS "The \f(CWurxvt::iow\fP Class"
.IX Subsection "The urxvt::iow Class"
This class implements io watchers/events. Example:
.PP
.el .IP "\f(CW$iow\fR = new urxvt::iow" 4
.IX Item "$iow = new urxvt::iow"
Create a new io watcher object in stopped state.
-.ie n .IP "$iow\fR = \f(CW$iow\fR\->cb (sub { my ($iow, \f(CW$reventmask\fR) = \f(CW@_; ... })" 4
+.ie n .IP "$iow = $iow\->cb (sub { my ($iow, $reventmask) = @_; ... })" 4
.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->cb (sub { my ($iow, \f(CW$reventmask\fR) = \f(CW@_\fR; ... })" 4
.IX Item "$iow = $iow->cb (sub { my ($iow, $reventmask) = @_; ... })"
Set the callback to be called when io events are triggered. \f(CW$reventmask\fR
is a bitset as described in the \f(CW\*(C`events\*(C'\fR method.
-.ie n .IP "$iow\fR = \f(CW$iow\->fd ($fd)" 4
+.ie n .IP "$iow = $iow\->fd ($fd)" 4
.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->fd ($fd)" 4
.IX Item "$iow = $iow->fd ($fd)"
Set the file descriptor (not handle) to watch.
-.ie n .IP "$iow\fR = \f(CW$iow\->events ($eventmask)" 4
+.ie n .IP "$iow = $iow\->events ($eventmask)" 4
.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->events ($eventmask)" 4
.IX Item "$iow = $iow->events ($eventmask)"
Set the event mask to watch. The only allowed values are
\&\f(CW\*(C`urxvt::EV_READ\*(C'\fR and \f(CW\*(C`urxvt::EV_WRITE\*(C'\fR, which might be ORed
together, or \f(CW\*(C`urxvt::EV_NONE\*(C'\fR.
-.ie n .IP "$iow\fR = \f(CW$iow\->start" 4
+.ie n .IP "$iow = $iow\->start" 4
.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->start" 4
.IX Item "$iow = $iow->start"
Start watching for requested events on the given handle.
-.ie n .IP "$iow\fR = \f(CW$iow\->stop" 4
+.ie n .IP "$iow = $iow\->stop" 4
.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->stop" 4
.IX Item "$iow = $iow->stop"
Stop watching for events on the given file handle.
-.ie n .Sh "The ""urxvt::iw"" Class"
-.el .Sh "The \f(CWurxvt::iw\fP Class"
+.ie n .SS "The ""urxvt::iw"" Class"
+.el .SS "The \f(CWurxvt::iw\fP Class"
.IX Subsection "The urxvt::iw Class"
This class implements idle watchers, that get called automatically when
the process is idle. They should return as fast as possible, after doing
.el .IP "\f(CW$iw\fR = new urxvt::iw" 4
.IX Item "$iw = new urxvt::iw"
Create a new idle watcher object in stopped state.
-.ie n .IP "$iw\fR = \f(CW$iw\fR\->cb (sub { my ($iw) = \f(CW@_; ... })" 4
+.ie n .IP "$iw = $iw\->cb (sub { my ($iw) = @_; ... })" 4
.el .IP "\f(CW$iw\fR = \f(CW$iw\fR\->cb (sub { my ($iw) = \f(CW@_\fR; ... })" 4
.IX Item "$iw = $iw->cb (sub { my ($iw) = @_; ... })"
Set the callback to be called when the watcher triggers.
-.ie n .IP "$timer\fR = \f(CW$timer\->start" 4
+.ie n .IP "$timer = $timer\->start" 4
.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->start" 4
.IX Item "$timer = $timer->start"
Start the watcher.
-.ie n .IP "$timer\fR = \f(CW$timer\->stop" 4
+.ie n .IP "$timer = $timer\->stop" 4
.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->stop" 4
.IX Item "$timer = $timer->stop"
Stop the watcher.
-.ie n .Sh "The ""urxvt::pw"" Class"
-.el .Sh "The \f(CWurxvt::pw\fP Class"
+.ie n .SS "The ""urxvt::pw"" Class"
+.el .SS "The \f(CWurxvt::pw\fP Class"
.IX Subsection "The urxvt::pw Class"
This class implements process watchers. They create an event whenever a
process exits, after which they stop automatically.
.el .IP "\f(CW$pw\fR = new urxvt::pw" 4
.IX Item "$pw = new urxvt::pw"
Create a new process watcher in stopped state.
-.ie n .IP "$pw\fR = \f(CW$pw\fR\->cb (sub { my ($pw, \f(CW$exit_status\fR) = \f(CW@_; ... })" 4
+.ie n .IP "$pw = $pw\->cb (sub { my ($pw, $exit_status) = @_; ... })" 4
.el .IP "\f(CW$pw\fR = \f(CW$pw\fR\->cb (sub { my ($pw, \f(CW$exit_status\fR) = \f(CW@_\fR; ... })" 4
.IX Item "$pw = $pw->cb (sub { my ($pw, $exit_status) = @_; ... })"
Set the callback to be called when the timer triggers.
-.ie n .IP "$pw\fR = \f(CW$timer\->start ($pid)" 4
+.ie n .IP "$pw = $timer\->start ($pid)" 4
.el .IP "\f(CW$pw\fR = \f(CW$timer\fR\->start ($pid)" 4
.IX Item "$pw = $timer->start ($pid)"
Tells the watcher to start watching for process \f(CW$pid\fR.
-.ie n .IP "$pw\fR = \f(CW$pw\->stop" 4
+.ie n .IP "$pw = $pw\->stop" 4
.el .IP "\f(CW$pw\fR = \f(CW$pw\fR\->stop" 4
.IX Item "$pw = $pw->stop"
Stop the watcher.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
-.Sh "\s-1URXVT_PERL_VERBOSITY\s0"
+.SS "\s-1URXVT_PERL_VERBOSITY\s0"
.IX Subsection "URXVT_PERL_VERBOSITY"
This variable controls the verbosity level of the perl extension. Higher
numbers indicate more verbose output.