- clean up unicode docs and clarify that client_encoding
at the engine level is not the same thing as at the connect args
level.

- adjustment for ref #3200 as we need an immutabledict() here so
that union() can be called, in the case of a dialect that uses
execution options inside of initialize() (e.g. oursql)

- Fixed "'NoneType' object has no attribute 'concrete'" error
when using :class:`.AbstractConcreteBase` in conjunction with
a subclass that declares ``__abstract__``.
fixes #3185

Conflicts:
test/ext/declarative/test_inheritance.py

- The execution options passed to an :class:`.Engine` either via
:paramref:`.create_engine.execution_options` or
:meth:`.Engine.update_execution_options` are not passed to the
special :class:`.Connection` used to initialize the dialect
within the "first connect" event; dialects will usually
perform their own queries in this phase, and none of the
current available  options should be applied here.  In
particular, the "autocommit" option was causing an attempt to
autocommit within this initial connect which would fail with
an AttributeError due to the non-standard state of the
:class:`.Connection`.
fixes #3200

- rework tests for attached databases into individual tests,
test both memory and file-based
- When selecting from a UNION using an attached database file,
the pysqlite driver reports column names in cursor.description
as 'dbname.tablename.colname', instead of 'tablename.colname' as
it normally does for a UNION (note that it's supposed to just be
'colname' for both, but we work around it).  The column translation
logic here has been adjusted to retrieve the rightmost token, rather
than the second token, so it works in both cases.   Workaround
courtesy Tony Roberts.
fixes #3211

- A revisit to this issue first patched in 0.9.5, apparently
psycopg2's ``.closed`` accessor is not as reliable as we assumed,
so we have added an explicit check for the exception messages
"SSL SYSCALL error: Bad file descriptor" and
"SSL SYSCALL error: EOF detected" when detecting an
is-disconnect scenario.   We will continue to consult psycopg2's
connection.closed as a first check.
fixes #3021

- flake8

- add explicit warning re: polymorphic_on, cascading is not supported
at this time.  ref #3214

- clarify documentation on exists() that it is preferred to be in the
WHERE clause.  fixes #3212

- flake8 all of test/ext/declarative

- these tests don't test anything in SQLAlchemy - from our perpsective,
we need to be in transactions (tested elsewhere) and we need to
emit the correct FOR UPDATE strings (tested elsewhere).  There's nothing
in SQLA to be tested as far as validating that for update causes exceptions
or not, and these tests frequently fail as they are timing sensitive.

- Fixed bug that affected generally the same classes of event
as that of :ticket:`3199`, when the ``named=True`` parameter
would be used.  Some events would fail to register, and others
would not invoke the event arguments correctly, generally in the
case of when an event was "wrapped" for adaption in some other way.
The "named" mechanics have been rearranged to not interfere with
the argument signature expected by internal wrapper functions.
fixes #3197

Conflicts:
test/base/test_events.py
test/orm/test_attributes.py
test/orm/test_events.py

- Fixed an unlikely race condition observed in some exotic end-user
setups, where the attempt to check for "duplicate class name" in
declarative would hit upon a not-totally-cleaned-up weak reference
related to some other class being removed; the check here now ensures
the weakref still references an object before calling upon it further.
fixes #3208

- Fixed bug that affected many classes of event, particularly
ORM events but also engine events, where the usual logic of
"de duplicating" a redundant call to :func:`.event.listen`
with the same arguments would fail, for those events where the
listener function is wrapped.  An assertion would be hit within
registry.py.  This assertion has now been integrated into the
deduplication check, with the added bonus of a simpler means
of checking deduplication across the board.
fixes #3199

Conflicts:
lib/sqlalchemy/event/registry.py
test/base/test_events.py

- not sure what this is testing but remove the self.l that might
be contributing to pypy not cleaning up on this one

Conflicts:
test/orm/test_eager_relations.py

- Fixed the version string detection in the pymssql dialect to
work with Microsoft SQL Azure, which changes the word "SQL Server"
to "SQL Azure".
fixes #3151

- raise from cause here to preserve stack trace

Added EXASolution dialect to documentation

- use compat.u for python3.2, fixes #3198

- fix issue where nose Failure object comes into play here

Conflicts:
lib/sqlalchemy/testing/plugin/noseplugin.py

