Fix some broken links in docs

(cherry picked from commit b1c9b3bd384fc40e1c411abef12eaf04b574612f)

- update oracle JDBC driver URL, fixes #3554

(cherry picked from commit 24dba714cb56e1f5a4dca5453cc5f442e6ee08ab)

Update base.py

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

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

Correcting the Hybrid Property Example

Fixes #3528

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

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

fdb drivers seem to be no longer available

(cherry picked from commit 422fca43f8af1bfba0c2a2d24aa2eca7fc3bd558)

- 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)
(cherry picked from commit 601e16daf30a00dd049507cb8bfa4931013c2e46)

- fix quantize recipe, fixes #3322

- backport the latest version of scrolling

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

Maul the evaulate & friends typo

this is only a small part of the cherry-pick as the docs
have been reorganized since 0.8

(cherry picked from commit 8ae47dc6e0a98b359247040236be0810b9086f40)

Conflicts:
doc/build/changelog/changelog_10.rst
doc/build/changelog/migration_10.rst
lib/sqlalchemy/ext/declarative/base.py

(cherry picked from commit 6e7701d534141ed8c4cba668792f2bb528a5af61)

Conflicts:
doc/build/changelog/changelog_09.rst
lib/sqlalchemy/dialects/postgresql/json.py
lib/sqlalchemy/orm/query.py
lib/sqlalchemy/sql/dml.py
lib/sqlalchemy/sql/elements.py
lib/sqlalchemy/sql/operators.py

Fixed typo
Conflicts:
lib/sqlalchemy/sql/schema.py

Updated documenation for engines.rst

Clarified connecting to absolute path for sqlite using Windows.

- for whatever reason, Insert.values() with multi values wasn't
in the 0.8 migration, so let's just add that

- mako_layout isn't used, remove it
- to check for epub look at "builder"

Docs: use the base layout when mako_layout=='epub'

  - https://readthedocs.org/projects/sqlalchemy/downloads/epub/latest/ renders with the full template which is unreadable on e-readers
  - in the makefile the template-variable mako_layout is set for target: epub which makes mako use only the base layout.
  - this is the more elegant solution as proposed to #133

- clarify docs that contains_eager() is included in the of_type() system,
fix #2438

fix typo in cascade documentation

0.8.7

- backport 0.9-related updates

- ticket inline

- backport #3093 to 0.8, fixes #3093

- need Integer here as #1765 is in 0.9

- Added statement encoding to the "SET IDENTITY_INSERT"
statements which operate when an explicit INSERT is being
interjected into an IDENTITY column, to support non-ascii table
identifiers on drivers such as pyodbc + unix + py2k that don't
support unicode statements.
ref #3091 as this fix is also in that issue's patch, but is
a different issue.

- In the SQL Server pyodbc dialect, repaired the implementation
for the ``description_encoding`` dialect parameter, which when
not explicitly set was preventing  cursor.description from
being parsed correctly in the case of result sets that
contained names in alternate encodings.  This parameter
shouldn't be needed going forward.
fixes #3091

Conflicts:
test/sql/test_unicode.py

- add some order bys

- adjust this to work on PG also

- Fixed bug in :class:`.Enum` and other :class:`.SchemaType`
subclasses where direct association of the type with a
:class:`.MetaData` would lead to a hang when events
(like create events) were emitted on the :class:`.MetaData`.
fixes #3124

Conflicts:
lib/sqlalchemy/sql/sqltypes.py
test/sql/test_types.py

- Fixed a bug within the custom operator plus :meth:`.TypeEngine.with_variant`
system, whereby using a :class:`.TypeDecorator` in conjunction with
variant would fail with an MRO error when a comparison operator was used.
fixes #3102

Conflicts:
lib/sqlalchemy/sql/type_api.py

wrong version number

- MySQL error 2014 "commands out of sync" appears to be raised as a
ProgrammingError, not OperationalError, in modern MySQL-Python versions;
all MySQL error codes that are tested for "is disconnect" are now
checked within OperationalError and ProgrammingError regardless.
fixes #3101

additional version notes

- Fixed bug where column names added to ``mysql_length`` parameter
on an index needed to have the same quoting for quoted names in
order to be recognized.  The fix makes the quotes optional but
also provides the old behavior for backwards compatibility with those
using the workaround.
fixes #3085

- The ``__mapper_args__`` dictionary is copied from a declarative
mixin or abstract class when accessed, so that modifications made
to this dictionary by declarative itself won't conflict with that
of other mappings.  The dictionary is modified regarding the
``version_id_col`` and ``polymorphic_on`` arguments, replacing the
column within with the one that is officially mapped to the local
class/table. fixes #3062

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

- Fixed bug in INSERT..FROM SELECT construct where selecting from a
UNION would wrap the union in an anonymous (e.g. unlabled) subquery.
fixes #3044

