--- rxvt-unicode/src/perl/macosx-clipboard	2009/05/30 08:47:07	1.3
+++ rxvt-unicode/src/perl/macosx-clipboard	2012/06/10 17:39:54	1.7
@@ -3,7 +3,7 @@
 # ----------------------------------------------------------------------
 #  File: macosx-clipboard
 # ----------------------------------------------------------------------
-# 
+#
 # All portions of code are copyright by their respective author/s.
 # Copyright (c) 2006 Samuel Ljungkvist <salj@triplefusion.net>
 #               2009 Reza Jelveh <reza.jelveh@gmail.com>
@@ -23,11 +23,25 @@
 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 # ----------------------------------------------------------------------
 
-# Usage:
+=head1 NAME
+
+   macosx-clipboard and macosx-clipboard-native
+
+=head1 DESCRIPTION
+
+These two modules implement an extended clipboard for Mac OS X. They are
+used like this:
+
+   URxvt.perl-ext-common: default,macosx-clipboard
+   URxvt.keysym.M-c: perl:macosx-clipboard:copy
+   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<macosx-clipboard> requires the
+C<Mac::Pasteboard> module, works with other perls, has fewer bugs, is
+simpler etc. etc.
 
-# URxvt.perl-ext-common: macosx-clipboard
-# URxvt.keysym.M-c: perl:macosx-clipboard:copy
-# URxvt.keysym.M-v: perl:macosx-clipboard:paste
+=cut
 
 use Mac::Pasteboard;
 
@@ -45,7 +59,6 @@
 sub paste {
    my ($self) = @_;
 
-   # $str = $pasteboard->stringForType_($type)->UTF8String;
    my $str = $pasteboard->paste;
    utf8::decode $str;
    $self->tt_write ($self->locale_encode ($str));