Updated documenation for engines.rst

Clarified connecting to absolute path for sqlite using Windows.

- Fixed warning that would emit when a complex self-referential
primaryjoin contained functions, while at the same time remote_side
was specified; the warning would suggest setting "remote side".
It now only emits if remote_side isn't present.
fixes #3194

- Fixed bug in ordering list where the order of items would be
thrown off during a collection replace event, if the
reorder_on_append flag were set to True.  The fix ensures that the
ordering list only impacts the list that is explicitly associated
with the object.
fixes #3191

- for whatever reason, Insert.values() with multi values wasn't
in the 0.8 migration, so let's just add that

- add in all the method-chained methods to the parameter descriptions
on select().  improve some descriptions.

- mako_layout isn't used, remove it
- to check for epub look at "builder"

Docs: use the base layout when mako_layout=='epub'

  - https://readthedocs.org/projects/sqlalchemy/downloads/epub/latest/ renders with the full template which is unreadable on e-readers
  - in the makefile the template-variable mako_layout is set for target: epub which makes mako use only the base layout.
  - this is the more elegant solution as proposed to #133

- set flavor to "index" here as MySQL is sending None

- An adjustment to table/index reflection such that if an index
reports a column that isn't found to be present in the table,
a warning is emitted and the column is skipped.  This can occur
for some special system column situations as has been observed
with Oracle. fixes #3180

- backport the expects_warning() context manager from 1.0

- more updates to text docs, literal_column, column etc.  in prep
for ticket 2992.

- walk back these literal SQL lectures into something much more succinct.
the ORM one in particular was really long winded and I don't really care if people
use text() anyway, they'll figure it out ;)

- improve from_statement() doc

- start encouraging the use of text() for injection of string-based SQL
rather than straight strings.  reference #2992

- add a test to events within load to verify something we want
to ensure stays the same on 1.0

- add some more docs to yield_per

- changelog for pr bitbucket:28

add update() support to MutableDict

- changelog for pr bitbucket:27

fix MutableDict.coerce

If a class inherited from MutableDict (say, for instance, to add an update() method), coerce() would give back an instance of MutableDict instead of an instance of the derived class.

- mention that FOUND_ROWS is hardcoded; fixes #3146

- deprecation note regarding resurrect, reference #3171

Add note on begin_nested requiring rollback/commit

Avoid confusion about rollback/commit "must be issued" after
``session.begin_nested()`` --- this might be taken to mean call must be
*added*, but that's only true if not using the return value as a context
manager.

Merge branch 'rel_0_9' of bitbucket.org:zzzeek/sqlalchemy into rel_0_9

Fix doc typo 'conjunection'

Fix copy-paste error in Delete doc

- doc corrections for inline=True

- upgrade the note about inline=True to a warning, and make it clear that
this flag should really be set all the time. ref #3169

- Fixed bug in connection pool logging where the "connection checked out"
debug logging message would not emit if the logging were set up using
``logging.setLevel()``, rather than using the ``echo_pool`` flag.
Tests to assert this logging have been added.  This is a
regression that was introduced in 0.9.0.
fixes #3168

- pep8 cleanup

- changelog for pullreq github:125
- add pg8000 version detection for the "sane multi rowcount" feature

pg8000 now supports sane_multi_rowcount

From pg8000-1.9.14 sane_multi_rowcount is supported so this commit
updates the dialect accordingly.

- mutablemapping adds compiler overhead, so screw it

- TIL that dict.keys() in py3K is not an iterator, it is an iterable
view.  So copy collections.OrderedDict and use MutableMapping to set up
keys, items, values on our own OrderedDict.

- The string keys that are used to determine the columns impacted
for an INSERT or UPDATE are now sorted when they contribute towards
the "compiled cache" cache key.   These keys were previously not
deterministically ordered, meaning the same statement could be
cached multiple times on equivalent keys, costing both in terms of
memory as well as performance.
fixes #3165

- rework documentation for reflection flags, backport from
1.0

- add tests for the savepoint recipe

- rewrite all the sqlite/pysqlite transaction isolation docs

- turn off the testing reaper here, that's the source of the leaks
when we are running with pydist, and even when we are running without it
in fact...

Conflicts:
test/aaa_profiling/test_memusage.py

