Update base.py

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

- backport the latest version of scrolling

(cherry picked from commit 69618c0d56882ac65594247c5f2d7189ccfa3077)

- merge the safari-related changes to init.js from zzzeeksphinx

(cherry picked from commit a2fc048775e3a9104db20881fa333bd7695d24ff)

relative here

- all new approach which allows the main text to be on the top

- disable the scrolling layout, anchors for code/params are not working,
and the current approach used for sections is not able to work for fine-grained
anchors like these, another approach needs to be taken.

- a rework of doc layout and nav:
  - reduce the real estate for the top nav; move the search box
    into the top yellow box, close in space
  - use a new CSS/js approach such that the top toolbar freezes from
    scrolling at the top of the page.  The left nav scrolls independently
    of the content pane so that the local contents remain visible regardless
    of scrolling.   this approach is disabled on mobile where the dual scrollbars
    may be cumbersome (overall the site is not well designed for mobile).

- 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

sync up some changes for #2604 and #2607 from 0.7.10, 0.8.0b2

sync up 0.8's changelogs with 0.7....

Fix indentation and escape *args and **kwargs

css updates to better work with RTD badge

fix to the changelog system for when there's no change recs in the body

Conflicts:
doc/build/builder/changelog.py

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

- The regexp used by the :func:`.url.make_url` function now parses
ipv6 addresses, e.g. surrounded by brackets. [ticket:2851]

render "backports"/ "forward ports" automatically, only write out
changelog once

Conflicts:
doc/build/changelog/changelog_09.rst

Conflicts:
doc/build/changelog/changelog_07.rst
doc/build/changelog/changelog_08.rst

correct for missing fail() methods which were lost when we removed unittest.TestCase

clean up formatting and other linting issues

Conflicts:
test/ext/test_associationproxy.py

Conflicts:
test/ext/test_associationproxy.py

- this comment is wrong, the method here returns all mapper entities
- use a simple isinstance() check instead of looking for presence of
"primary_entity" flag, that's a little unclear

Fixed bug where list instrumentation would fail to represent a
setslice of ``[0:0]`` correctly, which in particular could occur
when using ``insert(0, item)`` with the association proxy.  Due
to some quirk in Python collections, the issue was much more likely
with Python 3 rather than 2.  Also in 0.8.3, 0.7.11.
[ticket:2807]

Conflicts:
doc/build/changelog/changelog_09.rst

Conflicts:
doc/build/changelog/changelog_08.rst

Fixed regression dating back to 0.7.9 whereby the name of a CTE might
not be properly quoted if it was referred to in multiple FROM clauses.
Also in 0.8.3, 0.7.11. [ticket:2801]

Conflicts:
doc/build/changelog/changelog_09.rst

Conflicts:
doc/build/changelog/changelog_08.rst

Updates to MySQL reserved words for versions 5.5, 5.6, courtesy
Hanno Schlichting.  Also in 0.8.3, 0.7.11.
[ticket:2791]

fix changelog

- Fixed bug in common table expression system where if the CTE were
used only as an ``alias()`` construct, it would not render using the
WITH keyword.
[ticket:2783]

Fixed bug in :class:`.CheckConstraint` DDL where the "quote" flag from a
:class:`.Column` object would not be propagated.  Also in 0.8.3, 0.7.11.
[ticket:2784]

Merge pull request #17 from iElectric/docs/wording_yield_per

wording about supported dialects for Query.yield_per

move to git dotfiles for 0.7 branch

- fix long-outdated documentation for sql_mode/ansiquotes,
closes [ticket:1552]

backport just the test from 0.8 for [ticket:2710].  0.7 doesn't
have this issue as it is a regression from [ticket:2229].

- merge tests cleanup from default

repair order by

- additional test + correction for [ticket:2699]

python2.4

indentation fix

order by...

Fixed bug when a query of the form:
``query(SubClass).options(subqueryload(Baseclass.attrname))``,
where ``SubClass`` is a joined inh of ``BaseClass``,
would fail to apply the ``JOIN`` inside the subquery
on the attribute load, producing a cartesian product.
The populated results still tended to be correct as additional
rows are just ignored, so this issue may be present as a
performance degradation in applications that are
otherwise working correctly. [ticket:2699]

