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

intall new build system, also disables PDF

genindex is 100% valid

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

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

Add some basic CSS styles for version informations paragraph markups.

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

fix link

integrate new readthedocs/sqla.org doc build

fix the genindex, [ticket:2366]

implement jinja2 fallback for .js, .css files, [ticket:2359]

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

- updates to work with the latest sphinx

timings should use getitem and not the slow getattr

  - Removed "None" from a connection.execute() in the dialect
      which potentially allows pygresql to work as an alternate
      DBAPI (but this is *not supported!!!*) [ticket:1691]

- backported collate reflection fix from [ticket:1655]

merge r6703 of trunk fixes [ticket:1661]

fix flag name

Fix #1663 on 0.5.x: the whitespace after DEFAULT may start with a newline

Fix #1582, backporting [6257]: handle spurious spaces reflecting default values on Firebird

clarify shallow copy

doc patch from [ticket:1651]

0.5.8

this definitely has to go - theres bugs in merge(), serialization which
prevent it from being useful.   will have a much more comprehensive example in
0.6.

new example - apply Beaker caching to a relation().

- Default generators like Sequence() translate correctly
across a copy() operation.

- Sequence() and other DefaultGenerator objects are accepted
as the value for the "default" and "onupdate" keyword
arguments of Column, in addition to being accepted
positionally.

- merge of trunk r6611
- Fixed a column arithmetic bug that affected column
correspondence for cloned selectables which contain
free-standing column expressions.   This bug is
generally only noticeable when exercising newer
ORM behavior only availble in 0.6 via [ticket:1568],
but is more correct at the SQL expression level
as well. [ticket:1617]

- The copy() method on Column now supports uninitialized,
unnamed Column objects. This allows easy creation of
declarative helpers which place common columns on multiple
subclasses.

formatting fix

some compile docs

dont crack up on entirely unsupported types

make sure the native pg types work too

Annotate #1646 fix

Recognize more Firebird disconnection cases, fixing #1646 on 0.5.x

- The extract() function, which was slightly improved in
0.5.7, needed a lot more work to generate the correct
typecast (the typecasts appear to be necessary in PG's
EXTRACT quite a lot of the time).  The typecast is
now generated using a rule dictionary based
on PG's documentation for date/time/interval arithmetic.
It also accepts text() constructs again, which was broken
in 0.5.7. [ticket:1647]

include jpg in recursive doc

- only on oracle for that test
- replace that silly ASCII art thing with the jpg from 0.6

- 0.5.7
- dev status is "stable"

- The "table_names" dialect function, used by MetaData
.reflect(), omits Oracle "index overflow tables", a system
table generated by Oracle when "index only tables"
with overflow are used.  These tables aren't accessible
via SQL and can't be reflected.  [ticket:1637]

- Fixed erroneous reference to "owner" attribute in
Informix dialect when reflecting tables.
[ticket:1645]

- add documented failure for newer pysqlite versions

2.4 change

merged r6556 of trunk for [ticket:1641]

- merged r6553 from trunk
- Session.merge() now properly overwrites a many-to-one or
uselist=False attribute to None if the attribute
is also None in the given object to be merged.

merge r6551 of trunk for [ticket:1354]

- Fixed bug in query.update() when passing Cls.attribute
as keys in the value dict and using synchronize_session='expire'.
[ticket:1436]

merge r6545 of trunk for [ticket:1374]

- merge of trunk r6544
- Session.execute() now locates table- and
mapper-specific binds based on a passed
in expression which is an insert()/update()/delete()
construct. [ticket:1054]

- backport of r6540
- The "use get" behavior of many-to-one relations, i.e. that a
lazy load will fallback to the possibly cached query.get()
value, now works across join conditions where the two compared
types are not exactly the same class, but share the same
"affinity" - i.e. Integer and SmallInteger.  Also allows
combinations of reflected and non-reflected types to work
with 0.5 style type reflection, such as PGText/Text (note 0.6
reflects types as their generic versions).   [ticket:1556]
- types now support an "affinity comparison" operation, i.e.
that an Integer/SmallInteger are "compatible", or
a Text/String, PickleType/Binary, etc.  Part of
[ticket:1556].

- sqlite dialect properly generates CREATE INDEX for a table
that is in an alternate schema.  [ticket:1439]

fixed CHANGES message location

- merge -r6534 of trunk, for [ticket:1618]
- backported 0.6's approach to "null pks allowed" in mapper._instance_processor

some doc reference fixes per [ticket:1597]

