Add missing disambiguation to non-primary mapper example

The mapping to B over a join defines an alternate primary key
based on all the primary key columns in the join unless we
re-define it explicitly.   Similarly, people expect that
``.id`` looks the same.  make sure these line up with the
old mapping.

Change-Id: I1ab064c57019e79c34293f6588d1e033f7083974
(cherry picked from commit 16f08cbed5ff4f0f0b08dbd0dbd6e49aaee79163)

- remove non-working dialects some of which are 404's
- put the five major dialect names on the front page
- remove old change messages

Change-Id: Ibf1dc2c499f10f98efb6c97d6c53e442e7746200
(cherry picked from commit eae62d00049a24c028ba95e13b5199cfa59a1180)
(cherry picked from commit afed8c2b70f78684b8eb19eefbd3939b5699d4e6)

Rewrite the convert_unicode docs and add tons of dragons

These flags will all be going away as Python 3 has solved
all of this.

Change-Id: I4f581d8dd7826dd823b671d0d8e72250284236c8
(cherry picked from commit 7f12f63c3a8c77715135126aac88ac6055b279c0)

- fix formatting on examples to list the description first, some flake8

Change-Id: I57144a559f20abab02e745d052be5ff84edec7f8
(cherry picked from commit c89729cf67f441359da8289104050b01eb53160b)

All sphinx dependencies move under the github sqlalchemy organization

Change-Id: I7a0dc1ef320b6abad0eeac8b24c20f821e5b8c81
(cherry picked from commit 89f95e9badb260b78a7f1f7487feb6f9811ae06b)

typo

typo

(cherry picked from commit 0a0b36686d5da0e7d04974c8df0ece574b71f3cb)

Move links etc. to github, new alembic links

Change-Id: I59392d355a216ae59552a04c5508f548b901aa7b
(cherry picked from commit 50417cf758508e970f3fccc99af6a501ceac8eb2)
(cherry picked from commit d04575c55467da57ad7091615b313db2486908b6)
(cherry picked from commit fcb4c96cd8d83f31ea86c09c18c075e14d348dd3)
(cherry picked from commit c25af2257f037e5a3b34aa5b79dcbb7f85ebc85d)

- remove @HEAD indicator from docs requirements, fixes #4375

Change-Id: I50b1622c2c2236bf9e436f61c7eea31faaeaa3e1
(cherry picked from commit b5cb68ac432bb7477642305504ddcfdb3edaf87f)

Remove unnecessary unicode and raw string prefix

(cherry picked from commit fc5dbc30168710ef20c467a54610979cd06a58c7)

Fix links and update verbiage for reset_on_return

Change-Id: I642056b78570b44fdefe7f0874a8e4c720389f14
(cherry picked from commit d8bb208a85f6366c58426a85b3d4ec1d6e43ac6c)

Correct for the INSERT statement, typos

Change-Id: I036f3eb9b5e591515920678bc9a76f707fda142c
(cherry picked from commit c85378d9841177b067a93c564edb1787703c6595)

Write a much better section about server defaults

Include information about eager_defaults etc.  These
docs were written before we had all the features
we do now.

Change-Id: Ie62e58c5986698824f717e9f8c802b07a27517d4
Fixes: #4317
(cherry picked from commit 82dfcf43de1d1647306ee2840b79be4f9df7588a)
(cherry picked from commit 47e3f37d904e0e26d0da34fb7fe86f5a35e958db)

Replace 'with' with 'which'

(cherry picked from commit 8601e86f1179d93d5d072c8774bfae41caa8cf56)

- add some context to the declarative section indicating this is not
the introductory material for these topics

Change-Id: I358ba8c32520ce3950a727216bc019e33377e7b9
(cherry picked from commit 284009683d9e48e19cc09e740e7b928c2c02997c)

- fix linking for the query.rst page

Change-Id: I269fdd72e372e1bf4f0f85e9fc8e6938adc4f686
(cherry picked from commit b6fb6f6b60e87d00fcd702b92e883cf3c61d07c6)

- xmin example requires a server default declaration to function
correctly

Change-Id: I1cc50da6fe1c0eeef1d00201b45d998daddfd8ac
(cherry picked from commit a1de76c42f6b64808448aed6e821fbb3b988f99b)

- update alembic link

Change-Id: I5ac6ba8234873fdd19bee6c1decd311a9cb4d55e
(cherry picked from commit 13f9578082ae669734d65a38cb6058e21df88362)

Update tutorial.rst

Fix very minor typo
(cherry picked from commit fc68a7145d086de21005b4ccaa93847d4b889dba)

