--- rxvt-unicode/src/perl/kuake	2006/07/06 23:48:11	1.1
+++ rxvt-unicode/src/perl/kuake	2012/09/04 22:41:11	1.4
@@ -1,5 +1,30 @@
 #! perl
 
+=head1 NAME
+
+uake<hotkey> - kuake-like hotkey terminal
+
+=head1 DESCRIPTION
+
+A very primitive quake-console-like extension. It was inspired by a
+description of how the programs C<kuake> and C<yakuake> work: Whenever the
+user presses a global accelerator key (by default C<F10>), the terminal
+will show or hide itself. Another press of the accelerator key will hide
+or show it again.
+
+Initially, the window will not be shown when using this extension.
+
+This is useful if you need a single terminal that is not using any desktop
+space most of the time but is quickly available at the press of a key.
+
+The accelerator key is grabbed regardless of any modifiers, so this
+extension will actually grab a physical key just for this function.
+
+If you want a quake-like animation, tell your window manager to do so
+(fvwm can do it).
+
+=cut
+
 sub on_start {
    my ($self) = @_;
 
@@ -26,7 +51,7 @@
    # suppress initial map event
    $self->XUnmapWindow ($self->parent)
       if delete $self->{unmap_me};
-   
+
    ()
 }