prefetch docs: prefetch works on all rel types

Update the prefetch docs to state that prefetch works with all
relationship types, where previously it had said that it works with
only belongs_to and has_one.

Also update the subsequent example. The old example was confusing
because it specified two has_many relationships on the same level,
something that DBIC emits a warning about.  That example is replaced
with a CD-centric example that demonstrates how many different
relationship types can be used together in a prefetch, but omits the
multiple has_manys.

Add a warning, example, and explanation of the troubles with using
multiple has_many relations in a prefetch.

The old text incorrectly stated that prefetch will override join and
select attributes. Describe current behavior with examples.

savepoints for SQLite

Another overhaul of transaction/savepoint handling

- Move most of the transaction logic back to ::Storage, only leave
  DBI-specific overrides in ::Storage::DBI
- Fix bug where a nested rollback would destabilize the entire execution
  chain
- Better checks for connectivity/ordering of txn/svp operations
- Make DBIC::Storage::NESTED_ROLLBACK_EXCEPTION a proper exception subclass
- Standardize the txn/svp names - renamed the actual workers
  _dbh_begin_work               to _exec_txn_begin
  _dbh_commit                   to _exec_txn_commit
  _dbh_rollback                 to _exec_txn_rollback
  _svp_[begin|release|rollback] to _exec_svp_[begin|release|rollback]

Cleanup/improve the leaktest a bit

Tweaked example code for having non-db data accessors.

Fix custom-relationships on resultsources with multilevel monikers

Fix stupid optimizer bug with has_many joined over might_have

Drop DBI requirement down to 1.57

SQLite, MySQL, Pg, Oracle, ODBC and Sybase all tested to work

Fix $rs->next when using HRI with right-join-side data injected into main obj

handle BLOB and CLOB columns in WHERE for Oracle

Add retrieve_on_insert column_info flag, to autoretrieve RDBMS-side defaults

Also move the UniqueIdentifier code from insert() to _prefetch_autovalues()
where it makes more logical sense

make a proper storage base class for Firebird

fix some spelling mistakes

support sub-second precision for TIMESTAMPs for Firebird over ODBC

Fix complex limits with subqueries in selectors

(fix both incorrect splitting of the selector list and duplication of binds)

support for DBD::Firebird

Parameterize pagination

Use _is_binary_lob_type to determine datatypes in need of PG bytea binds

Remove use of _resolve_column_info call from _prep_for_execute in NoBindVars

Use the datatype as passed via the bind attribute resolution

Some test fixes and TODOs for older Oracle versions

Refactor/improve support of DBD::Sybase compiled against FreeTDS (mainly MSSQL)

Extend tests for MARs under MSSQL over DBD::Sybase

Consistently use MyApp::Schema throught the documentation

Test for an insane yet valid rel condition with subquery

Merge branch 0.08200_track into master

Consolidate all constants under DBIC::_ENV_, bump n::c breakage to < 5.8.5

Overhaul populate code - fix \[] support and exotic values (arrays, etc.)

In addition cleanup populate() error messages a bit

Comprehensive MSAccess support over both DBD::ODBC and DBD::ADO

Fix/clarify Oracle decision whether to use WhereJoins

Remove the suggestion that 8i supports ANSI but is slow - leave it
as a test only (the docs are confusing enough already)

Fix (and test) quoting with the older style of WhereJoins used by Oracle

Also simplify the join overload process a bit

fix from => $rs->as_query

make the DB2/AS400 storage a subclass of DB2, do RNO detection, fix FetchFirst

Several 5.8.old fixes

* Stop running threading tests on < 5.8.5 - DBD::Pg is *really* unhappy there
* Switch t/55namespaces_cleaned.t to Package::Stash - the hand-written syntax
  breaks 5.8.1 and I'm lazy (and it's an implicit dep anyway)
* Stop auto-cleaning the imports of DBIC::Carp - it segfaults all over the
  place on 5.8.1 (will revisit when I rewrite n::c in pure-perl)

Massive rewrite of bind handling, and overall simplification of ::Storage::DBI

