From: Hans Dieter Pearcey <hdp@weftsoar.net>
Date: Mon, 13 Apr 2009 05:43:13 +0000 (-0400)
Subject: note that role application does not try to save your foot if you shoot at it
X-Git-Tag: 0.75~16
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=d05235e160641093cd46db67f63f55211973811f;p=gitmo%2FMoose.git

note that role application does not try to save your foot if you shoot at it
---

diff --git a/lib/Moose/Meta/Role.pm b/lib/Moose/Meta/Role.pm
index 2c860ec..2ca0c91 100644
--- a/lib/Moose/Meta/Role.pm
+++ b/lib/Moose/Meta/Role.pm
@@ -767,6 +767,10 @@ L<Moose::Meta::Role>, object, a L<Moose::Meta::Class> object, or a
 The options are passed directly to the constructor for the appropriate
 L<Moose::Meta::Role::Application> subclass.
 
+Note that this will apply the role even if the C<$thing> in question already
+C<does> this role.  L<Moose::Util/does_role> is a convenient wrapper for
+finding out if role application is necessary.
+
 =back
 
 =head2 Roles and other roles