From: Karen Etheridge <ether@cpan.org>
Date: Mon, 18 Jul 2011 17:27:03 +0000 (-0700)
Subject: document shortcomings with inner/augment and MI.
X-Git-Tag: 2.0200~4
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=d01604d87fe22d2c17ce020debd54d32b6aae6e8;p=gitmo%2FMoose.git

document shortcomings with inner/augment and MI.
---

diff --git a/lib/Moose/Manual/MethodModifiers.pod b/lib/Moose/Manual/MethodModifiers.pod
index e32cdc4..15bb438 100644
--- a/lib/Moose/Manual/MethodModifiers.pod
+++ b/lib/Moose/Manual/MethodModifiers.pod
@@ -273,6 +273,13 @@ object is an instance of C<Report::IncomeAndExpenses> then this call is a
 no-op, and just returns false. It's a good idea to always call C<inner()> to
 allow for future subclassing.
 
+=head2 CAVEATS
+
+Inner/augment does not work well with multiple inheritance (that is, a
+sub augmenting one defined in more than one parent), due to how C<inner()>
+looks for implementations in parent classes.
+
+
 =head1 OVERRIDE AND SUPER
 
 Finally, Moose provides some simple sugar for Perl's built-in method