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.126 by root, Tue Jan 24 19:14:36 2006 UTC vs.
Revision 1.129 by root, Wed Jan 25 15:11:31 2006 UTC

… …
212Uses per-line display filtering (C<on_line_update>) to underline urls and 212Uses per-line display filtering (C<on_line_update>) to underline urls and
213make them clickable. When middle-clicked, the program specified in the 213make them clickable. When middle-clicked, the program specified in the
214resource C<urlLauncher> (default C<x-www-browser>) will be started with 214resource C<urlLauncher> (default C<x-www-browser>) will be started with
215the URL as first argument. 215the URL as first argument.
216 216
217=item xim-onthespot
218
219This (experimental) perl extension implements OnTheSpot editing. It does
220not work perfectly, and some input methods don't seem to work well with
221OnTheSpot editing in general, but it seems to work at leats for SCIM and
222kinput2.
223
224You enable it by specifying this extension and a preedit style of
225C<OnTheSpot>, i.e.:
226
227 @@RXVT_NAME@@ -pt OnTheSpot -pe xim-onthespot
228
217=item automove-background 229=item automove-background
218 230
219This is basically a one-line extension that dynamically changes the background pixmap offset 231This is basically a one-line extension that dynamically changes the background pixmap offset
220to the window position, in effect creating the same effect as pseudo transparency with 232to the window position, in effect creating the same effect as pseudo transparency with
221a custom pixmap. No scaling is supported in this mode. Exmaple: 233a custom pixmap. No scaling is supported in this mode. Exmaple:
… …
230 242
231=item digital-clock 243=item digital-clock
232 244
233Displays a digital clock using the built-in overlay. 245Displays a digital clock using the built-in overlay.
234 246
235=item example-refresh-hooks 247=item remote-selection
236 248
237Displays a very simple digital clock in the upper right corner of the 249Somewhat of a misnomer, this extension adds two menu entries to the
238window. Illustrates overwriting the refresh callbacks to create your own 250selection popup that allows one ti run external commands to store the
239overlays 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'
240 266
241=item selection-pastebin 267=item selection-pastebin
242 268
243This is a little rarely useful extension that Uploads the selection as 269This is a little rarely useful extension that Uploads the selection as
244textfile to a remote site (or does other things). (The implementation is 270textfile to a remote site (or does other things). (The implementation is
… …
264After 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
265in the C<selection-pastebin-url> resource (again, the % is the placeholder 291in the C<selection-pastebin-url> resource (again, the % is the placeholder
266for the filename): 292for the filename):
267 293
268 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.
269 301
270=back 302=back
271 303
272=head1 API DOCUMENTATION 304=head1 API DOCUMENTATION
273 305
… …
370Called at the very end of initialisation of a new terminal, just before 402Called at the very end of initialisation of a new terminal, just before
371trying to map (display) the toplevel and returning to the mainloop. 403trying to map (display) the toplevel and returning to the mainloop.
372 404
373=item on_destroy $term 405=item on_destroy $term
374 406
375Called whenever something tries to destroy terminal, before doing anything 407Called whenever something tries to destroy terminal, when the terminal is
376yet. If this hook returns true, then destruction is skipped, but this is 408still fully functional (not for long, though).
377rarely a good idea.
378 409
379=item on_reset $term 410=item on_reset $term
380 411
381Called after the screen is "reset" for any reason, such as resizing or 412Called after the screen is "reset" for any reason, such as resizing or
382control sequences. Here is where you can react on changes to size-related 413control sequences. Here is where you can react on changes to size-related

Diff Legend

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