- cross link for concrete helper classes
- remove redundant concrete helper docs from declarative docs,
two places is enough

(cherry picked from commit a53bd6f74b4f41fd04c8cde1f8b58bbb766fe18d)

- typo

- redo the docs for concrete inheritance to more strongly
favor declarative, fixes #2890

(cherry picked from commit 632c4f21fa3cab353b801f585183494c529c6896)

- clarify the "Adding" section also illustrates updates, fixes #2942

(cherry picked from commit 02271efd8976154f855646478b5438db078f7101)

- add a note that the literal_binds flag should be used
when cross-compiling from DDL to SQL, fixes #3615

(cherry picked from commit 165fa15b0f9dbca50539aa7da377c5da5ac0fc79)

- fix People -> Person , fixes #3628

(cherry picked from commit 66560cef7457d69f56cd2ca3bab93cb033a61a84)

- fix some old verbiage that refers to text() as an "implicit" thing
for SQL fragments; we've deprecated that in 1.0 and its a good idea
to document like this for 0.9 as well.

(cherry picked from commit d5d7284bdd0ffc96e7a79354944627cf9b5d8e4d)

- fix link to types in metadata, fixes #3618
- fix "version" got whacked into "f" in core tutorial
- fix short underline in automap
- fix unmatched boldface in session events

(cherry picked from commit d03477d4b761132f44c48417be09d622ad9adfd3)

Update SQLAlchemy-Migrate link to the new repo
(cherry picked from commit 56b76ce7a823a076bd91490f940df95ad409db61)

Fix typo in session docs

(cherry picked from commit bb294497558f96c92253a4a68129a7c7984d3af9)

some spelling fixes

(cherry picked from commit 738d515b95f1ff94d7dfd265883237d247d1c153)

Revert "some spelling fixes" - unfortunately dml.py got whacked / pushed by accident

This reverts commit db706d92ef0e5ebb4c0ba5e7036dc6c0c8f06280.

some spelling fixes

(cherry picked from commit 738d515b95f1ff94d7dfd265883237d247d1c153)

- write a real inline documentation section for from_self(),
building on the example of query.join().  Ideally all the methods
in Query would have this kind of thing.  fixes #3544

(cherry picked from commit 8fa62d652b8d1834e23ba36e56c7bd711cc37e37)

- and NLS_LANG....

(cherry picked from commit 077f26af5f6fefdc98f6720ab5e02b0fad6eff7a)

- add ORACLE_HOME to passenv allowing oracle to work w/ tox 2.0

(cherry picked from commit 7f423e875669ee549b1f53f90d2db340b6c957cd)

Merge remote-tracking branch 'origin/pr/214'

(cherry picked from commit 38e043a475db210143c46588fca70838c9c47c8a)

fix typo: Explcitly -> Explicitly

(cherry picked from commit 887edc431a4c5198bb4f842419d729aed42a6ce8)

- fix ambiguous documentation re: after_flush_postexec(), the
looping nature of it only occurs within the context of a commit.

(cherry picked from commit 5d8bb1f4a65c8932c0dcb39d241b521bd95db681)

- fix broken link to loader behavior

(cherry picked from commit 2d54e3819f34e5f886b8d85f5525b83abdf8bc5a)

- cross-linking for pool recycle feature

(cherry picked from commit 07a199d929aa920b5b2b5d8b2d7008626a731f1f)

- add a JSON warning for coerce_compared_value

(cherry picked from commit 98c1dcc6bcade313a254fe11e8efa3c5b5ad959e)

Link to maintained redshift dialect
(cherry picked from commit e4bfe2aa4b5246207837b0b1c3ac99483e20498b)

- repair laziness about setting time zone here, which is leaking
out depending on connection pool state

(cherry picked from commit 2a8a06e33af60705faf3e7601ec7b3e31e44f8fb)
(cherry picked from commit 48ad282e379d49cf6d6eb97dc0739fa0f29f5464)

Conflicts:
test/dialect/postgresql/test_query.py

Update base.py

Docstring typo keysowrds => keywords
(cherry picked from commit f8eb7c2858443649190b735c587c190ae90b6106)

- add an additional note regarding select_from, fixes #3546

(cherry picked from commit d84dea62de3a9c83ad539a5cf2ff4be2c0685a94)

- remove ambiguous use of the phrase "joined together by AND" as this
may be construed as the Python "and" keyword
- add notes to ORM tutorial for beginners that Python "and" keyword
is not to be used
fixes #3545

(cherry picked from commit ac08920284935e7e7519ce77ba369703390155dc)

- fix incorrect example in inheritance docs

(cherry picked from commit 7eb34baf99179eec966ddd8b3607a6d8cfdfba21)

- add new entry for sharing of Engine across process boundaries

(cherry picked from commit fe41e39b9b776c18a03dde0540a45e1f0100d44b)

- call it deque, since you can really pop from either side

- add a new FAQ recipe for "walk all objects", replacing the need
to use mapper.cascade_iterator() for this purpose as it was not really
designed for that use case.  Add docs to cascade_iterator() pointing
to the recipe.  fixes #3498

(cherry picked from commit 03797b78475bec9fb9c15f8e926414f3720a273c)

Correcting the Hybrid Property Example

Fixes #3528

Signed-off-by: Jason Myers <jason@jasonamyers.com>
Conflicts:
lib/sqlalchemy/ext/hybrid.py

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)