--- rxvt-unicode/src/urxvt.pm	2006/01/13 07:03:48	1.93
+++ rxvt-unicode/src/urxvt.pm	2006/01/17 17:01:54	1.98
@@ -68,7 +68,7 @@
 You can look at the source of the selection extension to see more
 interesting uses, such as parsing a line from beginning to end.
 
-This extension also offers the following bindable keyboard command:
+This extension also offers following bindable keyboard commands:
 
 =over 4
 
@@ -164,6 +164,33 @@
 window. Illustrates overwriting the refresh callbacks to create your own
 overlays or changes.
 
+=item selection-pastebin
+
+This is a little rarely useful extension that Uploads the selection as
+textfile to a remote site (or does other things).
+
+It listens to the C<selection-pastebin:remote-pastebin> keyboard command,
+i.e.
+
+   URxvt.keysym.C-M-e: perl:selection-pastebin:remote-pastebin
+
+Pressing this combination runs a command with C<%> replaced by the name of
+the textfile. This command can be set via a resource:
+
+   URxvt.selection-pastebin.cmd: rsync -apP % ruth:/var/www/www.ta-sa.org/files/txt/.
+
+And the default is likely not useful to anybody but the few people around
+here :)
+
+The name of the textfile is the hex encoded md5 sum of the selection, so
+the same content should lead to the same filename.
+
+After a successful upload the selection will be replaced by the text given
+in the C<selection-pastebin-url> resource (again, the % is the placeholder
+for the filename):
+
+   URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
+
 =back
 
 =head1 API DOCUMENTATION
@@ -483,12 +510,6 @@
 
 Messages have a size limit of 1023 bytes currently.
 
-=item $is_safe = urxvt::safe
-
-Returns true when it is safe to do potentially unsafe things, such as
-evaluating perl code specified by the user. This is true when urxvt was
-started setuid or setgid.
-
 =item $time = urxvt::NOW
 
 Returns the "current time" (as per the event loop).
@@ -613,7 +634,7 @@
       open my $fh, "<:raw", $path
          or die "$path: $!";
 
-      my $source = untaint
+      my $source =
          "package $pkg; use strict; use utf8;\n"
          . "use base urxvt::term::extension::;\n"
          . "#line 1 \"$path\"\n{\n"
@@ -1184,7 +1205,7 @@
 
 =item $nrow_plus_saveLines = $term->total_rows
 
-=item $lines_in_scrollback = $term->nsaved
+=item $topmost_scrollback_row = $term->top_row
 
 Return various integers describing terminal characteristics.
 
@@ -1222,8 +1243,8 @@
 
 =item $view_start = $term->view_start ([$newvalue])
 
-Returns the negative row number of the topmost line. Minimum value is
-C<0>, which displays the normal terminal contents. Larger values scroll
+Returns the row number of the topmost displayed line. Maximum value is
+C<0>, which displays the normal terminal contents. Lower values scroll
 this many lines into the scrollback buffer.
 
 =item $term->want_refresh