fix typo in session events docs

(cherry picked from commit 2fb3bb31ef897ee48748908524288067c53df4e1)

Minor grammar fix for capitalisation in session docs

(cherry picked from commit 3bd58fac7b607007cb42ab7e41d2e2d01fc390e2)

- update moved link, fixes #3351

(cherry picked from commit 176ac6ab0915f99d378c7d9be67e9c0a73ab1800)

- add new documentation that applies to all modern SQLA versions,
detailing ORM event recipes across the board.

(cherry picked from commit 8be93c23ee566de7cefd7d1b8ef044324132a70f)

Conflicts:
doc/build/orm/events.rst

- add a note about DISTINCT in query w/ ORDER BY, references #3518

(cherry picked from commit 6d0c0994e9a08cf5d149af0314970d5f6e25b159)

- use consistent and descriptive language in all cases
where we refer to the "weak_identity_map" option, and add additional
exposition in the session documentation which refers to it.
fixes #3517

(cherry picked from commit 956907a4b15f6dcc492582a7ad03706ff62d96fb)

Conflicts:
lib/sqlalchemy/orm/identity.py

- reword and update documentation on passive_updates=False; as virtually
all DBs now support ON UPDATE CASCADE other than Oracle, there's no need
to try to reimplement more functionality here and users should be encouraged
to forego natural PKs unless their target platform supports them.
references #2666

(cherry picked from commit d459afa8dbf73b8d9d620d09dede97e3461b6b3f)

- re-document and fully cross link all of configure_mappers(),
mapper_configured(), after_configured(), and before_configured().

(cherry picked from commit 0127ac668e405584d74c92768a9f0dc7913798fe)

- rework the "controlling DDL sequences" documentation to
refer mostly to the DDL object; this system is primarily useful
in that case, and not for built-in objects.  Reference that
the built-in case is not really viable right now. References #3442.

- fix missing ANY symbol

- add tests for InstanceEvents.init, InstanceEvents.init_failure
- ensure that kwargs can be modified in-place within InstanceEvents.init
and that these take effect for the __init__ method.
- improve documentation for these and related events, including
that kwargs can be modified in-place.

(cherry picked from commit b00b430e87512d721ad30c81fdcb35a5253dfc0a)

fix typo int->into
(cherry picked from commit 51870ddaef8abf61ee4c8d6337a72db5395a0a85)

Remove useless code

`to_unicode` variable was created but was not used.
(cherry picked from commit 69fcabb335130bd0f6e9889c5b191c68192559b5)

- add a note clarifying query.with_labels(), fixes #3506

(cherry picked from commit 292f5bec1cbfcaa9d16af8fe4149c7191f194f11)

- Fixed support for cx_Oracle version 5.2, which was tripping
up SQLAlchemy's version detection under Python 3 and inadvertently
not using the correct unicode mode for Python 3.  This would cause
issues such as bound variables mis-interpreted as NULL and rows
silently not being returned.
fixes #3491

(cherry picked from commit d8efa2257ec650b345ec6e840984387263a957a6)

- using text().columns() for ORM matching won't work well
until ticket #3501, so remove this from pre-1.1 tutorials

(cherry picked from commit 7240262adb5d74ec49abdd8561fca58b632c5e8e)

- work to bridge between core/ORM tutorials regarding the text() construct

(cherry picked from commit 4f51fa947ffa0cadeab7ad7dcab649ce3fbcf970)

Conflicts:
doc/build/core/tutorial.rst

- add an example of text.columns
- correct the scalar() example output

- categorize this correctly

- Fixed critical issue whereby the pool "checkout" event handler
may be called against a stale connection without the "connect"
event handler having been called, in the case where the pool
attempted to reconnect after being invalidated and failed; the stale
connection would remain present and would be used on a subsequent
attempt.  This issue has a greater impact in the 1.0 series subsequent
to 1.0.2, as it also delivers a blanked-out ``.info`` dictionary to
the event handler; prior to 1.0.2 the ``.info`` dictionary is still
the previous one.
fixes #3497

(cherry picked from commit 4096ad0f0980f6940be57aaee85791df8f975cd7)

0.9.10

- Fixed bug in SQLite dialect where reflection of UNIQUE constraints
that included non-alphabetic characters in the names, like dots or
spaces, would not be reflected with their name.
fixes #3495

(cherry picked from commit f39e692d1249aeffb4de85987f6a74303fc5dcc5)

Conflicts:
lib/sqlalchemy/dialects/sqlite/base.py

- try to note under insert.values(), if you need
"multiple parameter sets" there is a much more common case
which works equally well for INSERT/UPDATE/DELETE e.g.
executemany().   reference #3476

