[Bast-commits] r4306 - branches/DBIx-Class-Schema-Loader/current/lib/DBIx/Class/Schema

[ilmari at dev.catalyst.perl.org]

Author: ilmari
Date: 2008-04-29 01:45:58 +0100 (Tue, 29 Apr 2008)
New Revision: 4306

Modified:
   branches/DBIx-Class-Schema-Loader/current/lib/DBIx/Class/Schema/Loader.pm
Log:
Improve method argument and return value docs

Modified: branches/DBIx-Class-Schema-Loader/current/lib/DBIx/Class/Schema/Loader.pm
===================================================================
--- branches/DBIx-Class-Schema-Loader/current/lib/DBIx/Class/Schema/Loader.pm	2008-04-28 18:38:43 UTC (rev 4305)
+++ branches/DBIx-Class-Schema-Loader/current/lib/DBIx/Class/Schema/Loader.pm	2008-04-29 00:45:58 UTC (rev 4306)
@@ -71,6 +71,12 @@
 
 =head2 loader_class
 
+=over 4
+
+=item Argument: $loader_class
+
+=back
+
 Set the loader class to be instantiated when L</connection> is called.
 If the classname starts with "::", "DBIx::Class::Schema::Loader" is
 prepended. Defaults to L<DBIx::Class::Schema/storage_type> (which must
@@ -81,6 +87,12 @@
 
 =head2 loader_options
 
+=over 4
+
+=item Argument: \%loader_options
+
+=back
+
 Example in Synopsis above demonstrates a few common arguments.  For
 detailed information on all of the arguments, most of which are
 only useful in fairly complex scenarios, see the
@@ -132,8 +144,16 @@
 
 =head2 connection
 
-See L<DBIx::Class::Schema> for basic usage.
+=over 4
 
+=item Arguments: @args
+
+=item Return Value: $new_schema
+
+=back
+
+See L<DBIx::Class::Schema/connection> for basic usage.
+
 If the final argument is a hashref, and it contains the keys C<loader_options>
 or C<loader_class>, those keys will be deleted, and their values value will be
 used for the loader options or class, respectively, just as if set via the
@@ -168,7 +188,7 @@
 
 =head2 clone
 
-See L<DBIx::Class::Schema>.
+See L<DBIx::Class::Schema/clone>.
 
 =cut
 
@@ -187,8 +207,12 @@
 
 =head2 dump_to_dir
 
-Argument: directory name.
+=over 4
 
+=item Argument: $directory
+
+=back
+
 Calling this as a class method on either L<DBIx::Class::Schema::Loader>
 or any derived schema class will cause all affected schemas to dump
 manual versions of themselves to the named directory when they are
@@ -253,6 +277,14 @@
 
 =head2 make_schema_at
 
+=over 4
+
+=item Arguments: $schema_name, \%loader_options, \@connect_info
+
+=item Return Value: $schema_name
+
+=back
+
 This simple function allows one to create a Loader-based schema
 in-memory on the fly without any on-disk class files of any
 kind.  When used with the C<dump_directory> option, you can
@@ -302,6 +334,12 @@
 
 =head2 rescan
 
+=over 4
+
+=item Return Value: @new_monikers
+
+=back
+
 Re-scans the database for newly added tables since the initial
 load, and adds them to the schema at runtime, including relationships,
 etc.  Does not process drops or changes.