- update mysql connector python links, #2938

- the pronoun removal commit.   there was only one instance of a
standalone gendered pronoun with a gender-neutral subject, but also
have replaced all occurences of "his/her", "his or her", etc.  The docs have always
strived to account for both genders in any non-specific singular pronoun,
however recent controversy in the community suggests
that a zero-gendered-pronoun policy is probably best going forward.

Conflicts:
doc/build/changelog/migration_08.rst
doc/build/orm/session.rst
examples/nested_sets/nested_sets.py

Conflicts:
doc/build/changelog/changelog_02.rst
doc/build/orm/session.rst
doc/build/orm/tutorial.rst
examples/beaker_caching/advanced.py

css updates to better work with RTD badge

- farm out everthing to do with rtd out to the sqlalchemy.org site

Conflicts:
doc/build/builder/mako.py

- merge udpated sql_mode documentation for [ticket:1552]
- replace misleading mysql-compatibility chart with newer verbiage from 0.7, 0.8 etc.

install updated build system, also disables PDF

Add a hint on the install guide to enable C extensions with pip.

pysqlite doc update

genindex is 100% valid

- rewrite rowcount documentation to be as absolutely clear as possible

Add some `Sphinx` paragraph level versions informations markups,
such as ``.. versionadded::``, ``.. versionchanged::`` and ``.. deprecated::``.

Add some `Sphinx` related version informations paragraph-level markups,
such as ``.. versionaddedd::``, ``.. versionchanged::`` and ``.. deprecated::``.

Add some basic CSS styles for version informations paragraph markups.

Added tag rel_0_6_9 for changeset 80885ab33079a98207b4bf9fd5766fe68462e6a1

0.6.9 release prep

add diana

copyright

- some mysql test tweaks ported from 0.7

- Backported the fix for [ticket:2317] introduced
in 0.7.4, which ensures that the connection
is in a valid state before attempting to call
rollback()/prepare()/release() on savepoint
and two-phase transactions.

add doc for with_lockmode(), [ticket:2412]

mysql connector python 3k is dev status

update the search to call searchindex.js in the latest way
sphinx decides we should be, [ticket:2408]

fix rtd link

integrate new readthedocs/sqla.org doc build

fix the genindex, [ticket:2366]

add a "jinja2 fallback" renderer for render_string(), which is used for the js/css templates
we don't really care about.  not sure if this is going to break again with a newer sphinx
or what, but fixes [ticket:2359] for now.

Added tag 06 for changeset c271d5429705ceb53d3f9cb2929eb23230103409

fix one more

fix .. note::/ ..warning:: directives which no longer consistently
support inline formatting in docutils 0.8

backport [ticket:2269] fix from 0.7

- [bug] Fixed the error formatting raised when
a tuple is inadvertently passed to session.query()
[ticket:2297].

fix typo [ticket:2334]

doc styling rework

add an extra style to help with patches

- [bug] fixed inappropriate evaluation of user-mapped
object in a boolean context within query.get()
[ticket:2310].

  - Cls.column.collate("some collation") now
    works.  [ticket:1776]

  - Fixed bug related to [ticket:2141] whereby the
    same modified index behavior in PG 9 affected
    primary key reflection on a renamed column.
    [ticket:2291].

  - a CREATE TABLE will put the COLLATE option
    after CHARSET, which appears to be part of
    MySQL's arbitrary rules regarding if it will actually
    work or not.  [ticket:2225]

- Fixed bug whereby mapper.order_by attribute would
be ignored in the "inner" query within a
subquery eager load.  [ticket:2287].

improved docs on select_from() [ticket:2274]

  - Adjusted dictlike-polymorphic.py example
    to apply the CAST such that it works on
    PG, other databases.  [ticket:2266]

rollback r990939ba046a, does not apply to 0.6

  - Fixed ReturningResultProxy for zxjdbc dialect.
    [ticket:2272]

  - Fixed bug whereby with_only_columns() method of
    Select would fail if a selectable were passed.
    [ticket:2270].   However, the FROM behavior is
    still incorrect here, so you need 0.7 in
    any case for this use case to be usable.

