[Bast-commits] r6698 - DBIx-Class/0.08/trunk/lib/DBIx/Class

[wintrmute at dev.catalyst.perl.org]

Author: wintrmute
Date: 2009-06-17 08:32:30 +0000 (Wed, 17 Jun 2009)
New Revision: 6698

Modified:
   DBIx-Class/0.08/trunk/lib/DBIx/Class/Schema.pm
Log:
Replace vague language around whether load_classes/namespaces is preferred,
with an explanation that load_namespaces() is generally preferred, and explain
when load_classes is appropriate.

Modified: DBIx-Class/0.08/trunk/lib/DBIx/Class/Schema.pm
===================================================================
--- DBIx-Class/0.08/trunk/lib/DBIx/Class/Schema.pm	2009-06-17 00:31:37 UTC (rev 6697)
+++ DBIx-Class/0.08/trunk/lib/DBIx/Class/Schema.pm	2009-06-17 08:32:30 UTC (rev 6698)
@@ -285,8 +285,10 @@
 
 =back
 
-Alternative method to L</load_namespaces> which you should look at
-using if you can.
+L</load_classes> is an alternative method to L</load_namespaces>, both of
+which serve similar purposes, each with different advantages and disadvantages.
+In the general case you should use L</load_namespaces>, unless you need to
+be able to specify that only specific classes are loaded at runtime.
 
 With no arguments, this method uses L<Module::Find> to find all classes under
 the schema's namespace. Otherwise, this method loads the classes you specify