Extra paragraph dropped from 113e8d16 for some reason
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / Manual / DocMap.pod
index 83c9633..9bd7004 100644 (file)
@@ -26,17 +26,28 @@ DBIx::Class::Manual::DocMap - What documentation do we have?
 
 =head1 Some essential reference documentation
 
+The first two list items are the most important.
+
 =over 4
 
-=item L<DBIx::Class::$resultclass (normally based on DBIx::Class::Core)|DBIx::Class::Manual::ResultClass> - Representing a single result (row) from a DB query
+=item L<DBIx::Class::ResultSet/search> - Selecting and manipulating sets.
+
+The DSL (mini-language) for query composition is only partially explained there,
+see L<SQL::Abstract/WHERE CLAUSES> for the complete details.
+
+=item L< C<$schema>::Result::C<$resultclass>|DBIx::Class::Manual::ResultClass>
+- Classes representing a single result (row) from a DB query.
 
-=item L<DBIx::Class::ResultSet> - Selecting and manipulating sets.
+Such classes normally subclass L<DBIx::Class::Core>, the methods inherited
+from L<DBIx::Class::Row|DBIx::Class::Row/METHODS> and
+L<DBIx::Class::Relationship::Base|DBIx::Class::Relationship::Base/METHODS>
+are used most often.
 
 =item L<DBIx::Class::ResultSetColumn> - Perform operations on a single column of a ResultSet.
 
 =item L<DBIx::Class::ResultSource> - Source/Table definition functions.
 
-=item L<DBIx::Class::Schema> - Overall sourcess, and connection container.
+=item L<DBIx::Class::Schema> - Overall sources, and connection container.
 
 =item L<DBIx::Class::Relationship> - Simple relationship declarations.