- add a warning suggesting to use the dictionary form of access
if the name of the attribute being accessed is non-specific,
thereby avoiding collisions on names like items, values, keys.
fixes #3475

(cherry picked from commit 6fcc5d4a07e5c409a7d8438582598d0e90562ea0)

- fix the link here fixes 3473

(cherry picked from commit cf21497f02e64b6ddec82e12a7c26b9476616b00)

Fix code examples in automap's documentation

Fix camelize_classname and pluralize_collection functions as they didn't work as expected.
(cherry picked from commit 5717186122d5538e53205268846beb7143a3d4cc)

- edits to this section

(cherry picked from commit 00656ae4930620bc8c0c4be6a82853f01c90f758)

- add a new FAQ on re-reading of data within a transaction, since
this is definitely something that is asked regularly.

(cherry picked from commit be2b35f7f2156c4b723df9e7be389e6575afedc4)

- more edits, references #3461

(cherry picked from commit 7aa2100db3e6f768a280b4dfdb675d6709f94625)

- fix the bullets
- tone down the "never dispose an engine" language
- refer to NullPool for the "I don't like pooling" use case
references #3461

(cherry picked from commit a1b6e9f324eec04ff69f2ac5347ad3df5b931dd5)

- add explciit section on engine disposal, fixes #3461

(cherry picked from commit 3d78705cf4981e460d6d1b5bb08870286fc3fe93)

- automap is stable

(cherry picked from commit 370b237ddb6af0ba62f0ce5b1bedfe7556c6ccf3)

- add a subsection on how to use Sequence with server_default,
fixes #3453

(cherry picked from commit b861b7537c29349da00793fc828226a68cded62d)

- add an 0.9 migration note regarding TypeEngine's default
constructor removal; fixes #3446

- add a comment, also I think we want to expire before we do the
new begin, as begin_nested() does a flush

(cherry picked from commit 8f1130672d5a54dee311a11041857abfe85aa8a5)

Expire session in testing transaction handling

(cherry picked from commit d1dc39d55d111cdeffa663deec773d8bb67d237e)

- document SQlite dotted name issue, fixes #3441

(cherry picked from commit 4c90f355fd552e70009ffcdf3fdde9f3653e337e)

Update to correct TDS version; FreeTDS only supports up to 7.3. 8.0 is not a valid version (Microsoft released the spec late).

(cherry picked from commit 19571e2f8f4b621f3a1eaea198a8556497178015)

Fix typo in directive
(cherry picked from commit 6245d003f2ce404daedfba9101bb1e4f098b4c66)

Remove spaces around kwargs in metadata.rst

(cherry picked from commit 1bc7881171e02a80bcdb45191be6c6d83b6f01fd)

- break out binary insert against None, disable for freetds for now

(cherry picked from commit 0198d9aa5fee96c7523cc3e827baaba442c0ba02)

- backport no freetds rule

- autopep8

(cherry picked from commit 96f49085b8dd05062b97c4f9c892c071042dad66)

- liberalize list.remove() regexp as recent Pypy versions
format this message differently than cpython

(cherry picked from commit 1bb9c99ea9f3e36e5d4a9f1d4f21f1d0a252db4a)

- document fully how to use autoincrement w/ SQLite including
non-Integer column types, fixes #2075

flake8 some tests

(cherry picked from commit 164f2ad2f433b3d297df709d617a1fc421495921)

Correcting typo in introspection
(cherry picked from commit 9434356da63006b3bfbb7833bb62def4cda17189)

- Added official support for a CTE used by the SELECT present
inside of :meth:`.Insert.from_select`.  This behavior worked
accidentally up until 0.9.9, when it no longer worked due to
unrelated changes as part of :ticket:`3248`.   Note that this
is the rendering of the WITH clause after the INSERT, before the
SELECT; the full functionality of CTEs rendered at the top
level of INSERT, UPDATE, DELETE is a new feature targeted for a
later release.
fixes #3418

(cherry picked from commit eb1bb84fbc10c801c7269a3d38c9e0235327857e)

- plead with RTD to please please use the correct version

(cherry picked from commit 6d7901fa7d3feb5c7894e31a48d249b445557f20)

RTD doesn't seem to want to refresh on a git tag so go back to using
release numbers

- re-tag zzzeeksphinx w/ new version supporting sphinx 1.3

(cherry picked from commit 4f31db82100bee20284d8e9273ac9c6d147a32e3)

- bump zs version due to not yet diagnosed error

(cherry picked from commit ae4c2b6cbee0f993b3937237411df7fb8e66592d)

- fix typo MANYTOONE -> MANYTOMANY, fixes #3415

(cherry picked from commit be81cb200d9efb45c3bf331315c54dff778b5de6)