-  Fixed bug in unit of work whereby a joined-inheritance
    subclass could insert the row for the "sub" table
    before the parent table, if the two tables had no
    ForeignKey constraints set up between them. [ticket:2689]
- fixed glitch in assertsql.py regarding CompiledSQL + AllOf +
multiple params

Added support for Postgresql's traditional SUBSTRING
function syntax, renders as "SUBSTRING(x FROM y FOR z)"
when regular ``func.substring()`` is used.
Courtesy Gunnlaugur Por Briem.
[ticket:2676]

print statement !

- Improved the error message emitted when a "backref loop" is detected,
that is when an attribute event triggers a bidirectional
assignment between two other attributes with no end.
This condition can occur not just when an object of the wrong
type is assigned, but also when an attribute is mis-configured
to backref into an existing backref pair.
- A warning is emitted when a MapperProperty is assigned to a mapper
that replaces an existing property, if the properties in question
aren't plain column-based properties.   Replacement of relationship
properties is rarely (ever?) what is intended and usually refers to a
mapper mis-configuration.   This will also warn if a backref configures
itself on top of an existing one in an inheritance relationship
(which is an error in 0.8).
backport for [ticket:2674]

- Fixed an import of "logging" in test_execute which was not
working on some linux platforms.
[ticket:2669]

- repair "map to selectable" example, place a caveat that this isn't
something people should be pursuing

- fix to PDF generation failing totally, latex tools here
are broken but will see if RTD produces a pdf

Added tag rel_0_7_10 for changeset 7b2088b0be45684fb6f40ccff3a0fc5d00e49b2e

- add upload options for GPG

0.7.10

this is 0.7.10

Added a conditional import to the ``gaerdbms`` dialect which attempts
to import rdbms_apiproxy vs. rdbms_googleapi to work
on both dev and production platforms.  Also now honors the
``instance`` attribute.  Courtesy Sean Lynch.  Also backported
enhancements to allow username/password as well as
fixing error code interpretation from 0.8.
[ticket:2649]

Backported adjustment to ``__repr__`` for
:class:`.TypeDecorator` to 0.7, allows :class:`.PickleType`
to produce a clean ``repr()`` to help with Alembic.
[ticket:2594] [ticket:2584]

moderinize ordering list docs [ticket:2557]

Fixed bug where :meth:`.Table.tometadata` would fail if a
:class:`.Column` had both a foreign key as well as an
alternate ".key" name for the column.
[ticket:2643]

Added a py3K conditional around unnecessary .decode()
call in mssql information schema, fixes reflection
in Py3K. [ticket:2638]

remove all specifics from the "supported features" section as this
is not maintainable

recreate some profile results due to the change in #2650

Fixed potential memory leak which could occur if an
arbitrary number of :func:`.sessionmaker` objects
were created.   The anonymous subclass created by
the sessionmaker, when dereferenced, would not be garbage
collected due to remaining class-level references from the
event package.  This issue also applies to any custom system
that made use of ad-hoc subclasses in conjunction with
an event dispatcher. [ticket:2650]

:meth:`.Query.merge_result` can now load rows from an outer join
where an entity may be ``None`` without throwing an error.

[ticket:2640]

- add test_loading from 0.8
- adapt 0.8's system of pre-calcing labels from query entities

