Improve Exception::Interface docs.

diff --git a/lib/Catalyst/Exception/Interface.pm b/lib/Catalyst/Exception/Interface.pm
index 10bfc0f..371bfa3 100644 (file)
--- a/lib/Catalyst/Exception/Interface.pm
+++ b/lib/Catalyst/Exception/Interface.pm
@@ -15,7 +15,7 @@ __END__
 
 =head1 NAME
 
-Catalyst::Exception::Interface - Exception for redispatching using $ctx->detach()
+Catalyst::Exception::Interface - Role defining the interface for Catalyst exceptions
 
 =head1 SYNOPSIS
 
@@ -23,15 +23,13 @@ Catalyst::Exception::Interface - Exception for redispatching using $ctx->detach(
    use Moose;
    use namespace::clean -except => 'meta';
 
+   with 'Catalyst::Exception::Interface';
+
    # This comprises the required interface.
    sub as_string { 'the exception text for stringification' }
    sub die { shift; die @_ }
    sub die { shift; die @_ }
 
-   with 'Catalyst::Exception::Interface';
-
-See also L<Catalyst> and L<Catalyst::Exception>.
-
 =head1 DESCRIPTION
 
 This is a role for the required interface for Catalyst exceptions.
@@ -57,6 +55,16 @@ must use L<MooseX::Role::WithOverloading>.
 
 Provided by Moose
 
+=head1 SEE ALSO
+
+=over 4
+
+=item L<Catalyst>
+
+=item L<Catalyst::Exception>
+
+=back
+
 =head1 AUTHORS
 
 Catalyst Contributors, see Catalyst.pm