patch from 0.7:   Adjusted the "importlater" mechanism, which is
used internally to resolve import cycles,
such that the usage of __import__ is completed
when the import of sqlalchemy or sqlalchemy.orm
is done, thereby avoiding any usage of __import__
after the application starts new threads,
fixes [ticket:2279].

add test for [ticket:2260]

fix typo, [ticket:2271]

link date/time classes correctly, helps [ticket:2244]

- document get_bind(), [ticket:1053]
- ensure mapper has "None" default for get_bind()

- Fixed bug where query.join() + aliased=True
from a joined-inh structure to itself on
relationship() with join condition on the child
table would convert the lead entity into the
joined one inappropriately.  [ticket:2234]

Backed out changeset e5737a6d896ba54da07c7ffb0bc56121732ade72 - this only applies to 0.7

- fix annotation for aliased()

- added CURRENT to reserved word list.
[ticket:2212]

- Fixed OurSQL dialect to use ansi-neutral
quote symbol "'" for XA commands instead
of '"'.  [ticket:2186].

- Fixed bug apparent only in Python 3 whereby
sorting of persistent + pending objects during
flush would produce an illegal comparison,
if the persistent object primary key
is not a single integer.  [ticket:2228]

- document query.get(), ObjectDeletedError fully, [ticket:2146]

 - Added an informative error message when
    ForeignKeyConstraint refers to a column name in
    the parent that is not found.
- add tests for [ticket:2226], as if we hit each @declared_attr
directly with obj.__get__(obj, name) instead of using
getattr(cls, name).  Basic inheritance mechanics are improperly
used in this case, so 2226 is invalid.

put a really explicit note about joinedload vs. join, everywhere joinedload() is mentioned

  - Fixed bug whereby the source clause
    used by query.join() would be inconsistent
    if against a column expression that combined
    multiple entities together.  [ticket:2197]

- repaired the oracle.RAW type which did not
generate the correct DDL.  [ticket:2220]
- Fixed bug whereby "warn on unicode" flag
would get set for the String type
when used with certain dialects.  This
bug is not in 0.7.

callcounts being weird

- Fixed bug whereby if a mapped class
redefined __hash__() or __eq__() to something
non-standard, which is a supported use case
as SQLA should never consult these,
the methods would be consulted if the class
was part of a "composite" (i.e. non-single-entity)
result set.  [ticket:2215]

- add a latex Makefile to texinputs that gets copied on latex build,
ensures pdflatex/latex errors are totally ignored
- fix all SQL/code examples in the inherits doc to be within 79 chars.
will need to do this for all the docs to get pdf to not look crappy.
- add an abspath to the "templates" dir, not sure of the rationale
here but is harmless, [ticket:2211]
- integrate pdf build with site-mako build

- The join condition produced by with_parent
as well as when using a "dynamic" relationship
against a parent will generate unique
bindparams, rather than incorrectly repeating
the same bindparam.  [ticket:2207].

merge doc patches from default

- fix pypostgresql typo, [ticket:2185]
- rewrite "getting a session" docs to delineate
all sessionmaker() use cases distinctly
- rewrite "Managing Transactions" doc to spell out
each specific step completely, [ticket:2204]
- add to create_engine() and main "engine" doc
an unambiguous statement that the create_engine()
does not create a connection
- other link fixes
- rewrite "deleting" section so that "deleting from collections"
is separate, well-described, [ticket:2202]
- rephrase "autocommit mode" into its own section, move it down,
put some bold text that you shouldn't be using it.
- simplify the "subtransactions" section and make it local to
"autocommit" since it is utterly unneeded by anybody.
- oracle is not doing 2-phase anytime soon

- fix documentation versions in conf.py, other changes to site layout

  - Fixed subtle bug that caused SQL to blow
    up if: column_property() against subquery +
    joinedload + LIMIT + order by the column
    property() occurred.  [ticket:2188].

  - Fixed a subtle bug involving column
    correspondence in a selectable with the
    same column repeated.   Affects [ticket:2188].