- take out the iterator approach here as it does not support concurrent access

-Fixed bug where Postgresql JSON type was not able to persist or
otherwise render a SQL NULL column value, rather than a JSON-encoded
``'null'``.  To support this case, changes are as follows:

* The value :func:`.null` can now be specified, which will always
  result in a NULL value resulting in the statement.

* A new parameter :paramref:`.JSON.none_as_null` is added, which
  when True indicates that the Python ``None`` value should be
  peristed as SQL NULL, rather than JSON-encoded ``'null'``.

Retrival of NULL as None is also repaired for DBAPIs other than
psycopg2, namely pg8000.

fixes #3159

- clarify docs that contains_eager() is included in the of_type() system,
fix #2438

fix typo in cascade documentation

- add some docs to try to explain the behavior with MySQL / TIMESTAMP.
ref #3155

- Fixed bug in CTE where ``literal_binds`` compiler argument would not
be always be correctly propagated when one CTE referred to another
aliased CTE in a statement.
Fixes #3154

- update the literal binds section

- workaround removal of nested() in py3k

- ensure all tests are named test_*

- fix unit test affected by #3075

pep8 cleanup

- The exception wrapping system for DBAPI errors can now accommodate
non-standard DBAPI exceptions, such as the psycopg2
TransactionRollbackError.  These exceptions will now be raised
using the closest available subclass in ``sqlalchemy.exc``, in the
case of TransactionRollbackError, ``sqlalchemy.exc.OperationalError``.
fixes #3075

- Fixed 0.9.7 regression caused by :ticket:`3067` in conjunction with
a mis-named unit test such that so-called "schema" types like
:class:`.Boolean` and :class:`.Enum` could no longer be pickled.
fixes #3144

- find the remaining not cleaning up correctly test

fix test ordering issues

- rework the exclusions system to have much better support for compound
rules, better message formatting

- fix whitespace

- restore non_updating_cascade to test_manytomany_nonpassive, but also
add sane_multi_rowcount requirement, as pg8000 doesn't do "multi" row count.

- more pg8000 tests passing

PEP8 tidy of test/orm/test_dynamic.py

Fixes for pg8000 for test/orm/test_dynamic.py

PEP8 tidy of test/orm/test_froms.py

Opened test_self_referential for pg8000

The test orm/test_froms.py test_self_referential works with pg8000 now,
so I've opened it up.

PEP8 tidy for test/orm/test_naturalpks.py

Remove requirement for manytomany_nonpassive

Removed the non_updating_cascade requirement from
test_manytomany_nonpassive. This is because setting
passive_updates=False in a relationship should work on *all* dialects.

PEP8 tidy of test/orm/test_query.py

Conflicts:
test/orm/test_query.py

pg8000 passing test/orm/test_query.py

Conflicts:
test/orm/test_query.py

PEP8 tidy for test/orm/test_transaction.py

Fix support for two phase commit in pg8000 dialect

The postgresql base dialect has problems with two-phase commit because
there isn't a standard way of handling autocommit in DBAPI. This commit
modifies the pg8000 dialect to use the DBAPI tpc extension, which is
supported by pg8000 as of version 1.9.11.

PEP8 tidy for test/orm/test_versioning.py

Fix argument to array() in array._bind_param()

array.__init__() expects a list as its sole parameter but inside _bind_param(), instead of sending a list it's sending each item in the list as a separate argument which is incorrect.

- Fixed bug in :class:`.postgresql.array` object where comparison
to a plain Python list would fail to use the correct array constructor.
Pull request courtesy Andrew.  fixes #3141

- flake8 all of test/dialect/postgresql
- add __backend__ to most tests so that pg8000 can start coming in

- use a variant with expected collation here for mysql

- Added a supported :meth:`.FunctionElement.alias` method to functions,
e.g. the ``func`` construct.  Previously, behavior for this method
was undefined.  The current behavior mimics that of pre-0.9.4,
which is that the function is turned into a single-column FROM
clause with the given alias name, where the column itself is
anonymously named.
fixes #3137

- start 0.9.8

0.9.7

- missing 0.8 change forwards port

spelling

- ticket inline

- update some SQL server tests, support
- add support for IDENTITY INSERT setting for INSERT with inline VALUES