ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/urxvt.pm
(Generate patch)

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.128 by root, Wed Jan 25 00:57:57 2006 UTC vs.
Revision 1.130 by root, Wed Jan 25 15:32:48 2006 UTC

… …
242 242
243=item digital-clock 243=item digital-clock
244 244
245Displays a digital clock using the built-in overlay. 245Displays a digital clock using the built-in overlay.
246 246
247=item example-refresh-hooks 247=item remote-clipboard
248 248
249Displays a very simple digital clock in the upper right corner of the 249Somewhat of a misnomer, this extension adds two menu entries to the
250window. Illustrates overwriting the refresh callbacks to create your own 250selection popup that allows one ti run external commands to store the
251overlays or changes. 251selection somewhere and fetch it again.
252
253We use it to implement a "distributed selection mechanism", which just
254means that one command uploads the file to a remote server, and another
255reads it.
256
257The commands can be set using the C<URxvt.remote-selection.store> and
258C<URxvt.remote-selection.fetch> resources. The first should read the
259selection to store from STDIN (always in UTF-8), the second should provide
260the selection data on STDOUT (also in UTF-8).
261
262The defaults (which are likely useless to you) use rsh and cat:
263
264 URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
265 URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'
252 266
253=item selection-pastebin 267=item selection-pastebin
254 268
255This is a little rarely useful extension that Uploads the selection as 269This is a little rarely useful extension that Uploads the selection as
256textfile to a remote site (or does other things). (The implementation is 270textfile to a remote site (or does other things). (The implementation is
… …
276After a successful upload the selection will be replaced by the text given 290After a successful upload the selection will be replaced by the text given
277in the C<selection-pastebin-url> resource (again, the % is the placeholder 291in the C<selection-pastebin-url> resource (again, the % is the placeholder
278for the filename): 292for the filename):
279 293
280 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% 294 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
295
296=item example-refresh-hooks
297
298Displays a very simple digital clock in the upper right corner of the
299window. Illustrates overwriting the refresh callbacks to create your own
300overlays or changes.
281 301
282=back 302=back
283 303
284=head1 API DOCUMENTATION 304=head1 API DOCUMENTATION
285 305
… …
495 515
496=item on_refresh_end $term 516=item on_refresh_end $term
497 517
498Called just after the screen gets redrawn. See C<on_refresh_begin>. 518Called just after the screen gets redrawn. See C<on_refresh_begin>.
499 519
500=item on_keyboard_command $term, $string 520=item on_user_command $term, $string
501 521
502Called whenever the user presses a key combination that has a 522Called whenever the a user-configured event is being activated (e.g. via
503C<perl:string> action bound to it (see description of the B<keysym> 523a C<perl:string> action bound to a key, see description of the B<keysym>
504resource in the @@RXVT_NAME@@(1) manpage). 524resource in the @@RXVT_NAME@@(1) manpage).
525
526The event is simply the action string. This interface is assumed to change
527slightly in the future.
505 528
506=item on_x_event $term, $event 529=item on_x_event $term, $event
507 530
508Called on every X event received on the vt window (and possibly other 531Called on every X event received on the vt window (and possibly other
509windows). Should only be used as a last resort. Most event structure 532windows). Should only be used as a last resort. Most event structure

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines