--- rxvt-unicode/src/urxvt.pm	2009/12/26 09:42:16	1.180
+++ rxvt-unicode/src/urxvt.pm	2010/07/01 21:17:11	1.184
@@ -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</tmp> directly.).
@@ -372,10 +372,10 @@
 
 I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret
 the double C</> characters as comment start. Use C<\057\057> instead,
-which works regardless of wether xrdb is used to parse the resource file
+which works regardless of whether 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<maxosx-pastebin> requires the
+perl from apple's devkit or so, and C<macosx-clipboard> requires the
 C<Mac::Pasteboard> 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<ROW_t> 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<row> and C<col>, 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
@@ -1391,15 +1395,21 @@
 rectangular selection will be made. This is the prefered function to make
 a selection.
 
-=item $success = $term->selection_grab ($eventtime)
+=item $success = $term->selection_grab ($eventtime[, $clipboard])
 
-Try to request the primary selection text from the server (for example, as
-set by the next method). No visual feedback will be given. This function
+Try to acquire ownership of the primary (clipboard if C<$clipboard> is
+true) selection from the server. The corresponding text can be set
+with the next method. No visual feedback will be given. This function
 is mostly useful from within C<on_sel_grab> hooks.
 
-=item $oldtext = $term->selection ([$newtext])
+=item $oldtext = $term->selection ([$newtext, $clipboard])
+
+Return the current selection (clipboard if C<$clipboard> is true) text
+and optionally replace it by C<$newtext>.
+
+=item $term->selection_clear ([$clipboard])
 
-Return the current selection text and optionally replace it by C<$newtext>.
+Revoke ownership of the primary (clipboard if C<$clipboard> is true) selection.
 
 =item $term->overlay_simple ($x, $y, $text)
 
@@ -1863,7 +1873,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.
 
@@ -1895,7 +1905,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