- FBDate now extends Date instead of DateTime. [ticket:1573]

merge r6521 from trunk, [ticket:1632]

merge trunk fix r6506 for [ticket:1616]

- Fixed the behavior of extract() to apply operator
precedence rules to the "::" operator when applying
the "timestamp" cast - ensures proper parenthesization.
[ticket:1611]

- Removed unused `load()` method from ShardedQuery.
[ticket:1606]

document NOT IN, IN with query as subq

- Fixed bug in two-phase transaction whereby commit() method
didn't set the full state which allows subsequent close()
call to succeed. [ticket:1603]

- Fixed bug where Query would crash if a join() with no clear
"left" side were called when a non-mapped column entity
appeared in the columns list. [ticket:1602]

- Fixed the call to get_committed_value() on CompositeProperty.
[ticket:1504]

- Added support for reflecting the INTERVAL YEAR TO MONTH
and INTERVAL DAY TO SECOND syntaxes of the INTERVAL
type.  [ticket:460]

- Fixed a slight inaccuracy in the sharding example.
Comparing equivalence of columns in the ORM is best
accomplished using col1.shares_lineage(col2).
[ticket:1491]

- Mutable collection passed to the "extension" attribute
of relation(), column_property() etc. will not be mutated
or shared among multiple instrumentation calls, preventing
duplicate extensions, such as backref populators,
from being inserted into the list.
[ticket:1585]

- Corrected the "has_sequence" query to take current schema,
or explicit sequence-stated schema, into account.
[ticket:1576]

Gaetan's "scopefunc" clarification patch

- Repeat expressions in the columns clause of a select
are deduped based on the identity of each clause element,
not the actual string.  This allows positional
elements to render correctly even if they all render
identically, such as "qmark" style bind parameters.
[ticket:1574]

- Fixed the "numeric" paramstyle, which apparently is the
default paramstyle used by Informixdb.

- A column can be added to a joined-table declarative
superclass after the class has been constructed
(i.e. via class-level attribute assignment), and
the column will be propagated down to
subclasses. [ticket:1570]  This is the reverse
situation as that of [ticket:1523], fixed in 0.5.6.

- Changed the name of TrustedConnection to
Trusted_Connection when constructing pyodbc connect
arguments [ticket:1561]

merged r6383 of trunk for [ticket:1553]

- Added support for reflecting the DOUBLE PRECISION type,
via a new postgres.PGDoublePrecision object.
This is postgresql.DOUBLE_PRECISION in 0.6.
[ticket:1085]

- move the tests to test_query
- the option needs the original mapper to pull the prop from, in the case the eagerload is *from* a joined-table subclass mapper.
had to change the contract of PropertyOption to pass
an additional list "mappers" which contains the actual parent mappers.

merged r6355 from trunk for #1543

fix the toolbar

- some ordering fixes on DISTINCT for PG 8.4, mysql
- forwards compat "postgresql" name available for --db, engine urls

0.5.6

fixes for MySQL (these were not merged from trunk)

merged r6342 from trunk for [ticket:1527]

merged r6340 of trunk, for [ticket:1526]

fix update examples for [ticket:1533]

- merged r6316 from trunk for [ticket:1519]

merged r6314 of trunk for [ticket:1507]

- merged r6312 of trunk for [ticket:1523]

merged r6310 of trunk [ticket:1522]

merge -r6305:6308 of trunk

- Fixed an obscure issue whereby a joined-table subclass
with a self-referential eager load on the base class
would populate the related object's "subclass" table with
data from the "subclass" table of the parent.
[ticket:1485]

this does not belong !

- Fixed column.copy() to copy defaults and onupdates.
[ticket:1373]

0.5 goes to a maint branch

disabled examples test pending necesary repairs

- UPDATE and DELETE do not support ORDER BY, LIMIT, OFFSET,
etc. in standard SQL.  Query.update() and Query.delete()
now raise an exception if any of limit(), offset(),
order_by(), group_by(), or distinct() have been
called. [ticket:1487]

- Simplified the sweep of instrumentation in strategies._register_attribute

- Improved support for MapperProperty objects overriding
that of an inherited mapper for non-concrete
inheritance setups - attribute extensions won't randomly
collide with each other.  [ticket:1488]

- Added AttributeExtension to sqlalchemy.orm.__all__

backported 0.6 r6084 fix for oracle alias names, [ticket:1309]

fix broken orm debug logging

merged [ticket:1486] fix from 0.6

Reverted my screw up of setup.cfg

Corrected examples tests. I was running from ./test instead of root.