- the "cascade" section of the session doc was totally screwed up, mappings
used the wrong form, example for cascade_backref used the wrong names.
- rewrite relationship cascade_backrefs doc

fix docstring

  - Added ORA-00028 to disconnect codes, use
    cx_oracle _Error.code to get at the code,
    [ticket:2200].

- Repaired the "no statement condition"
assertion in Query which would attempt
to raise if a generative method were called
after from_statement() were called.
[ticket:2199].

Added tag rel_0_6_8 for changeset 99409a9db3fe4d4e97d429ba9a3a6ecc6d130709

style for latest sphinx css

- Fixed bug whereby DATETIME2 type would fail on
the "adapt" step when used in result sets or
bound parameters.  This issue is not in 0.7.
[ticket:2159]

- Fixed bug where transaction-level "deleted"
collection wouldn't be cleared of expunged
states, raising an error if they later
became transient [ticket:2182].

put some variance on this as its a difference between 9 and 60 calls

- Adjusted the __contains__() method of
a RowProxy result row such that no exception
throw is generated internally;
NoSuchColumnError() also will generate its
message regardless of whether or not the column
construct can be coerced to a string.
[ticket:2178].

- Some unit test fixes regarding numeric arrays,
MATCH operator.   A potential floating-point
inaccuracy issue was fixed, and certain tests
of the MATCH operator only execute within an
EN-oriented locale for now.  [ticket:2175].

- Modify the text of the message which occurs
when the "identity" key isn't detected on
flush, to include the common cause that
the Column isn't set up to detect
auto-increment correctly; [ticket:2170].

- Fixed bug affecting PG 9 whereby index reflection
would fail if against a column whose name
had changed.  [ticket:2141].

dont need the DEBUG here messing up the rest of the tests

- Fixed bug whereby mapper mapped to an anonymous
alias would fail if logging were used, due to
unescaped % sign in the alias name.  [ticket:2171]

- Fixed bug in MSSQL dialect whereby the aliasing
applied to a schema-qualified table would leak
into enclosing select statements [ticket:2169].
Merge of r9b3bd0601a85 from default

- merge 00380cf3c304ea7f1c7397f17b828166364c36ac from default
- Fixed bug whereby nesting a label of a select()
with another label in it would produce incorrect
exported columns.   Among other things this would
break an ORM column_property() mapping against
another column_property().  [ticket:2167].

- two fn calls reduced on this for some reason.

-add some annotation regarding [ticket:2153]

- mapper() will ignore non-configured foreign keys
to unrelated tables when determining inherit
condition between parent and child class.
This is equivalent to behavior already
applied to declarative.  [ticket:2153]

- Fixed bug where determination of "self referential"
relationship would fail with no workaround
for joined-inh subclass related to itself,
or joined-inh subclass related to a subclass
of that with no cols in the sub-sub class
in the join condition.  [ticket:2149]

- Fixed the error message emitted for "can't
execute syncrule for destination column 'q';
mapper 'X' does not map this column" to
reference the correct mapper.  [ticket:2163].
- orm/test_sync.py covers orm/sync.py 100%

- Backported 0.7's identity map implementation, which
does not use a mutex around removal.  This as some users
were still getting deadlocks despite the adjustments
in 0.6.7; the 0.7 approach that doesn't use a mutex
does not appear to produce "dictionary changed size"
issues, the original rationale for the mutex.
[ticket:2148]

- a non_primary mapper will inherit the _identity_class
of the primary mapper.  This so that a non_primary
established against a class that's normally in an
inheritance mapping will produce results that are
identity-map compatible with that of the primary
mapper [ticket:2151]

- add failing test for [ticket:2142]

- Fixed bug whereby if FetchedValue was passed
to column server_onupdate, it would not
have its parent "column" assigned, added
test coverage for all column default assignment
patterns.  [ticket:2147]

docuemnt the behavior of get(), part of [ticket:2144]

- Calling query.get() against a column-based entity is
invalid, this condition now raises a deprecation warning.
[ticket:2144]

css fix

merge doc fixes from 0.7

some font changes to match the site style better