normalize documentation

lib/DBIx/Class/Helper/ResultSet/Shortcut.pm

@@ -154,6 +154,14 @@ calling C<< $rs->count >>.
  # equivalent to...
  $foo_rs->search(undef, { prefetch => 'bar' });
 
+=method results_exist
+
+ my $results_exist = $schema->resultset('Bar')->search({...})->results_exist;
+
+Uses C<EXISTS> SQL function to check if the query would return anything.
+Possibly lighter weight than the much more common C<< foo() if $rs->count >>
+idiom.
+
 =head1 SEE ALSO
 
 This component is actually a number of other components put together.  It will
@@ -198,4 +206,6 @@ C<DBIx::Class::Helper::ResultSet::Shortcut::OrderBy>))
 (inherits from C<DBIx::Class::Helper::ResultSet::Shortcut::Page> and
 L<DBIx::Class::Helper::ResultSet::Shortcut::Rows>)
 
+=item * L<DBIx::Class::Helper::ResultSet::Shortcut::ResultsExist>
+
 =back

lib/DBIx/Class/Helper/ResultSet/Shortcut/ResultsExist.pm

@@ -3,8 +3,6 @@ package DBIx::Class::Helper::ResultSet::Shortcut::ResultsExist;
 use strict;
 use warnings;
 
-# ABSTRACT: Determine if a query would return results
-
 sub results_exist {
    my $self   = shift;
 
@@ -16,24 +14,3 @@ sub results_exist {
 }
 
 1;
-
-=pod
-
-=head1 SYNOPSIS
-
-    my $results_exist  = $schema->resultset('Bar')->search({...})->results_exist;
-
-=head1 DESCRIPTION
-
-This component is a shortcut for the case where you'd like to know whether a
-query might return data, but you don't actually want the overhead of selecting
-and returning columns.  Think of the "SELECT 1 FROM Foo IF ..." type of query.
-
-=head1 METHODS
-
-=head2 results_exist
-
-This method takes no arguments and will return 1 if results exists, 0 if they
-do not.
-
-=cut