--- rxvt-unicode/src/urxvt.pm 2009/12/26 09:23:53 1.179 +++ rxvt-unicode/src/urxvt.pm 2010/02/17 08:27:56 1.182 @@ -343,7 +343,7 @@ =item selection-pastebin -This is a little rarely useful extension that Uploads the selection as +This is a little rarely useful extension that uploads the selection as textfile to a remote site (or does other things). (The implementation is not currently secure for use in a multiuser environment as it writes to F directly.). @@ -375,7 +375,7 @@ which works regardless of wether xrdb is used to parse the resource file or not. -=item macosx-pastebin and macosx-pastebin-native +=item macosx-clipboard and macosx-clipboard-native These two modules implement an extended clipboard for Mac OS X. They are used like this: @@ -385,7 +385,7 @@ URxvt.keysym.M-v: perl:macosx-clipboard:paste The difference between them is that the native variant requires a -perl from apple's devkit or so, and C requires the +perl from apple's devkit or so, and C requires the C module, works with other perls, has fewer bugs, is simpler etc. etc. @@ -419,7 +419,7 @@ =item $text -Rxvt-unicodes special way of encoding text, where one "unicode" character +Rxvt-unicode's special way of encoding text, where one "unicode" character always represents one screen cell. See L for a discussion of this format. =item $string @@ -690,8 +690,8 @@ =item on_unmap_notify $term, $event -Called whenever the corresponding X event is received for the terminal If -the hook returns true, then the even will be ignored by rxvt-unicode. +Called whenever the corresponding X event is received for the terminal. If +the hook returns true, then the event will be ignored by rxvt-unicode. The event is a hash with most values as named by Xlib (see the XEvent manpage), with the additional members C and C, which are the @@ -711,6 +711,10 @@ Called when various types of ClientMessage events are received (all with format=32, WM_PROTOCOLS or WM_PROTOCOLS:WM_DELETE_WINDOW). +=item on_bell $term + +Called on receipt of a bell character. + =back =cut @@ -1374,8 +1378,15 @@ =item ($row, $col) = $term->selection_end ([$row, $col]) -Return the current values of the selection mark, begin or end positions, -and optionally set them to new values. +Return the current values of the selection mark, begin or end positions. + +When arguments are given, then the selection coordinates are set to +C<$row> and C<$col>, and the selection screen is set to the current +screen. + +=item $screen = $term->selection_screen ([$screen]) + +Returns the current selection screen, and then optionally sets it. =item $term->selection_make ($eventtime[, $rectangular]) @@ -1856,7 +1867,7 @@ =item $term->ungrab -Calls XUngrab for the most recent grab. Is called automatically on +Calls XUngrabPointer and XUngrabKeyboard for the most recent grab. Is called automatically on evaluation errors, as it is better to lose the grab in the error case as the session. @@ -1888,7 +1899,7 @@ Various X or X-related functions. The C<$term> object only serves as the source of the display, otherwise those functions map more-or-less -directory onto the X functions of the same name. +directly onto the X functions of the same name. =back