From: David Kamholz Date: Tue, 13 Dec 2005 20:54:57 +0000 (+0000) Subject: - add ResultSet to see also in main POD X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=4db53147659188879e74f8add5b8fddb8034d40d;p=dbsrgits%2FDBIx-Class-Historic.git - add ResultSet to see also in main POD - update MANIFEST and README --- diff --git a/MANIFEST b/MANIFEST index 655bea9..879a99f 100644 --- a/MANIFEST +++ b/MANIFEST @@ -68,6 +68,7 @@ README t/02pod.t t/03podcoverage.t t/04dont_break_c3.t +t/18inserterror.t t/19quotes.t t/20setuperrors.t t/basicrels/01core.t diff --git a/README b/README index 4dcaf62..714db98 100644 --- a/README +++ b/README @@ -3,17 +3,17 @@ NAME SYNOPSIS DESCRIPTION - This is a sql to oop mapper, inspired by the Class::DBI framework, and - meant to support compability with it, while restructuring the insides, + This is an SQL to OO mapper, inspired by the Class::DBI framework, and + meant to support compability with it, while restructuring the internals and making it possible to support some new features like self-joins, distinct, group bys and more. - This project is still at an early stage so the maintainers don't make + This project is still at an early stage, so the maintainers don't make any absolute promise that full backwards-compatibility will be - supported; however if we can without compromising the improvements we're - trying to make, we will, and any non-compatible changes will merit a - full justification on the mailing list and a CPAN developer release for - people to test against. + supported; however, if we can without compromising the improvements + we're trying to make, we will, and any non-compatible changes will merit + a full justification on the mailing list and a CPAN developer release + for people to test against. The community can be found via - @@ -27,47 +27,46 @@ DESCRIPTION QUICKSTART If you're using Class::DBI, and want an easy and fast way of migrating - to DBIx::Class look at DBIx::Class::CDBICompat. + to DBIx::Class, take a look at DBIx::Class::CDBICompat. - There are two ways of using DBIx::Class, the 'simple' and the 'schema' - one. - - The 'simple' way of using DBIx::Class needs less classes than the - 'schema' way but doesn't give you the ability to use different database - connections. + There are two ways of using DBIx::Class, the "simple" way and the + "schema" way. The "simple" way of using DBIx::Class needs less classes + than the "schema" way but doesn't give you the ability to easily use + different database connections. Some examples where different database connections are useful are: different users with different rights different databases with the same schema. -Simple - First you need to create a base class all other classes inherit from. - - Look at DBIx::Class::DB how to do this - - Next you need to create a class for every table you want to use with - DBIx::Class. + Simple + First you need to create a base class which all other classes will + inherit from. See DBIx::Class::DB for information on how to do this. - Look at DBIx::Class::Table how to do this. + Then you need to create a class for every table you want to use with + DBIx::Class. See DBIx::Class::Table for information on how to do this. Schema - With this approach the table classes inherit directly from - DBIx::Class::Core, although it might be a good idea to create a 'parent' - class for all table classes which inherits from DBIx::Class::Core and + With this approach, the table classes inherit directly from + DBIx::Class::Core, although it might be a good idea to create a "parent" + class for all table classes that inherits from DBIx::Class::Core and adds additional methods needed by all table classes, e.g. reading a - config file, loading auto primary key support. + config file or loading auto primary key support. - Look at DBIx::Class::Schema how to do this. + Look at DBIx::Class::Schema for information on how to do this. - If you need more hand-holding, check out the introduction in the manual - below. + If you need more help, check out the introduction in the manual below. SEE ALSO - DBIx::Class::Core - DBIC Core Classes - DBIx::Class::CDBICompat - Class::DBI Compat layer. - DBIx::Class::Manual - User's manual. - + DBIx::Class::Core - DBIC Core Classes + DBIx::Class::Manual - User's manual + DBIx::Class::CDBICompat - Class::DBI Compat layer + DBIx::Class::DB - database-level methods + DBIx::Class::Table - table-level methods + DBIx::Class::Row - row-level methods + DBIx::Class::PK - primary key methods + DBIx::Class::ResultSet - search result-set methods + DBIx::Class::Relationship - relationships between tables AUTHOR Matt S. Trout @@ -80,10 +79,14 @@ CONTRIBUTORS Dan Sully - davekam + David Kamholz + + Jules Bean Marcus Ramberg + Paul Makepeace + LICENSE You may distribute this code under the same terms as Perl itself. diff --git a/lib/DBIx/Class.pm b/lib/DBIx/Class.pm index 523c01a..9f02215 100644 --- a/lib/DBIx/Class.pm +++ b/lib/DBIx/Class.pm @@ -90,6 +90,8 @@ manual below. =head2 L - primary key methods +=head2 L - search result-set methods + =head2 L - relationships between tables =head1 AUTHOR