--- rxvt-unicode/doc/rxvtperl.3.html	2006/01/16 06:37:51	1.30
+++ rxvt-unicode/doc/rxvtperl.3.html	2006/01/18 09:40:53	1.32
@@ -122,7 +122,7 @@
 interesting uses, such as parsing a line from beginning to end.</p>
 </dd>
 <dd>
-<p>This extension also offers the following bindable keyboard command:</p>
+<p>This extension also offers following bindable keyboard commands:</p>
 </dd>
 <dl>
 <dt><strong><a name="item_rot13">rot13</a></strong><br />
@@ -249,6 +249,48 @@
 window. Illustrates overwriting the refresh callbacks to create your own
 overlays or changes.
 </dd>
+<p></p>
+<dt><strong><a name="item_selection_2dpastebin">selection-pastebin</a></strong><br />
+</dt>
+<dd>
+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
+<em>/tmp</em> directly.).
+</dd>
+<dd>
+<p>It listens to the <code>selection-pastebin:remote-pastebin</code> keyboard command,
+i.e.</p>
+</dd>
+<dd>
+<pre>
+   URxvt.keysym.C-M-e: perl:selection-pastebin:remote-pastebin</pre>
+</dd>
+<dd>
+<p>Pressing this combination runs a command with <code>%</code> replaced by the name of
+the textfile. This command can be set via a resource:</p>
+</dd>
+<dd>
+<pre>
+   URxvt.selection-pastebin.cmd: rsync -apP % ruth:/var/www/www.ta-sa.org/files/txt/.</pre>
+</dd>
+<dd>
+<p>And the default is likely not useful to anybody but the few people around
+here :)</p>
+</dd>
+<dd>
+<p>The name of the textfile is the hex encoded md5 sum of the selection, so
+the same content should lead to the same filename.</p>
+</dd>
+<dd>
+<p>After a successful upload the selection will be replaced by the text given
+in the <code>selection-pastebin-url</code> resource (again, the % is the placeholder
+for the filename):</p>
+</dd>
+<dd>
+<pre>
+   URxvt.selection-pastebin.url: <a href="http://www.ta-sa.org/files/txt/%">http://www.ta-sa.org/files/txt/%</a></pre>
+</dd>
 <p></p></dl>
 <p>
 </p>
@@ -604,14 +646,6 @@
 <p>Messages have a size limit of 1023 bytes currently.</p>
 </dd>
 <p></p>
-<dt><strong><a name="item__24is_safe__3d_urxvt_3a_3asafe">$is_safe = urxvt::safe</a></strong><br />
-</dt>
-<dd>
-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.
-</dd>
-<p></p>
 <dt><strong><a name="item__24time__3d_urxvt_3a_3anow">$time = urxvt::NOW</a></strong><br />
 </dt>
 <dd>