- Added the ``hashable=False`` flag to the PG :class:`.HSTORE` type, which
is needed to allow the ORM to skip over trying to "hash" an ORM-mapped
HSTORE column when requesting it in a mixed column/entity list.
Patch courtesy Gunnlaugur Þór Briem.  Fixes #3053

- Fixed bug in subquery eager loading where a long chain of
eager loads across a polymorphic-subclass boundary in conjunction
with polymorphic loading would fail to locate the subclass-link in the
chain, erroring out with a missing property name on an
:class:`.AliasedClass`. fixes #3055
- adjust the test from 1.0/0.9 to not use chained eager load style

- hyperlink all the column operators listed in the ORM tutorial common filter operators section
- add language to MATCH explicitly stating this operator varies by backend and is not available
on SQLite, as the tutorial defaults to SQLite to start with, fix #3059
- on the actual match() documentation fix this up to be more accurate, list some example renderings
for different backends.  again mention SQLite not supported

typo

- add lots more to the profiling section
- add the query profiling recipe, fix it with a stack as we now nest those
calls occasionally
- tabs to spaces

Conflicts:
doc/build/faq.rst

Add note on PostgreSQL config for test runs

Several tests on PostgreSQL depend on English-language text search
config being the default in the test DB. This adds a note about that.

Conflicts:
README.unittests.rst

- Fixed bug in mutable extension where :class:`.MutableDict` did not
report change events for the ``setdefault()`` dictionary operation.
fixes #3051

- add a new FAQ section "performance", put the profiling article there,
move the insert rows article there as well

Posgtresql -> PostgreSQL

changelog for pullreq bitbucket:15

Added optional '=' to MySQL KEY_BLOCK_SIZE regex

Documentation fix-up: "its" vs. "it's"

Removed ungrammatical apostrophes from documentation, replacing
"it's" with "its" where appropriate (but in a few cases with "it is"
when that read better).

While doing that, I also fixed a couple of minor typos etc.
as I noticed them.

- Fixed ORM bug where the :func:`.class_mapper` function would mask
AttributeErrors or KeyErrors that should raise during mapper
configuration due to user errors.  The catch for attribute/keyerror
has been made more specific to not include the configuration step.
fixes #3047

- Fixed bug where :meth:`.Table.update` and :meth:`.Table.delete`
would produce an empty WHERE clause when an empty :func:`.and_()`
or :func:`.or_()` or other blank expression were applied.  This is
now consistent with that of :func:`.select`.
fixes #3045

Fix many typos throughout the codebase
cherry pick of those parts of 1caa7fa which went in without issue
Found using: https://github.com/intgr/topy

- add a note about versioning only applying to flushes

- document that joinedload/eagerload work with of_type() + with_polymoprhic()

Added some links in session docs

0.8.7

- Added a new "disconnect" message "connection has been closed unexpectedly".
This appears to be related to newer versions of SSL.
Pull request courtesy Antti Haapala.

added an SSL related connection error

Fixed bug in example code.

repair erroneous whitespace in autodoc directives, preventing members from
being documented

- add some docs for the instancestate linkage to the inspection system