- Repair _reinstall_default_lookups to also flip the _extended flag
off again so that test fixtures setup/teardown instrumentation as
expected
- clean up test_extendedattr.py and fix it to no longer leak
itself outside by ensuring _reinstall_default_lookups is always called,
part of #3408
- Fixed bug where when using extended attribute instrumentation system,
the correct exception would not be raised when :func:`.class_mapper`
were called with an invalid input that also happened to not
be weak referencable, such as an integer.
fixes #3408

(cherry picked from commit 95949db715ff54be01bfd260a51903ede60597ae)

- Fixed an import that prevented "pypy setup.py test" from working
correctly.
fixes #3406

- Repaired / added to tests yet more expressions that were reported
as failing with the new 'entity' key value added to
:attr:`.Query.column_descriptions`, the logic to discover the "from"
clause is again reworked to accommodate columns from aliased classes,
as well as to report the correct value for the "aliased" flag in these
cases.
fixes #3409

(cherry picked from commit 24d6ea362e757c79b3bada663cf6fc9f262dae4f)

- Fixed regression from 0.9.10 prior to release due to :ticket:`3349`
where the check for query state on :meth:`.Query.update` or
:meth:`.Query.delete` compared the empty tuple to itself using ``is``,
which fails on Pypy to produce ``True`` in this case; this would
erronously emit a warning in 0.9 and raise an exception in 1.0.
fixes #3405

(cherry picked from commit 681276b5b4ae48924c85a1c26af3f9bde3d77b5f)

- Fixed regression from as yet unreleased 0.9.10 where the new addition
of ``entity`` to the :attr:`.Query.column_descriptions` accessor
would fail if the target entity was produced from a core selectable
such as a :class:`.Table` or :class:`.CTE` object.
fixes #3403  references #3320

(cherry picked from commit 20e3df602846bb1d8940b5138f21ef203c99bade)

- add boldface for "viable" plus a note describing that this
refers to the table having a primary key.  fixes #3398

(cherry picked from commit 93b5eae9843d423378f68be928a4f1e6fcacfb87)

Fix typo in 'Relationships API' docs
exprssed -> expressed

(cherry picked from commit da327d0349b2af88700808c8e0041eda4c57882f)

- try pinning a tag here to for RTD to please build correctly

(cherry picked from commit 6833669469b646fbd332b9ce4bd59a1122d3aa99)

- add a warning to SingletonThreadPool that it isn't for general use

(cherry picked from commit 732fb99fc0afbeb69d684b2bfa6d0be6250919a3)

- Added the string value ``"none"`` to those accepted by the
:paramref:`.Pool.reset_on_return` parameter as a synonym for ``None``,
so that string values can be used for all settings, allowing
.ini file utilities like :func:`.engine_from_config` to be usable
without issue.
fixes #3375

(cherry picked from commit c2e3002503242331fc8f2b314e0d4f3c65de9d73)

PEP8 cleanup in /test/aaa_profiling

(cherry picked from commit 45876612d2342250b73a9d3d9afd2bd6008db4c6)

PEP8 cleanup in /test/engine

(cherry picked from commit 0f0e305d25b6da1d42259e53ebd48712dfae5f40)

PEP8 cleanup in /test/sql

(cherry picked from commit e467db9edba1e629ba45704047fa76ecd08922ff)

- adjust for "0"

(cherry picked from commit fc702c9d809878c5a5d85876bfa23e17177940c2)

- remove errant 1.0 migration doc from 0.9 branch

- Fixed issue where a :class:`.MetaData` object that used a naming
convention would not properly work with pickle.  The attribute was
skipped leading to inconsistencies and failures if the unpickled
:class:`.MetaData` object were used to base additional tables
from.
fixes #3362

(cherry picked from commit 55c26710a1f6d6c6f87a9752035bc160f93b38d0)

- add test support for MySQLdb with use_unicode=1 or using mysqlclient on py3k

(cherry picked from commit ffec6ab936a73f5cbe63d9409beb12f1f0307d0b)

- add some teardown for connections that are held open after tests
in some cases, interfering with tests that check pool._refs

(cherry picked from commit 44a9820b4e02f65b3884fa2c016efce9663e4910)

- make sure this is 1.0.0 backported to 0.9

- Fixed a long-standing bug where the :class:`.Enum` type as used
with the psycopg2 dialect in conjunction with non-ascii values
and ``native_enum=False`` would fail to decode return results properly.
This stemmed from when the PG :class:`.postgresql.ENUM` type used
to be a standalone type without a "non native" option.
fixes #3354
cherry pick from ecd7b31d5eaed138e699293719f70260da3c978d

