improve POD

2 files changed, 9 insertions, 8 deletions

diff --git a/README b/README
index 95b819b..711f5f6 100644
--- a/README
+++ b/README
@@ -1,5 +1,6 @@
 NAME
-    MooseX::Privacy - Provides syntax to enable privacy on your methods
+    MooseX::Privacy - Provides the syntax to restrict/control visibility of
+    your methods
 
 SYNOPSIS
       use MooseX::Privacy;
@@ -17,7 +18,7 @@ DESCRIPTION
     your class.
 
   Private
-    When you declare a method as private, the method can be called only
+    When you declare a method as private, this method can be called only
     within the class.
 
         package Foo;
@@ -32,8 +33,8 @@ DESCRIPTION
         $foo->foo;  # ok
 
   Protected
-    When you declare a method as protected, the method can be called only
-    within the class AND any subclasses.
+    When you declare a method as protected, this method can be called only
+    within the class AND any of it's subclasses.
 
         package Foo;
         use Moose;
diff --git a/lib/MooseX/Privacy.pm b/lib/MooseX/Privacy.pm
index cd3d956..55e42c2 100644
--- a/lib/MooseX/Privacy.pm
+++ b/lib/MooseX/Privacy.pm
@@ -34,7 +34,7 @@ __END__
 
 =head1 NAME
 
-MooseX::Privacy - Provides syntax to enable privacy on your methods
+MooseX::Privacy - Provides the syntax to restrict/control visibility of your methods
 
 =head1 SYNOPSIS
 
@@ -55,7 +55,7 @@ class.
 
 =head2 Private
 
-When you declare a method as B<private>, the method can be called only within
+When you declare a method as B<private>, this method can be called only within
 the class.
 
     package Foo;
@@ -71,8 +71,8 @@ the class.
 
 =head2 Protected
 
-When you declare a method as B<protected>, the method can be called only
-within the class AND any subclasses.
+When you declare a method as B<protected>, this method can be called only
+within the class AND any of it's subclasses.
 
     package Foo;
     use Moose;