add start-line here to avoid RST parse errors

Fix cross references

Add undocumented members to resolve cross references

Ensure API generation

Ensure API generation and fix cross references

Ensure API doc for make_url and resolve references

Suppress warnings about files not being included in any toctree

Fix indentation and escape *args and **kwargs

Fix indentation and escape *args and **kwargs

add sap sqlanywhere

css updates to better work with RTD badge

- add a section re: using column_reflect for mapping, link to it from the "naming columns distinctly" and "column_prefix" sections since this is often what ppl are looking for.  [ticket:2856] is related.

- Fixed a regression introduced by :ticket:`2818` where the EXISTS
query being generated would produce a "columns being replaced"
warning for a statement with two same-named columns,
as the internal SELECT wouldn't have use_labels set.

merge the same fix from master

no such thing as default_strategy()...

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

- Fixed bug where index reflection would mis-interpret indkey values
when using the pypostgresql adapter, which returns these values
as lists vs. psycopg2's return type of string.
[ticket:2855]

Conflicts:
doc/build/changelog/changelog_09.rst
lib/sqlalchemy/__init__.py

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

0.8.3 release

- Fixed bug where Oracle table reflection using synonyms would fail
if the synonym and the table were in different remote schemas.
Patch to fix courtesy Kyle Derr. [ticket:2853]

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

- Fixed bug where :func:`.type_coerce` would not interpret ORM
elements with a ``__clause_element__()`` method properly.
[ticket:2849]

Conflicts:
lib/sqlalchemy/sql/elements.py

fix python 2.5 ism

- add a type_coerce() step within Enum, Boolean to the CHECK constraint,
so that the custom type isn't exposed to an operation that is against the
"impl" type's constraint, [ticket:2842]
- this change showed up as some recursion overflow in pickling with labels,
add a __reduce__() there....pickling of expressions is less and less something
that's very viable...

Conflicts:
lib/sqlalchemy/sql/elements.py
lib/sqlalchemy/sql/sqltypes.py

- attempt to clarify what mutable extension does for HSTORE, [ticket:2803]

- add a "limitations of reflection" section, [ticket:2233]

Conflicts:
doc/build/core/reflection.rst

use sets here to eliminate ordering as a factor

- Removed a 128-character truncation from the reflection of the
server default for a column; this code was original from
PG system views which truncated the string for readability.
[ticket:2844]

- The change in :ticket:`2721`, which is that the ``deferrable`` keyword
of :class:`.ForeignKeyConstraint` is silently ignored on the MySQL
backend, will be reverted as of 0.9; this keyword will now render again, raising
errors on MySQL as it is not understood - the same behavior will also
apply to the ``initially`` keyword.  In 0.8, the keywords will remain
ignored but a warning is emitted.   Additionally, the ``match`` keyword
now raises a :class:`.CompileError` on 0.9 and emits a warning on 0.8;
this keyword is not only silently ignored by MySQL but also breaks
the ON UPDATE/ON DELETE options.

To use a :class:`.ForeignKeyConstraint`
that does not render or renders differently on MySQL, use a custom
compilation option.  An example of this usage has been added to the
documentation, see :ref:`mysql_foreign_keys`.
[ticket:2721] [ticket:2839]

The ``.unique`` flag on :class:`.Index` could be produced as ``None``
if it was generated from a :class:`.Column` that didn't specify ``unique``
(where it defaults to ``None``).  The flag will now always be ``True`` or
``False``. [ticket:2825]

Conflicts:
lib/sqlalchemy/sql/schema.py

workaround for #2838 here.  still need to figure out why an ENUM test is suddenly hitting this.

alphabetical ordering

-  Added new option to :func:`.relationship` ``distinct_target_key``.
This enables the subquery eager loader strategy to apply a DISTINCT
to the innermost SELECT subquery, to assist in the case where
duplicate rows are generated by the innermost query which corresponds
to this relationship (there's not yet a general solution to the issue
of dupe rows within subquery eager loading, however, when joins outside
of the innermost subquery produce dupes).  When the flag
is set to ``True``, the DISTINCT is rendered unconditionally, and when
it is set to ``None``, DISTINCT is rendered if the innermost relationship
targets columns that do not comprise a full primary key.
The option defaults to False in 0.8 (e.g. off by default in all cases),
None in 0.9 (e.g. automatic by default).   Thanks to Alexander Koval
for help with this. [ticket:2836]

Conflicts:
lib/sqlalchemy/orm/relationships.py

MySQL-connector dialect now allows options in the create_engine
query string to override those defaults set up in the connect,
including "buffered" and "raise_on_warnings".
[ticket:2515]

Parenthesis will be applied to a compound SQL expression as
rendered in the column list of a CREATE INDEX statement.
[ticket:2742]

- Fixed bug in default compiler plus those of postgresql, mysql, and
mssql to ensure that any literal SQL expression values are
rendered directly as literals, instead of as bound parameters,
within a CREATE INDEX statement. [ticket:2742]
- don't need expression_as_ddl(); literal_binds and include_table
take care of this functionality.

Conflicts:
lib/sqlalchemy/sql/util.py

A :func:`.select` that is made to refer to itself in its FROM clause,
typically via in-place mutation, will raise an informative error
message rather than causing a recursion overflow.
[ticket:2815]

Conflicts:
lib/sqlalchemy/sql/selectable.py