- Fixed bug where the state tracking within multiple, nested
:meth:`.Session.begin_nested` operations would fail to propagate
the "dirty" flag for an object that had been updated within
the inner savepoint, such that if the enclosing savepoint were
rolled back, the object would not be part of the state that was
expired and therefore reverted to its database state.
fixes #3352

(cherry picked from commit 359f471a1203cafd5dc99b5b078ba7d788b67cec)

- :class:`.Query` doesn't support joins, subselects, or special
FROM clauses when using the :meth:`.Query.update` or
:meth:`.Query.delete` methods; instead of silently ignoring these
fields if methods like :meth:`.Query.join` or
:meth:`.Query.select_from` has been called, a warning
is emitted.  In 1.0.0b5 this will raise an error.
Partial cherry pick from 5302bcebb8e18fdad7448ffb60d2a2017eab26c8.
fixes #3349
- don't realy need _no_select_modifiers anymore

Fix typos
agaisnt -> against
'a Alias' -> 'an Alias'

(cherry picked from commit a518b31f3b131ae8304026109cd826e38c2afc26)

fdb drivers seem to be no longer available

(cherry picked from commit 422fca43f8af1bfba0c2a2d24aa2eca7fc3bd558)

- merge recent commits from master which reorganize and
clarify MySQL unicode documentation, bringing it up-to-date
with current DBAPI support

- add a note that we aren't really doing zxjdbc right now even though
these files are present.

(cherry picked from commit ffddfe1b17b5c09dcb6289f807200f7c8279190e)

- Fixed unicode support for PyMySQL when using an "executemany"
operation with unicode parameters.  SQLAlchemy now passes both
the statement as well as the bound parameters as unicode
objects, as PyMySQL generally uses string interpolation
internally to produce the final statement, and in the case of
executemany does the "encode" step only on the final statement.
fixes #3337

(cherry picked from commit dcf5408f7d315b4d9ddec5d0d696eb364d763099)

Conflicts:
lib/sqlalchemy/dialects/mysql/pymysql.py

- changelog for #3333, fixes #3333

(cherry picked from commit 2feb40d0a48dd424c38a37e70a63a6bcf3c00c02)

fix Python 2-specific byte conversion

(cherry picked from commit 00f37f3984c35fc4a2ee5687e798c5ca36953d6c)

- fix typo, fixes #3325

(cherry picked from commit 138293c246fbf8c6693044a89fe788d0d0446113)

- remove now-misleading comment that SQLite doesn't support MATCH,
since they've apparently added something for it

- call this 1.0.0b1

(cherry picked from commit 64b7a50cbd64b44fa8ee8413213e9eae73483515)

- repair forwards-port directives

- Fixed regression from 0.9.9 where the :func:`.as_declarative`
symbol was removed from the ``sqlalchemy.ext.declarative``
namespace.
fixes #3324

- fix quantize recipe, fixes #3322

(cherry picked from commit e42d8184ac087e12e463f938e6a07759cc6392ca)

- try to document how to get columns from constraints.
unfortunately Sphinx refuses to work correctly for the columns
attribute so we just add a lame message to contains_column().

(cherry picked from commit f211ad254d53b85aae319b41cc7b206f3e693660)

0.9.10 bump

- Added a new entry ``"entity"`` to the dictionaries returned by
:attr:`.Query.column_descriptions`.  This refers to the primary ORM
mapped class or aliased class that is referred to by the expression.
Compared to the existing entry for ``"type"``, it will always be
a mapped entity, even if extracted from a column expression, or
None if the given expression is a pure core expression.
references #3320

(cherry picked from commit b815e9483319b93f98bef11c7d47378441f78d21)

- feature, not enhancement

- 0.9.9

- copyright 2015

- repair doclevel

- changelog and docs for pullreq bitbucket:45

(cherry picked from commit 5d1206c10a96b6685e57baa9ae09f04f00cf425b)

Conflicts:
lib/sqlalchemy/dialects/postgresql/base.py

Dialect option `postgresql_concurrently` to `Index` construct.

(cherry picked from commit 955576fcf6e7aff7fe924ec3b33bb6d243ddd312)

- changelog for pr github:154

(cherry picked from commit 78874d3679fe45275d44dda40f4f1bae9a0558b7)

Fix slice addressing of _AssociationList with python3

(cherry picked from commit 9fee9cb87e0d13db4426664f5758c1ddad0533e3)

- changelog / doc for sqlite partial indexes

(cherry picked from commit 6ac0555eaa6363ac9d0ad6566248dd294ad61d9e)

Test for partial index support in sqlite dialects.

(cherry picked from commit 4a42bd5a2cba23782df7b6f98cadb7382d22498e)