| … | |
… | |
| 216 | U+259F) by a similar-looking ascii character. |
216 | U+259F) by a similar-looking ascii character. |
| 217 | |
217 | |
| 218 | digital-clock |
218 | digital-clock |
| 219 | Displays a digital clock using the built-in overlay. |
219 | Displays a digital clock using the built-in overlay. |
| 220 | |
220 | |
| 221 | example-refresh-hooks |
221 | remote-clipboard |
| 222 | Displays a very simple digital clock in the upper right corner of |
222 | Somewhat of a misnomer, this extension adds two menu entries to the |
| 223 | the window. Illustrates overwriting the refresh callbacks to create |
223 | selection popup that allows one ti run external commands to store |
| 224 | your own overlays or changes. |
224 | the selection somewhere and fetch it again. |
|
|
225 | |
|
|
226 | We use it to implement a "distributed selection mechanism", which |
|
|
227 | just means that one command uploads the file to a remote server, and |
|
|
228 | another reads it. |
|
|
229 | |
|
|
230 | The commands can be set using the "URxvt.remote-selection.store" and |
|
|
231 | "URxvt.remote-selection.fetch" resources. The first should read the |
|
|
232 | selection to store from STDIN (always in UTF-8), the second should |
|
|
233 | provide the selection data on STDOUT (also in UTF-8). |
|
|
234 | |
|
|
235 | The defaults (which are likely useless to you) use rsh and cat: |
|
|
236 | |
|
|
237 | URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection' |
|
|
238 | URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection' |
| 225 | |
239 | |
| 226 | selection-pastebin |
240 | selection-pastebin |
| 227 | This is a little rarely useful extension that Uploads the selection |
241 | This is a little rarely useful extension that Uploads the selection |
| 228 | as textfile to a remote site (or does other things). (The |
242 | as textfile to a remote site (or does other things). (The |
| 229 | implementation is not currently secure for use in a multiuser |
243 | implementation is not currently secure for use in a multiuser |
| … | |
… | |
| 248 | After a successful upload the selection will be replaced by the text |
262 | After a successful upload the selection will be replaced by the text |
| 249 | given in the "selection-pastebin-url" resource (again, the % is the |
263 | given in the "selection-pastebin-url" resource (again, the % is the |
| 250 | placeholder for the filename): |
264 | placeholder for the filename): |
| 251 | |
265 | |
| 252 | URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% |
266 | URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% |
|
|
267 | |
|
|
268 | example-refresh-hooks |
|
|
269 | Displays a very simple digital clock in the upper right corner of |
|
|
270 | the window. Illustrates overwriting the refresh callbacks to create |
|
|
271 | your own overlays or changes. |
| 253 | |
272 | |
| 254 | API DOCUMENTATION |
273 | API DOCUMENTATION |
| 255 | General API Considerations |
274 | General API Considerations |
| 256 | All objects (such as terminals, time watchers etc.) are typical |
275 | All objects (such as terminals, time watchers etc.) are typical |
| 257 | reference-to-hash objects. The hash can be used to store anything you |
276 | reference-to-hash objects. The hash can be used to store anything you |
| … | |
… | |
| 434 | display code is run after this hook, and takes precedence. |
453 | display code is run after this hook, and takes precedence. |
| 435 | |
454 | |
| 436 | on_refresh_end $term |
455 | on_refresh_end $term |
| 437 | Called just after the screen gets redrawn. See "on_refresh_begin". |
456 | Called just after the screen gets redrawn. See "on_refresh_begin". |
| 438 | |
457 | |
| 439 | on_keyboard_command $term, $string |
458 | on_user_command $term, $string |
| 440 | Called whenever the user presses a key combination that has a |
459 | Called whenever the a user-configured event is being activated (e.g. |
| 441 | "perl:string" action bound to it (see description of the keysym |
460 | via a "perl:string" action bound to a key, see description of the |
| 442 | resource in the rxvt(1) manpage). |
461 | keysym resource in the rxvt(1) manpage). |
|
|
462 | |
|
|
463 | The event is simply the action string. This interface is assumed to |
|
|
464 | change slightly in the future. |
| 443 | |
465 | |
| 444 | on_x_event $term, $event |
466 | on_x_event $term, $event |
| 445 | Called on every X event received on the vt window (and possibly |
467 | Called on every X event received on the vt window (and possibly |
| 446 | other windows). Should only be used as a last resort. Most event |
468 | other windows). Should only be used as a last resort. Most event |
| 447 | structure members are not passed. |
469 | structure members are not passed. |
