Nuked FAQ and shifted it the useful bits into Troubleshooting

diff --git a/lib/DBIx/Class/Manual/FAQ.pod b/lib/DBIx/Class/Manual/FAQ.pod
deleted file mode 100644 (file)
index 2ff5e61..0000000
--- a/lib/DBIx/Class/Manual/FAQ.pod
+++ /dev/null
@@ -1,71 +0,0 @@
-=head1 NAME 
-
-DBIx::Class::Manual::FAQ - Frequently asked questions
-
-=head1 GENERAL
-
-=head2 What is the point of this module?  Is it a fork of Class::DBI?
-
-This is an alternative to L<Class::DBI>, intended to provide greater
-functionality and simplicity.
-
-It is inspired by the L<Class::DBI> framework, and provides a compat
-layer to ease porting, but with a resultset-oriented, MI-based
-design that makes extension easier and allows us to support more
-complex relational operations like self-joins, C<DISTINCT>,
-C<GROUP BY>s and more.
-
-=head2 What databases does it support?
-
-At least MSSQL, MySQL, Oracle, PostgreSQL, SQLite and DB2.
-
-=head2 What's the current status of this module?
-
-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.
-
-=head2 Where can I go for support?
-
-  Mailing list: http://lists.rawmode.org/mailman/listinfo/dbix-class/
-
-  SVN: http://dev.catalyst.perl.org/repos/bast/trunk/DBIx-Class/
-
-  Wiki: http://dbix-class.shadowcatsystems.co.uk/
-
-  IRC: irc.perl.org#dbix-class
-
-=head2 Inflating your date/time columns
-
-You can use L<DBIx::Class::InflateColumn> to automatically create
-L<DateTime> objects from your date/time columns. For more information,
-see L<DBIx::Class::InflateColumn>.
-
-=head1 POSTGRESQL-SPECIFIC PROBLEMS
-
-=head2 Can't get last insert ID; inserts with serial primary keys fail
-
-Older L<DBI> and L<DBD::Pg> versions do not handle C<last_insert_id>
-correctly, causing code that uses auto-incrementing primary key
-columns to fail with a message such as:
-
-  Can't get last insert id at /.../DBIx/Class/Row.pm line 95
-
-In particular the RHEL 4 and FC3 Linux distributions both ship with
-combinations of L<DBI> and L<DBD::Pg> modules that do not work
-correctly.
-
-L<DBI> version 1.50 and L<DBD::Pg> 1.43 are known to work.
-
-=head1 SEE ALSO
-
-=over 4
-
-=item L<DBIx::Class::Manual::Intro>
-
-=back
-
-=cut

diff --git a/lib/DBIx/Class/Manual/Troubleshooting.pod b/lib/DBIx/Class/Manual/Troubleshooting.pod
index 6d7dc86..643add5 100644 (file)
--- a/lib/DBIx/Class/Manual/Troubleshooting.pod
+++ b/lib/DBIx/Class/Manual/Troubleshooting.pod
@@ -4,6 +4,10 @@ DBIx::Class::Manual::Troubleshooting - Got a problem? Shoot it.
 
 =head2  "Can't locate storage blabla"
 
+You're trying to make a query on a non-connected schema. Make sure you got
+the current resultset from $schema->resultset('Artist') on a schema object
+you got back from connect().
+
 =head2 Tracing SQL
 
 The C<DBIX_CLASS_STORAGE_DBI_DEBUG> environment variable controls
@@ -23,5 +27,25 @@ Alternatively you can do this with the environment variable too:-
 
   export DBIX_CLASS_STORAGE_DBI_DEBUG="1=/tmp/trace.out"
 
+=head2 Can't locate method result_source_instance
+
+For some reason the table class in question didn't load fully, so the
+ResultSource object for it hasn't been created. Debug this class in
+isolation, then try loading the full schema again.
+
+=head2 Can't get last insert ID under Postgres with serial primary keys
+
+Older L<DBI> and L<DBD::Pg> versions do not handle C<last_insert_id>
+correctly, causing code that uses auto-incrementing primary key
+columns to fail with a message such as:
+
+  Can't get last insert id at /.../DBIx/Class/Row.pm line 95
+
+In particular the RHEL 4 and FC3 Linux distributions both ship with
+combinations of L<DBI> and L<DBD::Pg> modules that do not work
+correctly.
+
+L<DBI> version 1.50 and L<DBD::Pg> 1.43 are known to work.
+
 =cut