Restore ability to handle underdefined root (t/prefetch/incomplete.t)
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / Manual.pod
index 8e01396..60cced0 100644 (file)
@@ -1,27 +1,47 @@
-=head1 NAME 
+=head1 NAME
 
 DBIx::Class::Manual - Index of the Manual
 
 =head1 DESCRIPTION
 
-This is the L<DBIx::Class> users manual. DBIx::Class is a SQL->OOP mapper. 
+This is the L<DBIx::Class> users manual. DBIx::Class is a SQL->OOP mapper.
 This means that it can represent your SQL tables as perl classes, and give
 you convenient accessors and methods for retrieving and updating information
 from your SQL database.
 
 =head1 SECTIONS
 
+=head2 L<DBIx::Class::Manual::FAQ>
+
+Short answers and doc pointers to questions.
+
+=head2 L<DBIx::Class::Manual::Glossary>
+
+Explanations of terms used in this documentation.
+
 =head2 L<DBIx::Class::Manual::Intro>
 
-Beginner guide to using DBIx::Class. 
+Beginner guide to using DBIx::Class.
+
+=head2 L<DBIx::Class::Manual::Example>
+
+An example of slightly more complex usage.
+
+=head2 L<DBIx::Class::Manual::Joining>
+
+How to translate known SQL JOINs into DBIx-Class-ish.
 
 =head2 L<DBIx::Class::Manual::Cookbook>
 
-Convenient reciepes for DBIC usage.
+Convenient recipes for DBIC usage.
 
-=head2 L<DBIx::Class::Manual::FAQ>
+=head2 L<DBIx::Class::Manual::Reading>
+
+How to read (and write) the reference documentation.
+
+=head2 L<DBIx::Class::Manual::DocMap>
 
-Frequently asked questions about DBIC.
+Lists of modules by task to help you find the correct document.
 
 =head2 L<DBIx::Class::Manual::Troubleshooting>
 
@@ -32,7 +52,7 @@ documentation. It should behave the same way.
 
 =head2 L<DBIx::Class::Manual::Component>
 
-Listing of existing components, and documentation and example on how to 
+Existing components, and documentation and example on how to
 develop new ones.
 
 =cut