--- rxvt-unicode/src/urxvt.pm	2006/01/03 23:41:37	1.27
+++ rxvt-unicode/src/urxvt.pm	2006/01/04 00:12:12	1.29
@@ -174,6 +174,19 @@
 
 Called whenever the program(s) running in the urxvt window send output.
 
+=item on_osc_seq $term, $string
+
+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
 
 Called just before the screen gets redrawn. Can be used for overlay