Fixed bug where using an annotation such as :func:`.remote` or
:func:`.foreign` on a :class:`.Column` before association with a parent
:class:`.Table` could produce issues related to the parent table not
rendering within joins, due to the inherent copy operation performed
by an annotation. [ticket:2813]

Conflicts:
lib/sqlalchemy/sql/elements.py

Non-working "schema" argument on :class:`.ForeignKey` is deprecated;
raises a warning.  Removed in 0.9. [ticket:2831]

Merge pull request #32 from yoloseem/patch-1

Fix a typo: evaluted -> evaluated.

Fix a typo: evaluted -> evaluated.

- add monetdb
- break out into "production" and "experimental"

- put exact version string in the test
- use match with a .* preceding instead of search

changelog

Merge pull request #26 from hackop/ticket_2819

re.match to re.search

add test for upcoming pullreq

its a feature

changelog

Merge pull request #25 from gthb/ticket_2821

Hide password in URL and Engine __repr__
Conflicts:
lib/sqlalchemy/engine/url.py

fix typo [ticket:2827]

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

Conflicts:
doc/build/changelog/changelog_09.rst

Fixed Query.exists() method for the case, when query doesn't have any filters applied.

Conflicts:
doc/build/changelog/changelog_09.rst

use a different col here to keep oracle happy

plus some more adjustments for mysql, or in general if an Index refers to
in-python only cols

Fixed bug where using the ``column_reflect`` event to change the ``.key``
of the incoming :class:`.Column` would prevent primary key constraints,
indexes, and foreign key constraints from being correctly reflected.
Also in 0.8.3. [ticket:2811]

Conflicts:
doc/build/changelog/changelog_09.rst

- fix a crapload of seealsos
- fix the label on metadata.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

- add version_id documentation [ticket:867]
- add the RETURNING glossary entry
- other "seealso's" fixed
- add doc for eager_defaults option

forgot to add system to the copy() method

added "system=True" to Column, so that we generally don't have to bother
with CreateColumn rules

Merge pull request #23 from yoloseem/master

Fixed two typos.

- The :class:`.CreateColumn` construct can be appled to a custom
compilation rule which allows skipping of columns, by producing
a rule that returns ``None``.  Also in 0.8.3.

Conflicts:
doc/build/changelog/changelog_09.rst
lib/sqlalchemy/sql/ddl.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

formatting

- update the test times, include pypy, clean up the script

add FAQ entry on large inserts

fix link

move FAQ to the docs, [ticket:2133]

Conflicts:
doc/build/index.rst

yikes return the modname if no lookup found...

dont need to translate all these names

too small!

add some height

additoinal

cherry pick of 9302be39a5f40b537ff43e1990c7a210c464cf1c from 0.9
Conflicts:
lib/sqlalchemy/sql/selectable.py

- reorganize docs so expression, schema are broken out into subfiles, they're too big
- fix the targeting of module names moved around by using custom handlers for "Bases", etc.

cherry pick of 0c19c1c66f3a115f5ce710de571552d68fac6358 from 0.9.   there's likely issues to be fixed.

pypy pickle isn't "bulletproof"

apply test skips for pypy issue #1573 in 0.8 [ticket:2805]

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

changelog adjust...

- use newly fixed WeakSequence (#2794) to not have to rely on class name for sorting in #2779

- add WeakSequence.append()
- fix and test weakref cleanout for WeakSequence, [ticket:2794]

Backported a change from 0.9 whereby the iteration of a hierarchy
of mappers used in polymorphic inheritance loads is sorted on class name,
which allows the SELECT statements generated for polymorphic queries
to have deterministic rendering, which in turn helps with caching
schemes that cache on the SQL string itself.
[ticket:2779]

fix the merge

Fixed a potential issue in an ordered sequence implementation used
by the ORM to iterate mapper hierarchies; under the Jython interpreter
this implementation wasn't ordered, even though cPython and Pypy
maintained ordering.  Also in 0.8.3.
[ticket:2794]

Conflicts:
doc/build/changelog/changelog_09.rst
lib/sqlalchemy/util/_collections.py

- also do delete, add seealsos, formatting, etc. [ticket:2798]

- add better notes to query.update(), most notably how to deal with a joined table
update, [ticket:2798]

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

0.8 changelog

- changelog
- clean up these tests to not use globals so much, close out the session

Conflicts:
doc/build/changelog/changelog_09.rst
examples/versioning/test_versioning.py

Merged in prschmid/sqlalchemy (pull request #4)

Made primary_key autoincrement=False in versioning example.

Merged in bacher09/sqlalchemy (pull request #5)

Fix typo in comparator_factory example

add some more detail about concurrency

- more "when do i create the session" docs, get specific
- more glossary terms
- turn the session FAQ into rst sections at last

add more docs to index, even though this seems to be a little redundant

Merge pull request #21 from svrin/patch-1

Typo in engines.rst

- The :meth:`.Operators.notin_` operator added in 0.8 now properly
produces the negation of the expression "IN" returns
when used against an empty collection.  Also in 0.8.3.

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

Conflicts:
doc/build/changelog/changelog_09.rst

- update ORM event docs to include that you can listen on an unmapped base,
[ticket:2777]

Conflicts:
lib/sqlalchemy/orm/events.py

fix cahngelog

- 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.  Also in 0.7.11.
[ticket:2783]