--- rxvt-unicode/src/perl/macosx-clipboard	2011/11/20 11:09:22	1.4
+++ rxvt-unicode/src/perl/macosx-clipboard	2012/09/23 08:03:44	1.9
@@ -23,11 +23,24 @@
 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 # ----------------------------------------------------------------------
 
-# Usage:
+=head1 NAME
 
-# URxvt.perl-ext-common: macosx-clipboard
-# URxvt.keysym.M-c: perl:macosx-clipboard:copy
-# URxvt.keysym.M-v: perl:macosx-clipboard:paste
+macosx-clipboard - Mac OS X clipboard support
+
+=head1 SYNOPSIS
+
+   urxvt -pe macosx-clipboard
+
+=head1 DESCRIPTION
+
+This extension implements commands to interact with the Mac OS X
+clipboard and requires the C<Mac::Pasteboard> module. It is used like
+this:
+
+   URxvt.keysym.M-c: perl:macosx-clipboard:copy
+   URxvt.keysym.M-v: perl:macosx-clipboard:paste
+
+=cut
 
 use Mac::Pasteboard;
 
@@ -45,7 +58,6 @@
 sub paste {
    my ($self) = @_;
 
-   # $str = $pasteboard->stringForType_($type)->UTF8String;
    my $str = $pasteboard->paste;
    utf8::decode $str;
    $self->tt_write ($self->locale_encode ($str));