<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
<tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
<tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
+<tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr>
</table><p></p></dl>
<p></p>
<p>
.\" ========================================================================
.\"
.IX Title "rxvt 7"
-.TH rxvt 7 "2006-01-02" "6.2" "RXVT-UNICODE"
+.TH rxvt 7 "2006-01-04" "6.2" "RXVT-UNICODE"
.SH "NAME"
RXVT REFERENCE \- FAQ, command sequences and other background information
.SH "SYNOPSIS"
Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
+Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
.TE
.PP
B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
+ B<< C<Ps = 777> >> Call the perl extension with the given string, which should be of the form C<extension:parameters> (Compile perl).
=end table
Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
+ Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
Called whenever the <code>program(s)</code> running in the urxvt window send output.
</dd>
<p></p>
+<dt><strong><a name="item_on_osc_seq__24term_2c__24string">on_osc_seq $term, $string</a></strong><br />
+</dt>
+<dd>
+Called whenever the <strong>ESC ] 777 ; string ST</strong> command sequence (OSC =
+operating system command) is processed. Cursor position and other state
+information is up-to-date when this happens. For interoperability, the
+string should start with the extension name and a colon, to distinguish
+it from commands for other extensions, and this might be enforced in the
+future.
+</dd>
+<dd>
+<p>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
+other users on the same system etc.).</p>
+</dd>
+<p></p>
<dt><strong><a name="item_on_refresh_begin__24term">on_refresh_begin $term</a></strong><br />
</dt>
<dd>
.el .IP "on_tty_activity \f(CW$term\fR *NYI*" 4
.IX Item "on_tty_activity $term *NYI*"
Called whenever the program(s) running in the urxvt window send output.
+.ie n .IP "on_osc_seq $term\fR, \f(CW$string" 4
+.el .IP "on_osc_seq \f(CW$term\fR, \f(CW$string\fR" 4
+.IX Item "on_osc_seq $term, $string"
+Called whenever the \fB\s-1ESC\s0 ] 777 ; string \s-1ST\s0\fR command sequence (\s-1OSC\s0 =
+operating system command) is processed. Cursor position and other state
+information is up-to-date when this happens. For interoperability, the
+string should start with the extension name and a colon, to distinguish
+it from commands for other extensions, and this might be enforced in the
+future.
+.Sp
+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
+other users on the same system etc.).
.ie n .IP "on_refresh_begin $term" 4
.el .IP "on_refresh_begin \f(CW$term\fR" 4
.IX Item "on_refresh_begin $term"
Called whenever the program(s) running in the urxvt window send
output.
+ on_osc_seq $term, $string
+ Called whenever the ESC ] 777 ; string ST command sequence (OSC =
+ operating system command) is processed. Cursor position and other
+ state information is up-to-date when this happens. For
+ interoperability, the string should start with the extension name
+ and a colon, to distinguish it from commands for other extensions,
+ and this might be enforced in the future.
+
+ 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 other users on the same system etc.).
+
on_refresh_begin $term
Called just before the screen gets redrawn. Can be used for overlay
or similar effects by modify terminal contents in refresh_begin, and
case URxvt_view_up:
case URxvt_view_down:
- int lines = atoi (str);
+ {
+ int lines = atoi (str);
- if (lines)
- scr_page (op == URxvt_view_up ? UP : DN, lines);
- else
- scr_erase_savelines ();
+ if (lines)
+ scr_page (op == URxvt_view_up ? UP : DN, lines);
+ else
+ scr_erase_savelines ();
+ }
break;
#endif
if (PERL_INVOKE ((this, HOOK_OSC_SEQ, DT_STRING, str, DT_END)))
; // no responses yet
break;
-
#endif
-
}
}
/*----------------------------------------------------------------------*/
URxvt_view_up = 720,
URxvt_view_down = 721,
+
+ URxvt_perl = 777,
};
/* Words starting with `Color_' are colours. Others are counts */
HOOK_VIEW_CHANGE,
HOOK_SCROLL_BACK,
HOOK_TTY_ACTIVITY,
+ HOOK_OSC_SEQ,
HOOK_REFRESH_BEGIN,
HOOK_REFRESH_END,
set_hookname (VIEW_CHANGE);
set_hookname (SCROLL_BACK);
set_hookname (TTY_ACTIVITY);
+ set_hookname (OSC_SEQ);
set_hookname (REFRESH_BEGIN);
set_hookname (REFRESH_END);
set_hookname (KEYBOARD_COMMAND);
=item on_osc_seq $term, $string
-Called whenever the B<ESC ] 777 ; string ST> command sequence is
-processed. Cursor position and other state information is up-to-date when
-this happens. For interoperability, the string should start with the
-extension name and a colon, to distinguish it from commands for other
-extensions, and this might be enforced in the future.
+Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC =
+operating system command) is processed. Cursor position and other state
+information is up-to-date when this happens. For interoperability, the
+string should start with the extension name and a colon, to distinguish
+it from commands for other extensions, and this might be enforced in the
+future.
+
+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
+other users on the same system etc.).
=item on_refresh_begin $term