There's no practical way to split this into smaller pieces so here it goes:

Bind attribute handling was badly integrated into dbic almost from the
start. Until now the only information about a value was encoded as the
column name contained as the first element of the bind arrayref. The
column name was then resolved to the proper colinfo (deep in ::Storage::DBI)
and then a match was ran on the datatype to try to find an appropriate
set of bind attributes. Besides being fragile and inefficient, this
method also broke down completely when:
  * No column name could be associated with a bind (arguments to complex
    literal functions)
  * as_query results would encode the column names that can no longer
    be resolved since the inner result sources are no longer visible

To fix this all up and provide more flexibility the standard [ $col => $val ]
was replaced with [ \%args => $val ]. The format of \%args is currently:

  {
    dbd_attrs => '
      If present (in any form) this is what is being passed directly to
      bind_param. Note that different DBD's expect different bind args,
      e.g. DBD::SQLite takes a single numerical type, while DBD::Pg takes
      a hashref if bind options. If this is specified all other bind
      options described below are ignored
    ',
    sqlt_datatype => '
      If present it is used to infer the actual bind attribute by passing
      to $resolved_storage->bind_attribute_by_data_type(). Note that the
      data type is somewhat freeform (hence the sqlt_ prefix) - currently
      drivers are expected to dtrt when given a common datatype name (not
      ideal, but that's what we got at this point). Defaults to the
      "data_type" from the add_columns colinfo.
    ',
    sqlt_size => '
      Currently used to correctly allocate buffers for bind_param_inout().
      Defaults to "size" from the add_columns colinfo, or to a sensible value
      based on the "data_type"
    ',
    dbic_colname => '
      Used to fill in missing sqlt_datatype and sqlt_size attributes (if
      they are explicitly specified they are never overriden). Also used
      by some weird DBDs where the column name should be available at
      bind_param time (hello Oracle).
    ',
  }

For backcompat/convenience the following shortcuts are supported:

  [ $name => $val ] === [ { dbic_colname => $name }, $val ]

  [ \$dt => $val ] === [ { sqlt_datatype => $dt }, $val ]

  [ undef => $val ] === [ {}, $val ]

  ( pending in the next patch: [ $val ] === [ {}, $val ] )

On each passage through the storages (either for execute or for as_query
formatting) the information is filled in whenever available, so that by
the time the final binds_param takes place ::Storage::DBI::_dbi_attrs_for_bind
has all the available information about a particular bind value (no matter
where it came from).

A side efect of this is that as_query now always returns resolved
[ \%args => $val ] forms of bind values (hence the huge amount of test changes
in this patchset). While it should not be a major concern, it could
potentially throw off tests that expect a specific output of as_query. If
this becomes a problem a "compat mode as_query" flag will be introduced asap.

Additional changes in this patchset are:

* The signatures of pretty much the entire execution chain changed. Luckily
  everything that required changing was private. All drivers were adjusted
  appropriately (though something could have been missed). Affected methods
  on ::Storage::DBI are:

  _prep_for_execute
  _dbh_execute
  _execute
  _select_args_to_query
  _max_column_bytesize

  additionally the invocation of _prep_for_execute moved from _dbh_execute
  to _execute, and the return of _select_args also changed

* source_bind_attributes was deprecated. Luckily it was never documented in
  the main documentation. Sadly it was documented in individual storage
  drivers. As such it was necessary to provide a compat shim that would invoke
  the thing if it is detected (with the approproate warning)

* _fix_bind_params was renamed to _format_for_trace

Privatize _sth

Shuffle tests around (no changes)

Correctly select the root source of the inner part of a complex prefetch

Also better diagnostics to aid source mis-application during colinfo
resolution

Stop flooding the console with garbage on pg blob errors

Ditch Carp::Clan for our own thing

Fix syntax error that slipped into 9c1700e3

use relationship bridge consistently w/ many_to_many speak

Delete duplicated test (somehow 1:1 with t/search/subquery.t)

Fix long relationship/column names in oracle for good

Do not pass in the relname as "keyword" anymore - it will interfere
with the aliasing since ::Storage::Oracle and SQLMaker::Oracle will
produce different results

Fixup SQLA monkeypatch in anticipation of new SQLA version

Cleanup that namespacing mess

Remove significance of some test envvars (and add a test to trip up downstream packagers)

Remove test prototype that was never completed further than a loop calling ok(1)

Makes DBICTEST_STORAGE_STRESS redundant

Add startup sanity check of the ::DBI::Replicated method dispatch tables

In order to do this during testing only introduce the ::_ENV_::DBICTEST macro,
and also make sure DBICTest::RunMode is loaded before the macro is set
(therefore the multiple test changes)

Lazily load DBD::Pg in ::Storage::DBI::Pg, only when typing is required

Fixed bug in _strip_cond_qualifiers, patch generously by Grant Street Group.

Fixed: RS example code was broken

cascading delete on a nonexistent relation should warn instead of
dieing uninformatively.

reorganize docs for load_namespaces method

Fix 'exit via next' warning from DBIx::Class::ResultSource::sequence

Make sure the component_class autoloader works across module reloads

(works around corner cases from db29433c)

fixup Firebird ODBC driver for DBD::ODBC 1.29

Switch sql_maker_class and datetime_parser_type to component_class accessors

Switch cursor accessor to CAG's component_class type for autoloading

create file_columns table when DBICTEST_SQLT_DEPLOY env var is not set

Breakage introduced in 123df52

Minor POD spelling and link fixes

* Use proper L<Pod::Name/Section> style, rather than the incorrect
  L<Pod::Name#Section> style (thanks mst)
* Some minor spelling errors picked up by Lintian

Modified: small doc patch explaining a gotcha

Extra test for mysql_auto_reconnect and fork

Lazy-load as many of the non-essential modules as possible

Cleanup C3 handling, require updated Class::C3::Componentised

Fix quote_names assumption of DBD::* availability

Move the test bits related to deprecated IC::File out of the main testschema

Make pg tests cleanup better after themselves

Fix rev_rel_info on prototype sources

Simplify implementation of reverse_relationship_info (no func. changes)
The only difference is getting rid of an arrayref support condition, but
it is not supported at the top level anyway

Temporarily monkeypatch DBD::ADO to fix warnings during global destruction

rewrite SQLAnywhere GUID normalizing as a cursor_class (formerly a _select_args hack)

Refactor UUID generation logic in ::Storage::DBI::UniqueIdentifier

Patch to schema->deploy against a file

Fixes skipped lines when a comment is followed by a statement
Explicitly split on single line comments and not just ;\n
Add some FIXME comments on the state of deploy

use -in SQL::Abstract operator instead of literal 'IN' in cookbook

Display a warning when an ODBC or ADO subclass is not found

Multiple code/test/doc improvements for MSSQL over DBD::ADO

Add extra test blob type

Cleanup/extend blob/clob detection/checks

Use a safer $dbh->get_info

Fix replicated fails introduced with 2b8cc2f2

fixed description to cookbook example

fixed cookbook example

add mailmap for consistency

Add proper DateTime handling to t/52leaks.t

Better exception when things get really really bad with prepare()

add quote_names connect_info option

Fix wrong author email from f92a9d79

Fix broken sections links in POD

Fix for SpeedyCGI and an extensive test of persistent environments (RT#65131)

Ignore to-be-leaktested classdata, instead of forcibly freeing it

Correct Makefile.PL authortests borkage

Fix last-resort error message and do an explicit require (though
it should *not* be necessary people broke it somehow)

Stop eating syntax errors in ODBC drivers

Fix broken select/group bind in Oracle (after 0542ec57 & 4c2b30d6)

Disable default mysql_auto_reconnect for MySQL

improve MSSQL+ODBC initialization, clarify docs on SCOPE_IDENTITY() and dynamic cursors

Release 0.08190

remove mention of name_sep from Schema::Loader doc

update Schema::Loader docs

Merge branch 'people/riba/extrels' into 0.08200_track_do_not_rebase

Rewrite the check for nontrivial joinfree conditions to throw on both new_related and set_from_related