From: Jesse Luehrs <doy@tozt.net>
Date: Fri, 8 May 2009 07:25:47 +0000 (-0500)
Subject: note the caveat about the IO modules and is_class_loaded
X-Git-Tag: 0.84~15
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=9d441c234c34c4ab7f89c490d925ad45dc517541;p=gitmo%2FClass-MOP.git

note the caveat about the IO modules and is_class_loaded
---

diff --git a/lib/Class/MOP.pm b/lib/Class/MOP.pm
index c34ea63..d03cb67 100644
--- a/lib/Class/MOP.pm
+++ b/lib/Class/MOP.pm
@@ -923,7 +923,8 @@ Note that these are all called as B<functions, not methods>.
 
 =item B<Class::MOP::load_class($class_name)>
 
-This will load the specified C<$class_name>. This function can be used
+This will load the specified C<$class_name>, if it is not already
+loaded (as reported by C<is_class_loaded>). This function can be used
 in place of tricks like C<eval "use $module"> or using C<require>
 unconditionally. This will return the metaclass of C<$class_name>.
 
@@ -935,7 +936,9 @@ loaded.
 This does a basic check of the symbol table to try and determine as
 best it can if the C<$class_name> is loaded, it is probably correct
 about 99% of the time, but it can be fooled into reporting false
-positives.
+positives. In particular, loading any of the core L<IO> modules will
+cause most of the rest of the core L<IO> modules to falsely report
+having been loaded, due to the way the base L<IO> module works.
 
 =item B<Class::MOP::get_code_info($code)>