- reverse order of columns in sample CTEs as this is a UNION and the cols need to line up
- alter this in the unit tests as well as these queries were just copied from the tests
- remove the included_parts.join(parts) from the core CTE doc (also just copied from the
test, where we want to make sure joins don't get screwed up with the CTE) as it doesn't
contribute to the query itself
fixes #3014

0.8.6

this doesnt need sane multi row now...

- revert part of c01558ae7f4a for now as we also test that a DELETE of two rows
where one is to be deleted from ON DELETE CASCADE succeeds; the check here makes that fail.
We will need to add an option to enable/disable this check per mapping, will likely
do this in next version

revert inadvertent pdb

- the rewording of orderinglist docs got committed by accident, finish it up

- Fixed ORM bug where changing the primary key of an object, then marking
it for DELETE would fail to target the correct row for DELETE.
Then to compound matters, basic "number of rows matched" checks were
not being performed.  Both issues are fixed, however note that the
"rows matched" check requires so-called "sane multi-row count"
functionality; the DBAPI's executemany() method must count up the
rows matched by individual statements and SQLAlchemy's dialect must
mark this feature as supported, currently applies to some mysql dialects,
psycopg2, sqlite only. fixes #3006
- Enabled "sane multi-row count" checking for the psycopg2 DBAPI, as
this seems to be supported as of psycopg2 2.0.9.

Conflicts:
test/orm/test_naturalpks.py
test/requirements.py

Added missing text_type requirement to TextTest

- Fixed regression caused by release 0.8.5 / 0.9.3's compatibility
enhancements where index reflection on Postgresql versions specific
to only the 8.1, 8.2 series again
broke, surrounding the ever problematic int2vector type.  While
int2vector supports array operations as of 8.1, apparently it only
supports CAST to a varchar as of 8.3.
fix #3000

- Fixed regression from 0.8.3 as a result of :ticket:`2818`
where :meth:`.Query.exists` wouldn't work on a query that only
had a :meth:`.Query.select_from` entry but no other entities.
re: #2818 fixes #2995

- Adjusted ``setup.py`` file to support the possible future
removal of the ``setuptools.Feature`` extension from setuptools.
If this keyword isn't present, the setup will still succeed
with setuptools rather than falling back to distutils.  C extension
building can be disabled now also by setting the
DISABLE_SQLALCHEMY_CEXT environment variable.  This variable works
whether or not setuptools is even available. fixes #2986
- using platform.python_implementation() in setup.py to detect CPython.
I've tested this function on OSX and linux on Python 2.6 through 3.4,
including 3.1, 3.2, 3.3.
Unfortunately, on OSX + 3.2 only, it seems to segfault.  I've tried
installing 3.2.5 from the python.org .dmg, building it from source,
and also blew away the whole 3.2 directory, something seems to be wrong
with the "platform" module on that platform only, and there's also no
issue on bugs.python.org; however, I'm going with
it anyway. If someone is using 3.2 on OSX they really should be upgrading.
- adjusted the logic for platform_implementation(), apparently "platform"
is there in python 2.5, so we are doing a version check.
Conflicts:
doc/build/intro.rst
setup.py

- reword the paragraph which talks about web framework integration for sessions:

1. fix the typo in the paragraph, fixes #2998
2. as zope-sqlalchemy only provides transaction integration and not session scoping,
dial back the language here as people are probably using scoped_session with pyramid anyway
3. as I'm going to again start recommending people don't cling to flask-sqlalchemy so hard,
take out the word "strongly" from the recommendation.
4. as flask is the only framework I can think of that actually has an explicit SQLAlchemy
layer that handles setting up scoped_session, take out the word "most", now it's "some web frameworks"
(by which it means "only flask...and flask-sqlalchemy is probably not worth using anyway")

fix assertion

- Fixed bug in mutable extension as well as
:func:`.attributes.flag_modified` where the change event would not be
propagated if the attribute had been reassigned to itself.
fixes #2997

Conflicts:
lib/sqlalchemy/orm/state.py
test/orm/test_attributes.py

Add is_ and isnot filter to the tutorial

Most linter complain when comparing with None.

- Improved an error message which would occur if a query() were made
against a non-selectable, such as a :func:`.literal_column`, and then
an attempt was made to use :meth:`.Query.join` such that the "left"
side would be determined as ``None`` and then fail.  This condition
is now detected explicitly.

typo

- fairly epic rework of the cascade documentation

Conflicts:
lib/sqlalchemy/orm/relationships.py

Merge pull request #79 from nibrahim/master

Fixes argument number in docs

merge new links to rel_0_8

cut out the BS as far as MySQLdb urls, put the one url everyone should be using

- Fixed bug in :func:`.tuple_` construct where the "type" of essentially
the first SQL expression would be applied as the "comparison type"
to a compared tuple value; this has the effect in some cases of an
inappropriate "type coersion" occurring, such as when a tuple that
has a mix of String and Binary values improperly coerces target
values to Binary even though that's not what they are on the left
side.  :func:`.tuple_` now expects heterogeneous types within its
list of values.
fixes #2977

Conflicts:
lib/sqlalchemy/sql/elements.py
test/sql/test_operators.py

0.8.6

- Removed stale names from ``sqlalchemy.orm.interfaces.__all__`` and
refreshed with current names, so that an ``import *`` from this
module again works.
fixes #2975

0.8.5

2014

- isolate this failure as only on 0.8, only in py3.3, just comment it out,
not really worth tracking down

- Added an additional message to psycopg2 disconnect detection,
"could not send data to server", which complements the existing
"could not receive data from server" and has been observed by users,
fixes #2936

- add a topological rule here to place PARTITIONS after PARTITION_BY,
for output consistency within the tests as well as in practice

restore check ahead of the lock to avoid locking when not needed

- add improved support here for string parsing of predicates, backport
from 0.9

- Support has been improved for Postgresql reflection behavior on very old
(pre 8.1) versions of Postgresql, and potentially other PG engines
such as Redshift (assuming Redshift reports the version as < 8.1).
The query for "indexes" as well as "primary keys" relies upon inspecting
a so-called "int2vector" datatype, which refuses to coerce to an array
prior to 8.1 causing failures regarding the "ANY()" operator used
in the query.  Extensive googling has located the very hacky, but
recommended-by-PG-core-developer query to use when PG version < 8.1
is in use, so index and primary key constraint reflection now work
on these versions.

Conflicts:
doc/build/changelog/changelog_09.rst
test/dialect/postgresql/test_types.py

- Added new MySQL-specific :class:`.mysql.DATETIME` which includes
fractional seconds support; also added fractional seconds support
to :class:`.mysql.TIMESTAMP`.  DBAPI support is limited, though
fractional seconds are known to be supported by MySQL Connector/Python.
Patch courtesy Geert JM Vanderkelen. #2941

changelog for pullreq 12