2 files changed, 10 insertions, 7 deletions
diff --git a/lib/Sietima/Role/SubscriberOnly.pm b/lib/Sietima/Role/SubscriberOnly.pm
index bf845f7..112f85f 100644
--- a/lib/Sietima/Role/SubscriberOnly.pm
+++ b/lib/Sietima/Role/SubscriberOnly.pm
@@ -36,9 +36,10 @@ C<Sietima::Role::SubscriberOnly::Moderate> >> for useable roles.
 This method will be invoked from L<< C<munge_mail>|Sietima/munge_mail
 >> whenever an email is processed that does not come from one of the
 list's subscribers. This method should return a (possibly empty) list
-of L<< C<Sietima::Message> >> objects, just like C<munge_mail>. It can
-also have side-effects, like forwarding the email to the owner of the
-list.
+of L<< C<Sietima::Message> >> objects, just like C<munge_mail>, for
+example to forward the email to the owner of the list. It can also
+have side-effects, like storing a copy of the message to approve
+later.
 
 =cut
 
diff --git a/lib/Sietima/Role/SubscriberOnly/Moderate.pm b/lib/Sietima/Role/SubscriberOnly/Moderate.pm
index ee8d0c6..b4d144c 100644
--- a/lib/Sietima/Role/SubscriberOnly/Moderate.pm
+++ b/lib/Sietima/Role/SubscriberOnly/Moderate.pm
@@ -70,8 +70,9 @@ sub munge_mail_from_non_subscriber ($self,$mail) {
 
   $sietima->resume($mail_id);
 
-Given an identifier returned when L<storing|Sietima::MailStore/store>
-an email, this method retrieves the email and re-processes it via L<<
+Given the identifier returned when
+L<storing|Sietima::MailStore/store>-ing an email, this method
+retrieves the email and re-processes it via L<<
 C<ignoring_subscriberonly>|Sietima::Role::SubscriberOnly/ignoring_subscriberonly
 >>. This will make sure that the email is not caught again by the
 subscriber-only filter.
@@ -90,8 +91,9 @@ sub resume ($self,$mail_id) {
 
   $sietima->drop($mail_id);
 
-Given an identifier returned when L<storing|Sietima::MailStore/store>
-an email, this method deletes the email from the store.
+Given the identifier returned when
+L<storing|Sietima::MailStore/store>-ing an email, this method deletes
+the email from the store.
 
 =cut