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.125 by root, Sun Jan 22 20:39:47 2006 UTC vs.
Revision 1.129 by root, Wed Jan 25 15:11:31 2006 UTC

… …
66contain at least one pair of capturing parentheses, which will be used for 66contain at least one pair of capturing parentheses, which will be used for
67the match. For example, the followign adds a regex that matches everything 67the match. For example, the followign adds a regex that matches everything
68between two vertical bars: 68between two vertical bars:
69 69
70 URxvt.selection.pattern-0: \\|([^|]+)\\| 70 URxvt.selection.pattern-0: \\|([^|]+)\\|
71
72Another example: Programs I use often output "absolute path: " at the
73beginning of a line when they process multiple files. The following
74pattern matches the filename (note, there is a single space at the very
75end):
76
77 URxvt.selection.pattern-0: ^(/[^:]+):\
71 78
72You can look at the source of the selection extension to see more 79You can look at the source of the selection extension to see more
73interesting uses, such as parsing a line from beginning to end. 80interesting uses, such as parsing a line from beginning to end.
74 81
75This extension also offers following bindable keyboard commands: 82This extension also offers following bindable keyboard commands:
… …
205Uses 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
206make them clickable. When middle-clicked, the program specified in the 213make them clickable. When middle-clicked, the program specified in the
207resource C<urlLauncher> (default C<x-www-browser>) will be started with 214resource C<urlLauncher> (default C<x-www-browser>) will be started with
208the URL as first argument. 215the URL as first argument.
209 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
210=item automove-background 229=item automove-background
211 230
212This 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
213to 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
214a custom pixmap. No scaling is supported in this mode. Exmaple: 233a custom pixmap. No scaling is supported in this mode. Exmaple:
… …
223 242
224=item digital-clock 243=item digital-clock
225 244
226Displays a digital clock using the built-in overlay. 245Displays a digital clock using the built-in overlay.
227 246
228=item example-refresh-hooks 247=item remote-selection
229 248
230Displays a very simple digital clock in the upper right corner of the 249Somewhat of a misnomer, this extension adds two menu entries to the
231window. Illustrates overwriting the refresh callbacks to create your own 250selection popup that allows one ti run external commands to store the
232overlays 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'
233 266
234=item selection-pastebin 267=item selection-pastebin
235 268
236This is a little rarely useful extension that Uploads the selection as 269This is a little rarely useful extension that Uploads the selection as
237textfile to a remote site (or does other things). (The implementation is 270textfile to a remote site (or does other things). (The implementation is
… …
257After 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
258in the C<selection-pastebin-url> resource (again, the % is the placeholder 291in the C<selection-pastebin-url> resource (again, the % is the placeholder
259for the filename): 292for the filename):
260 293
261 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.
262 301
263=back 302=back
264 303
265=head1 API DOCUMENTATION 304=head1 API DOCUMENTATION
266 305
… …
363Called 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
364trying to map (display) the toplevel and returning to the mainloop. 403trying to map (display) the toplevel and returning to the mainloop.
365 404
366=item on_destroy $term 405=item on_destroy $term
367 406
368Called whenever something tries to destroy terminal, before doing anything 407Called whenever something tries to destroy terminal, when the terminal is
369yet. If this hook returns true, then destruction is skipped, but this is 408still fully functional (not for long, though).
370rarely a good idea.
371 409
372=item on_reset $term 410=item on_reset $term
373 411
374Called 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
375control 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