- default branch rel_0_9

Change-Id: Ib20281d6ea595d6507ec8568b26a0235c88a41a7

Fix typo from "addreses" to "addresses"

(cherry picked from commit c8db0862c102281da617d395b1826ff523af302e)

Fix some broken links in docs

(cherry picked from commit b1c9b3bd384fc40e1c411abef12eaf04b574612f)

- Move review to gerrit.sqlalchemy.org

Change-Id: Id6e9014cfa8ad558b2f3e90815616f9c26dc884d
(cherry picked from commit be7322b3da8e412bd2376c3ce836ead589d1ad31)

- Add a git review file

Change-Id: Ib19e9ee0854f0d123ea625fb976f1a398cf88c87
(cherry picked from commit fdb6ab6a1d5d55d900c388e039835c6433032977)

redundant "using the by changing" -> "using the"
(cherry picked from commit 9bdbf19d54174c1077689bc472dc088c9b06aa24)

ReST fix: missing backtick

Fixes a misrendering at http://docs.sqlalchemy.org/en/latest/dialects/mssql.html#nullability:
(cherry picked from commit e3abb63293be80379d20b4c3f0d1cd093459a9eb)

- backport doc improvements from 31f96c27a5fea302358ba580313a2f742c12b83d re:
isolation_level settings for postgresql, mysql

(cherry picked from commit 49eb39366a0ca54ce973147802864fd7c359adb3)

- add notes for pyodbc limitations with rowcount fixes #3675

(cherry picked from commit 8bc370ed382a45654101fa34bac4a2886ce089c3)

Adds documentation to Query.slice().

(cherry picked from commit 6e5e64e27ef2c6a86c9aebdcefdf2cd726f1476a)

Update cascades.rst
(cherry picked from commit f61194cb865db8b29cc65e47782bb72e54b14ada)

- further edit the unnest() example to suit PG's esoteric requirements
exactly

(cherry picked from commit c97aa63789036fc145503f03123275253ae02d2c)

- use same colname as the alias we give to the PG function
here, fixes #3652

(cherry picked from commit e310a8e423d9a4eeb511b7b84dbeccc90c234a1f)

- add more documentation to MutableDict explaining
that this structure is only intended to track additions
and removals from the dictionary, not recursive tracking
of embedded changes.  fixes #3646.

(cherry picked from commit 5497b1086f9fe44e0594079b036ea939fbc3c479)

- fully hyperlink the docstring for make_transient
- establish make_transient and make_transient_to_detached as special-use,
advanced use only functions
- list all conditions under make_transient() under which an attribute
will not be loaded and establish that make_transient() does not attempt
to load all attributes before detaching the object from its
session, fixes #3640

(cherry picked from commit 7eff4e8f3e3999d9eb914647d8776e6e5b7ee88e)

fix %x string format to compatible with Python 3.5
(cherry picked from commit 4b9f6f407ceedde247982501a6ae406242c80b4a)

fix %x string format to compatible with Python 3.5
(cherry picked from commit 324e532d6081d9b9ea90bf3945cecfc792264f8d)

- restate the "secondary" / AssociationProxy warning more strongly.
references #3638

(cherry picked from commit 67a69da3aa86c8b2b560ed79a9c91408ad704879)

- native unicode expectations are too difficult to maintain
w/ the number of drivers /DBURIs /  python versions

(cherry picked from commit d18d6d9baf4c98c47af70c0a7c796423396a51c1)
(cherry picked from commit 341a52015bad4051ddd01396582488106f826118)

- move out match compiler test to test_compiler
- test_query isn't assertscompiledsql

(cherry picked from commit 269313218ddd06a21387085295c553becbd00e46)
(cherry picked from commit cd3ea1d56bdec8b5b00cd10c5ecc6017bb99bcdd)

- documenation updates to clarify specific SQLite versions
that have problems with right-nested joins and UNION column keys;
references #3633 references #3634.   backport from 1.1 to 0.9
announcing 1.1 as where these behaviors will be retired based
on version-specific checks
- fix test_resultset so that it passes when SQLite 3.10.0 is
present, references #3633

(cherry picked from commit 89fa08792e98b9e31452aa3c949d9b909b10e7cd)

- generalize the verbiage on LargeBinary so that it doesn't
create confusion for inherited classes such as BYTEA, fixes

(cherry picked from commit 47d8858c54401cdf10285b7935049faf87432f55)

- update oracle JDBC driver URL, fixes #3554

(cherry picked from commit 24dba714cb56e1f5a4dca5453cc5f442e6ee08ab)

- 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)