From: Matt S Trout <mst@shadowcat.co.uk>
Date: Thu, 5 Jan 2006 15:39:54 +0000 (+0000)
Subject: FAQ and Troubleshooting additions from Nigel Metheringham
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=159a8515db1d0f3c0cc89af5ae811a67985beef5;p=dbsrgits%2FDBIx-Class-Historic.git

FAQ and Troubleshooting additions from Nigel Metheringham
---

diff --git a/lib/DBIx/Class/Manual/FAQ.pod b/lib/DBIx/Class/Manual/FAQ.pod
index 5da03cc..67cdaef 100644
--- a/lib/DBIx/Class/Manual/FAQ.pod
+++ b/lib/DBIx/Class/Manual/FAQ.pod
@@ -2,19 +2,59 @@
 
 DBIx::Class::Manual::FAQ - Frequently Asked Questions
 
-=head1 QUESTIONS 
+=head1 General 
 
 =head2 What is the point of this module? Is it a fork of Class::DBI?
 
+This is an alternative to Class::DBI, intended to provide greater
+functionality and simplicity.
+
+It is 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.
+
 =head2 Who's the intended audience for this module?
 
 =head2 What databases does it support?
 
+At least MSSQL, MySQL, Oracle, PostgreSQL and SQLite.
+
 =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 What's planned in the future?
 
 =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
+
+=head1 PostgresQL Specific Problems
+
+=head2 Can't get last insert id - inserts with serial primary keys fail
+
+Older DBI and DBD::Pg versions fail to correctly 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 DBI and DBD::Pg modules that do not work correctly.
+
+DBI version 1.50 and DBD::Pg 1.43 are known to work.
+
 =cut
 
diff --git a/lib/DBIx/Class/Manual/Troubleshooting.pod b/lib/DBIx/Class/Manual/Troubleshooting.pod
index 5dd88a7..41f55ff 100644
--- a/lib/DBIx/Class/Manual/Troubleshooting.pod
+++ b/lib/DBIx/Class/Manual/Troubleshooting.pod
@@ -4,5 +4,17 @@ DBIx::Class::Manual::Troubleshooting - Got a problem? Shoot it.
 
 =head2  "Can't locate storage blabla"
 
+=head2 Tracing SQL
+
+The C<DBIX_CLASS_STORAGE_DBI_DEBUG> environment variable controls
+SQL tracing, so to see what is happening try
+
+  export DBIX_CLASS_STORAGE_DBI_DEBUG=1
+
+Alternatively use the C<storage->debug> class method:-
+
+  $class->storage->debug(1);
+
+
 =cut