small docs fixes

version bumped to 0.03000 (not releasing yet)

diff --git a/Changes b/Changes
index 0efe84f..c4438ff 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,5 +1,8 @@
 Revision history for Perl extension DBIx::Class::Schema::Loader
 
+0.03000 Not Yet Released
+        - weakened the circular schema reference
+
 0.02999_10 Mon May 22 18:58:20 UTC 2006
         - a few more small bugfixes
         - more dump/debug improvements

diff --git a/lib/DBIx/Class/Schema/Loader.pm b/lib/DBIx/Class/Schema/Loader.pm
index b7304d7..39e9277 100644 (file)
--- a/lib/DBIx/Class/Schema/Loader.pm
+++ b/lib/DBIx/Class/Schema/Loader.pm
@@ -13,7 +13,7 @@ use Scalar::Util qw/ weaken /;
 # Always remember to do all digits for the version even if they're 0
 # i.e. first release of 0.XX *must* be 0.XX000. This avoids fBSD ports
 # brain damage and presumably various other packaging systems too
-our $VERSION = '0.02999_10';
+our $VERSION = '0.03000';
 
 __PACKAGE__->mk_classaccessor('dump_to_dir');
 __PACKAGE__->mk_classaccessor('loader');
@@ -41,7 +41,9 @@ DBIx::Class::Schema::Loader - Dynamic definition of a DBIx::Class::Schema
   my $schema1 = My::Schema->connect( $dsn, $user, $password, $attrs);
   # -or-
   my $schema1 = "My::Schema"; $schema1->connection(as above);
+
 =head1 DESCRIPTION 
+
 DBIx::Class::Schema::Loader automates the definition of a
 L<DBIx::Class::Schema> by scanning database table definitions and
 setting up the columns and primary keys.
@@ -125,9 +127,7 @@ sub _invoke_loader {
 
 =head2 connection
 
-See L<DBIx::Class::Schema>.  Our local override here is to
-hook in the main functionality of the loader, which occurs at the time
-the connection is specified for a given schema class/object.
+See L<DBIx::Class::Schema>.
 
 =cut
 
@@ -142,9 +142,7 @@ sub connection {
 
 =head2 clone
 
-See L<DBIx::Class::Schema>.  Our local override here is to
-make sure cloned schemas can still be loaded at runtime by
-copying and altering a few things here.
+See L<DBIx::Class::Schema>.
 
 =cut
 
@@ -169,7 +167,8 @@ or any derived schema class will cause all affected schemas to dump
 manual versions of themselves to the named directory when they are
 loaded.  In order to be effective, this must be set before defining a
 connection on this schema class or any derived object (as the loading
-happens at connection time, and only once per class).
+happens as soon as both a connection and loader_options are set, and
+only once per class).
 
 See L<DBIx::Class::Schema::Loader::Base/dump_directory> for more
 details on the dumping mechanism.
@@ -303,12 +302,6 @@ will issue warnings about your usage of deprecated features/methods.
 
 This deprecated method is now roughly an alias for L</loader_options>.
 
-In the past it was a common idiom to invoke this method
-after defining a connection on the schema class.  That usage is now
-deprecated.  The correct way to do things from now forward is to
-always do C<loader_options> on the class before C<connect> or
-C<connection> is invoked on the class or any derived object.
-
 This method *will* dissappear in a future version.
 
 For now, using this method will invoke the legacy behavior for