X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass.pm;h=c3be35063b999d01dbfefa6b219b0c83254c474b;hb=97e130fa48aca5a1255b7014b4cbcb0c30c95328;hp=8cf7971f8f08cc1a964592fa0fd4df61fb4f3e9a;hpb=582fe49d7d17c4d61a1f3d4537ac7746272eec0e;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class.pm b/lib/DBIx/Class.pm index 8cf7971..c3be350 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.08204'; +$VERSION = '0.08241'; $VERSION = eval $VERSION if $VERSION =~ /_/; # numify for warning-free dev releases @@ -40,10 +40,6 @@ BEGIN { # otherwise we are good : 0 , - - # There was a brief period of p5p insanity when $@ was invisible in a DESTROY - INVISIBLE_DOLLAR_AT => ($] >= 5.013001 and $] <= 5.013007) ? 1 : 0, - }; if ($] < 5.009_005) { @@ -62,6 +58,7 @@ use DBIx::Class::Optional::Dependencies; use base qw/DBIx::Class::Componentised DBIx::Class::AccessorGroup/; use DBIx::Class::StartupCheck; +use DBIx::Class::Exception; __PACKAGE__->mk_group_accessors(inherited => '_skip_namespace_frames'); __PACKAGE__->_skip_namespace_frames('^DBIx::Class|^SQL::Abstract|^Try::Tiny|^Class::Accessor::Grouped|^Context::Preserve'); @@ -102,28 +99,67 @@ sub _attr_cache { DBIx::Class - Extensible and flexible object <-> relational mapper. -=head1 GETTING HELP/SUPPORT +=head1 WHERE TO START READING -The community can be found via: +See L for an overview of the exhaustive documentation. +To get the most out of DBIx::Class with the least confusion it is strongly +recommended to read (at the very least) the +L in the order presented there. -=over +=head1 HOW TO GET HELP -=item * Web Site: L +Due to the complexity of its problem domain, DBIx::Class is a relatively +complex framework. After you start using DBIx::Class questions will inevitably +arise. If you are stuck with a problem or have doubts about a particular +approach do not hesitate to contact the community with your questions. The +list below is sorted by "fastest response time": + +=over =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 * gitweb: L +=item * Web Site: L + +=back + +=head1 HOW TO CONTRIBUTE -=item * git: L +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. -=item * twitter L +=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 @@ -215,7 +251,7 @@ Then you can use these classes in your application's code: my $cd = $millennium_cds_rs->next; # SELECT ... FROM cds JOIN artists ... my $cd_artist_name = $cd->artist->name; # Already has the data so no 2nd query - # new() makes a DBIx::Class::Row object but doesnt insert it into the DB. + # new() makes a Result object but doesnt insert it into the DB. # create() is the same as new() then insert(). my $new_cd = $schema->resultset('CD')->new({ title => 'Spoon' }); $new_cd->artist($cd->artist); @@ -261,11 +297,6 @@ 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 WHERE TO GO NEXT - -L lists each task you might want help on, and -the modules where you will find documentation. - =head1 AUTHOR mst: Matt S. Trout @@ -291,6 +322,8 @@ amiri: Amiri Barksdale amoore: Andrew Moore +andrewalker: Andre Walker + andyg: Andy Grundman ank: Andres Kievsky @@ -329,6 +362,8 @@ clkao: CL Kao da5id: David Jack Olrik +davewood: David Schmidt + debolaz: Anders Nor Berle dew: Dan Thomas @@ -381,6 +416,8 @@ jguenther: Justin Guenther jhannah: Jay Hannah +jmac: Jason McIntosh + jnapiorkowski: John Napiorkowski jon: Jon Schutz @@ -405,6 +442,8 @@ michaelr: Michael Reddick milki: Jonathan Chu +mithaldu: Christian Walde + mjemmeson: Michael Jemmeson mstratman: Mark A. Stratman @@ -463,7 +502,7 @@ robkinyon: Rob Kinyon Robert Olson -Roman: Roman Filippov +moltar: Roman Filippov Sadrak: Felix Antonius Wilhelm Ostmann