From: Tomas Doran <bobtfish@bobtfish.net>
Date: Thu, 28 Jan 2010 22:53:06 +0000 (+0000)
Subject: Make it clear you should use MRO::Compat not this
X-Git-Tag: 0.22~1
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FClass-C3.git;a=commitdiff_plain;h=a86fb548d54ed12dc56dd68a0838a55b8d26c26d

Make it clear you should use MRO::Compat not this
---

diff --git a/ChangeLog b/ChangeLog
index 40f4b85..48d765e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 Revision history for Perl extension Class::C3.
 
+    - Add note that people should be using MRO::Compat rather than
+      Class::C3 directly.
+
 0.21 Wed, Mar 25, 2009
     - Remove fake Build.PL. Module::Install doesn't support that anymore.
       (Florian Ragwitz)
diff --git a/lib/Class/C3.pm b/lib/Class/C3.pm
index a1fb537..e7c16a0 100644
--- a/lib/Class/C3.pm
+++ b/lib/Class/C3.pm
@@ -227,6 +227,7 @@ Class::C3 - A pragma to use the C3 method resolution order algortihm
 
 =head1 SYNOPSIS
 
+    # NOTE - DO NOT USE Class::C3 directly as a user, use MRO::Compat instead!
     package A;
     use Class::C3;
     sub hello { 'A::hello' }
@@ -270,6 +271,11 @@ Class::C3 - A pragma to use the C3 method resolution order algortihm
 This is pragma to change Perl 5's standard method resolution order from depth-first left-to-right
 (a.k.a - pre-order) to the more sophisticated C3 method resolution order.
 
+B<NOTE:> YOU SHOULD NOT USE THIS MODULE DIRECTLY - The feature provided
+is integrated into perl version >= 5.9.5, and you should use L<MRO::Compat>
+instead, which will use the core implementation in newer perls, but fallback
+to using this implementation on older perls.
+
 =head2 What is C3?
 
 C3 is the name of an algorithm which aims to provide a sane method resolution order under multiple