+=head2 HANDLERS
+
+Handlers are used to perform actions on the selected string.
+
+The following handlers are available, defaults in parentheses.
+
+=over
+
+=item B<yank> used to yank (copy) selection to paste buffer (C<\&handler_yank>)
+
+=item B<paste> used to paste selection into window (C<\&handler_paste>)
+
+=item B<url> used to open URLs (e.g. in a browser) (C<\&handler_url>)
+
+=back
+
+Example:
+
+ # Download YouTube videos with a custom wrapper, handle all other URLs
+ # with the default URL handler.
+ $config{handler}{url} = sub {
+ my ($screen, $config, $match) = @_;
+
+ if ($match->{value} =~ m{^https://www.youtube.com/}) {
+ return run_in_background($config, sub {
+ run_command($config, ['youtube-dl-wrapper', $match->{value}]);
+ });
+ }
+ handler_url(@_);
+ };
+
+=cut
+my %handler = (
+ yank => \&handler_yank,
+ paste => \&handler_paste,
+ url => \&handler_url,
+);
+