X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass.pm;h=ff649a31c82eb34f707f5d9c2a3e494c2c741ed6;hb=d71502b;hp=ef0717dd82cd9bf104c694aae0075e59b223f3a2;hpb=06752a03d716bf4b257c448b07cccae4ca519e13;p=dbsrgits%2FDBIx-Class.git
diff --git a/lib/DBIx/Class.pm b/lib/DBIx/Class.pm
index ef0717d..ff649a3 100644
--- a/lib/DBIx/Class.pm
+++ b/lib/DBIx/Class.pm
@@ -11,7 +11,7 @@ our $VERSION;
# $VERSION declaration must stay up here, ahead of any other package
# declarations, as to not confuse various modules attempting to determine
# this ones version, whether that be s.c.o. or Module::Metadata, etc
-$VERSION = '0.08209';
+$VERSION = '0.08250';
$VERSION = eval $VERSION if $VERSION =~ /_/; # numify for warning-free dev releases
@@ -95,6 +95,10 @@ sub _attr_cache {
1;
+__END__
+
+=encoding UTF-8
+
=head1 NAME
DBIx::Class - Extensible and flexible object <-> relational mapper.
@@ -119,53 +123,28 @@ list below is sorted by "fastest response time":
=item * IRC: irc.perl.org#dbix-class
=for html
-(click for instant chatroom login)
+(click for instant chatroom login)
=item * Mailing list: L
-=item * RT Bug Tracker: L
+=item * RT Bug Tracker: L
-=item * Twitter: L
+=item * Twitter: L
=item * Web Site: L
=back
-=head1 HOW TO CONTRIBUTE
-
-Contributions are always welcome, in all usable forms (we especially
-welcome documentation improvements). The delivery methods include git-
-or unified-diff formatted patches, GitHub pull requests, or plain bug
-reports either via RT or the Mailing list. Contributors are generally
-granted full access to the official repository after their first patch
-passes successful review.
-
-=for comment
-FIXME: Getty, frew and jnap need to get off their asses and finish the contrib section so we can link it here ;)
-
-This project is maintained in a git repository. The code and related tools are
-accessible at the following locations:
-
-=over
-
-=item * official repo: L
-
-=item * official gitweb: L
-
-=item * github mirror: L
-
-=item * authorized committers: L
+=head1 SYNOPSIS
-=item * Travis-CI log: L
+For the very impatient: L
-=for html
-
↪ Stable branch CI status:
+This code in the next step can be generated automatically from an existing
+database, see L from the distribution C.
-=back
+=head2 Schema classes preparation
-=head1 SYNOPSIS
-
-Create a schema class called MyApp/Schema.pm:
+Create a schema class called F:
package MyApp::Schema;
use base qw/DBIx::Class::Schema/;
@@ -175,7 +154,7 @@ Create a schema class called MyApp/Schema.pm:
1;
Create a result class to represent artists, who have many CDs, in
-MyApp/Schema/Result/Artist.pm:
+F:
See L for docs on defining result classes.
@@ -190,7 +169,7 @@ See L for docs on defining result classes.
1;
A result class to represent a CD, which belongs to an artist, in
-MyApp/Schema/Result/CD.pm:
+F:
package MyApp::Schema::Result::CD;
use base qw/DBIx::Class::Core/;
@@ -203,6 +182,8 @@ MyApp/Schema/Result/CD.pm:
1;
+=head2 API usage
+
Then you can use these classes in your application's code:
# Connect to your database.
@@ -271,7 +252,8 @@ that allows abstract encapsulation of database operations. It aims to make
representing queries in your code as perl-ish as possible while still
providing access to as many of the capabilities of the database as possible,
including retrieving related records from multiple tables in a single query,
-JOIN, LEFT JOIN, COUNT, DISTINCT, GROUP BY, ORDER BY and HAVING support.
+C, C, C, C, C, C and
+C support.
DBIx::Class can handle multi-column primary and foreign keys, complex
queries and database-level paging, and does its best to only query the
@@ -284,8 +266,8 @@ and thread-safe out of the box (although
L).
This project is still under rapid development, so large new features may be
-marked EXPERIMENTAL - such APIs are still usable but may have edge bugs.
-Failing test cases are *always* welcome and point releases are put out rapidly
+marked B - such APIs are still usable but may have edge bugs.
+Failing test cases are I welcome and point releases are put out rapidly
as bugs are found and fixed.
We do our best to maintain full backwards compatibility for published
@@ -297,6 +279,38 @@ The test suite is quite substantial, and several developer releases
are generally made to CPAN before the branch for the next release is
merged back to trunk for a major release.
+=head1 HOW TO CONTRIBUTE
+
+Contributions are always welcome, in all usable forms (we especially
+welcome documentation improvements). The delivery methods include git-
+or unified-diff formatted patches, GitHub pull requests, or plain bug
+reports either via RT or the Mailing list. Contributors are generally
+granted full access to the official repository after their first patch
+passes successful review.
+
+=for comment
+FIXME: Getty, frew and jnap need to get off their asses and finish the contrib section so we can link it here ;)
+
+This project is maintained in a git repository. The code and related tools are
+accessible at the following locations:
+
+=over
+
+=item * Official repo: L
+
+=item * Official gitweb: L
+
+=item * GitHub mirror: L
+
+=item * Authorized committers: L
+
+=item * Travis-CI log: L
+
+=for html
+↪ Stable branch CI status:
+
+=back
+
=head1 AUTHOR
mst: Matt S. Trout
@@ -362,8 +376,12 @@ clkao: CL Kao
da5id: David Jack Olrik
+dariusj: Darius Jokilehto
+
davewood: David Schmidt
+daxim: Lars Dɪá´á´á´á´á´¡ 迪ææ¯
+
debolaz: Anders Nor Berle
dew: Dan Thomas
@@ -563,5 +581,3 @@ as listed above.
This library is free software and may be distributed under the same terms
as perl itself.
-
-=cut