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.180 by root, Sat Dec 26 09:42:16 2009 UTC vs.
Revision 1.186 by sf-exg, Fri Jul 23 17:50:41 2010 UTC

341 URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection' 341 URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
342 URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection' 342 URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'
343 343
344=item selection-pastebin 344=item selection-pastebin
345 345
346This is a little rarely useful extension that Uploads the selection as 346This is a little rarely useful extension that uploads the selection as
347textfile to a remote site (or does other things). (The implementation is 347textfile to a remote site (or does other things). (The implementation is
348not currently secure for use in a multiuser environment as it writes to 348not currently secure for use in a multiuser environment as it writes to
349F</tmp> directly.). 349F</tmp> directly.).
350 350
351It listens to the C<selection-pastebin:remote-pastebin> keyboard command, 351It listens to the C<selection-pastebin:remote-pastebin> keyboard command,
370 370
371 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% 371 URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
372 372
373I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret 373I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret
374the double C</> characters as comment start. Use C<\057\057> instead, 374the double C</> characters as comment start. Use C<\057\057> instead,
375which works regardless of wether xrdb is used to parse the resource file 375which works regardless of whether xrdb is used to parse the resource file
376or not. 376or not.
377 377
378=item macosx-pastebin and macosx-pastebin-native 378=item macosx-clipboard and macosx-clipboard-native
379 379
380These two modules implement an extended clipboard for Mac OS X. They are 380These two modules implement an extended clipboard for Mac OS X. They are
381used like this: 381used like this:
382 382
383 URxvt.perl-ext-common: default,macosx-clipboard 383 URxvt.perl-ext-common: default,macosx-clipboard
384 URxvt.keysym.M-c: perl:macosx-clipboard:copy 384 URxvt.keysym.M-c: perl:macosx-clipboard:copy
385 URxvt.keysym.M-v: perl:macosx-clipboard:paste 385 URxvt.keysym.M-v: perl:macosx-clipboard:paste
386 386
387The difference between them is that the native variant requires a 387The difference between them is that the native variant requires a
388perl from apple's devkit or so, and C<maxosx-pastebin> requires the 388perl from apple's devkit or so, and C<macosx-clipboard> requires the
389C<Mac::Pasteboard> module, works with other perls, has fewer bugs, is 389C<Mac::Pasteboard> module, works with other perls, has fewer bugs, is
390simpler etc. etc. 390simpler etc. etc.
391 391
392=item example-refresh-hooks 392=item example-refresh-hooks
393 393
417 417
418=over 4 418=over 4
419 419
420=item $text 420=item $text
421 421
422Rxvt-unicodes special way of encoding text, where one "unicode" character 422Rxvt-unicode's special way of encoding text, where one "unicode" character
423always represents one screen cell. See L<ROW_t> for a discussion of this format. 423always represents one screen cell. See L<ROW_t> for a discussion of this format.
424 424
425=item $string 425=item $string
426 426
427A perl text string, with an emphasis on I<text>. It can store all unicode 427A perl text string, with an emphasis on I<text>. It can store all unicode
644resource in the @@RXVT_NAME@@(1) manpage). 644resource in the @@RXVT_NAME@@(1) manpage).
645 645
646The event is simply the action string. This interface is assumed to change 646The event is simply the action string. This interface is assumed to change
647slightly in the future. 647slightly in the future.
648 648
649=item on_resize_all_windows $tern, $new_width, $new_height 649=item on_resize_all_windows $term, $new_width, $new_height
650 650
651Called just after the new window size has been calculated, but before 651Called just after the new window size has been calculated, but before
652windows are actually being resized or hints are being set. If this hook 652windows are actually being resized or hints are being set. If this hook
653returns TRUE, setting of the window hints is being skipped. 653returns TRUE, setting of the window hints is being skipped.
654 654
688 688
689=item on_map_notify $term, $event 689=item on_map_notify $term, $event
690 690
691=item on_unmap_notify $term, $event 691=item on_unmap_notify $term, $event
692 692
693Called whenever the corresponding X event is received for the terminal If 693Called whenever the corresponding X event is received for the terminal. If
694the hook returns true, then the even will be ignored by rxvt-unicode. 694the hook returns true, then the event will be ignored by rxvt-unicode.
695 695
696The event is a hash with most values as named by Xlib (see the XEvent 696The event is a hash with most values as named by Xlib (see the XEvent
697manpage), with the additional members C<row> and C<col>, which are the 697manpage), with the additional members C<row> and C<col>, which are the
698(real, not screen-based) row and column under the mouse cursor. 698(real, not screen-based) row and column under the mouse cursor.
699 699
708 708
709=item on_wm_delete_window $term, $event 709=item on_wm_delete_window $term, $event
710 710
711Called when various types of ClientMessage events are received (all with 711Called when various types of ClientMessage events are received (all with
712format=32, WM_PROTOCOLS or WM_PROTOCOLS:WM_DELETE_WINDOW). 712format=32, WM_PROTOCOLS or WM_PROTOCOLS:WM_DELETE_WINDOW).
713
714=item on_bell $term
715
716Called on receipt of a bell character.
713 717
714=back 718=back
715 719
716=cut 720=cut
717 721
1386 1390
1387=item $term->selection_make ($eventtime[, $rectangular]) 1391=item $term->selection_make ($eventtime[, $rectangular])
1388 1392
1389Tries to make a selection as set by C<selection_beg> and 1393Tries to make a selection as set by C<selection_beg> and
1390C<selection_end>. If C<$rectangular> is true (default: false), a 1394C<selection_end>. If C<$rectangular> is true (default: false), a
1391rectangular selection will be made. This is the prefered function to make 1395rectangular selection will be made. This is the preferred function to make
1392a selection. 1396a selection.
1393 1397
1394=item $success = $term->selection_grab ($eventtime) 1398=item $success = $term->selection_grab ($eventtime[, $clipboard])
1395 1399
1396Try to request the primary selection text from the server (for example, as 1400Try to acquire ownership of the primary (clipboard if C<$clipboard> is
1401true) selection from the server. The corresponding text can be set
1397set by the next method). No visual feedback will be given. This function 1402with the next method. No visual feedback will be given. This function
1398is mostly useful from within C<on_sel_grab> hooks. 1403is mostly useful from within C<on_sel_grab> hooks.
1399 1404
1400=item $oldtext = $term->selection ([$newtext]) 1405=item $oldtext = $term->selection ([$newtext, $clipboard])
1401 1406
1402Return the current selection text and optionally replace it by C<$newtext>. 1407Return the current selection (clipboard if C<$clipboard> is true) text
1408and optionally replace it by C<$newtext>.
1409
1410=item $term->selection_clear ([$clipboard])
1411
1412Revoke ownership of the primary (clipboard if C<$clipboard> is true) selection.
1403 1413
1404=item $term->overlay_simple ($x, $y, $text) 1414=item $term->overlay_simple ($x, $y, $text)
1405 1415
1406Create a simple multi-line overlay box. See the next method for details. 1416Create a simple multi-line overlay box. See the next method for details.
1407 1417
1535locale-specific encoding of the terminal and can contain command sequences 1545locale-specific encoding of the terminal and can contain command sequences
1536(escape codes) that will be interpreted. 1546(escape codes) that will be interpreted.
1537 1547
1538=item $term->tt_write ($octets) 1548=item $term->tt_write ($octets)
1539 1549
1540Write the octets given in C<$data> to the tty (i.e. as program input). To 1550Write the octets given in C<$octets> to the tty (i.e. as program input). To
1541pass characters instead of octets, you should convert your strings first 1551pass characters instead of octets, you should convert your strings first
1542to the locale-specific encoding using C<< $term->locale_encode >>. 1552to the locale-specific encoding using C<< $term->locale_encode >>.
1543 1553
1544=item $old_events = $term->pty_ev_events ([$new_events]) 1554=item $old_events = $term->pty_ev_events ([$new_events])
1545 1555
1861Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most 1871Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most
1862recent grab. 1872recent grab.
1863 1873
1864=item $term->ungrab 1874=item $term->ungrab
1865 1875
1866Calls XUngrab for the most recent grab. Is called automatically on 1876Calls XUngrabPointer and XUngrabKeyboard for the most recent grab. Is called automatically on
1867evaluation errors, as it is better to lose the grab in the error case as 1877evaluation errors, as it is better to lose the grab in the error case as
1868the session. 1878the session.
1869 1879
1870=item $atom = $term->XInternAtom ($atom_name[, $only_if_exists]) 1880=item $atom = $term->XInternAtom ($atom_name[, $only_if_exists])
1871 1881
1893 1903
1894=item $term->XChangeInput ($window, $add_events[, $del_events]) 1904=item $term->XChangeInput ($window, $add_events[, $del_events])
1895 1905
1896Various X or X-related functions. The C<$term> object only serves as 1906Various X or X-related functions. The C<$term> object only serves as
1897the source of the display, otherwise those functions map more-or-less 1907the source of the display, otherwise those functions map more-or-less
1898directory onto the X functions of the same name. 1908directly onto the X functions of the same name.
1899 1909
1900=back 1910=back
1901 1911
1902=cut 1912=cut
1903 1913

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines