--- rxvt-unicode/doc/rxvtperl.3.txt	2006/01/20 22:49:34	1.33
+++ rxvt-unicode/doc/rxvtperl.3.txt	2006/01/22 20:39:56	1.35
@@ -114,6 +114,24 @@
         stay at the current position and additionally stores the first match
         in the current line into the primary selection.
 
+    readline (enabled by default)
+        A support package that tries to make editing with readline easier.
+        At the moment, it reacts to clicking with the left mouse button by
+        trying to move the text cursor to this position. It does so by
+        generating as many cursor-left or cursor-right keypresses as
+        required (the this only works for programs that correctly support
+        wide characters).
+
+        To avoid too many false positives, this is only done when:
+
+        - the tty is in ICANON state.
+        - the text cursor is visible.
+        - the primary screen is currently being displayed.
+        - the mouse is on the same (multi-row-) line as the text cursor.
+
+        The normal selection mechanism isn't disabled, so quick successive
+        clicks might interfere with selection creation in harmless ways.
+
     selection-autotransform
         This selection allows you to do automatic transforms on a selection
         whenever a selection is made.
@@ -149,20 +167,6 @@
         of every error message as a selection pattern, and the second line
         transforms the message into vi commands to load the file.
 
-    readline
-        A support package that tries to make editing with readline easier.
-        At the moment, it reacts to clicking with the left mouse button by
-        trying to move the text cursor to this position. It does so by
-        generating as many cursor-left or cursor-right keypresses as
-        required (the this only works for programs that correctly support
-        wide characters).
-
-        It only works when clicking into the same line (possibly extended
-        over multiple rows) as the text cursor and on the primary screen, to
-        reduce the risk of misinterpreting. The normal selection isn't
-        disabled, so quick successive clicks might interfere with selection
-        creation in harmless ways.
-
     tabbed
         This transforms the terminal into a tabbar with additional
         terminals, that is, it implements what is commonly refered to as
@@ -796,6 +800,10 @@
         See the description of "urxvt::timer->events". Make sure to always
         restore the previous value.
 
+    $fd = $term->pty_fd
+        Returns the master file descriptor for the pty in use, or -1 if no
+        pty is used.
+
     $windowid = $term->parent
         Return the window id of the toplevel window.
 
@@ -842,6 +850,9 @@
     $screen = $term->current_screen
         Returns the currently displayed screen (0 primary, 1 secondary).
 
+    $cursor_is_hidden = $term->hidden_cursor
+        Returns wether the cursor is currently hidden or not.
+
     $view_start = $term->view_start ([$newvalue])
         Returns the row number of the topmost displayed line. Maximum value
         is 0, which displays the normal terminal contents. Lower values
@@ -868,9 +879,9 @@
 
         $text is in a special encoding: tabs and wide characters that use
         more than one cell when displayed are padded with $urxvt::NOCHAR
-        characters. Characters with combining characters and other
-        characters that do not fit into the normal tetx encoding will be
-        replaced with characters in the private use area.
+        (chr 65535) characters. Characters with combining characters and
+        other characters that do not fit into the normal tetx encoding will
+        be replaced with characters in the private use area.
 
         You have to obey this encoding when changing text. The advantage is
         that "substr" and similar functions work on screen cells and not on