happy new year (see #2645)

merge taavi's fix from default

fixing typos in the types docs (see #2639)

docs - missing 'attr' in AssociationProxy join see #2636

More adjustment to this SQLite related issue which was released in
0.7.9, to intercept legacy SQLite quoting characters when reflecting
foreign keys.  In addition to intercepting double quotes, other
quoting characters such as brackets, backticks, and single quotes
are now also intercepted. [ticket:2568]

add a doc for the [ticket:2631] quirk

Fixed bug where using server_onupdate=<FetchedValue|DefaultClause>
without passing the "for_update=True" flag would apply the default
object to the server_default, blowing away whatever was there.
The explicit for_update=True argument shouldn't be needed with this usage
(especially since the documentation shows an example without it being
used) so it is now arranged internally using a copy of the given default
object, if the flag isn't set to what corresponds to that argument.
[ticket:2631]

The Oracle LONG type, while an unbounded text type, does not appear
to use the cx_Oracle.LOB type when result rows are returned,
so the dialect has been repaired to exclude LONG from
having cx_Oracle.LOB filtering applied.
[ticket:2620]

merge dance

Repaired the usage of ``.prepare()`` in conjunction with
cx_Oracle so that a return value of ``False`` will result
in no call to ``connection.commit()``, hence avoiding
"no transaction" errors.   Two-phase transactions have
now been shown to work in a rudimental fashion with
SQLAlchemy and cx_oracle, however are subject to caveats
observed with the driver; check the documentation
for details. [ticket:2611]

should be 'where' not 'filter' #2546

The :class:`.MutableComposite` type did not allow for the
:meth:`.MutableBase.coerce` method to be used, even though
the code seemed to indicate this intent, so this now works
and a brief example is added.  As a side-effect,
the mechanics of this event handler have been changed so that
new :class:`.MutableComposite` types no longer add per-type
global event handlers.  Also in 0.8.0b2.
[ticket:2624]

comment out PDF for now, it sucks

Fixed :meth:`.MetaData.reflect` to correctly use
the given :class:`.Connection`, if given, without
opening a second connection from that connection's
:class:`.Engine`. [ticket:2604]

Fixed bug whereby using "key" with Column
in conjunction with "schema" for the owning
Table would fail to locate result rows due
to the MSSQL dialect's "schema rendering"
logic's failure to take .key into account.
[ticket:2607]

remove some whitespace

update to new doc system

  - [bug] changed the list of cx_oracle types that are
    excluded from the setinputsizes() step to only include
    STRING and UNICODE; CLOB and NCLOB are removed.  This
    is to work around cx_oracle behavior which is broken
    for the executemany() call.  In 0.8, this same change
    is applied however it is also configurable via the
    exclude_setinputsizes argument. [ticket:2561]

- [feature] Added "read_timeout" flag to MySQLdb
    dialect.  [ticket:2554]

- [feature] Added "raise_on_warnings" flag to OurSQL
    dialect.  [ticket:2523]

- jam 0.8's rework of the session tests here so future merges have a chance of working

fix __init__ in the metaclass

- add one more #2583 test to cover the "multiple PK switch" use case

  - [bug] Fixed Session accounting bug whereby replacing
    a deleted object in the identity map with another
    object of the same primary key would raise a
    "conflicting state" error on rollback(),
    if the replaced primary key were established either
    via non-unitofwork-established INSERT statement
    or by primary key switch of another instance.
    [ticket:2583]

Added tag rel_0_7_9 for changeset b26bbaa14e5318140bf463fc1e1a9540e3c65e10

add .txt here

0.7.9

obvious tidy

  - [bug] Fixed bug where reflection of primary key constraint
    would double up columns if the same constraint/table
    existed in multiple schemas.

  - [bug] Fixed bug in over() construct whereby
    passing an empty list for either partition_by
    or order_by, as opposed to None, would fail
    to generate correctly.
    Courtesy Gunnlaugur Por Briem.
    [ticket:2574]

- [bug] Fixed compiler bug whereby using a correlated
    subquery within an ORDER BY would fail to render correctly
    if the stament also used LIMIT/OFFSET, due to mis-rendering
    within the ROW_NUMBER() OVER clause.  Fix courtesy
    sayap [ticket:2538]

add glossary, "release" term

session modernize

- dont talk about metadata.bind
- fix some :func:->:class: declared_attr

- fix empty row insert in fixture, [ticket:2573]

- [feature] Added support for the localtimestamp()
SQL function implemented in SQLite, courtesy
Richard Mitchell.  Added test

Merged in mitchellrj/sqlalchemy (pull request #21)

merge some version of the changes noted in [ticket:2426]

- [bug] Added 'terminating connection' to the list
    of messages we use to detect a disconnect with PG, which
    appears to be present in some versions when the server
    is restarted.  [ticket:2570]

- [bug] Fixed the DropIndex construct to support
    an Index associated with a Table in a remote
    schema. [ticket:2571]

  - [bug] Columns in reflected primary key constraint
    are now returned in the order in which the constraint
    itself defines them, rather than how the table
    orders them.  Courtesy Gunnlaugur Por Briem.
    [ticket:2531].

- upgrade to 0.8's exclusion mechanism for test compatibility