Repair formatting throughout documentation

1. Section decorators to [one style](http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#sections):
without inset at both side and with same length as text.
2. Fix broken [reference](http://docs.sqlalchemy.org/en/latest/core/type_basics.html#generic-types).
3. Convert tabs to space in some small files.
4. Some python code snippets have python+sql syntax hint.

Change-Id: I39a7a41ef0b0591c6bf1e610748e2b5c19fc5379
Pull-request: #361
(cherry picked from commit 42b6ef8)

Author: Kataev Denis

doc/build/changelog/changelog_01.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.1 Changelog
-==============
+=============
 
 
 .. changelog::

doc/build/changelog/changelog_02.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.2 Changelog
-==============
+=============
 
 
 .. changelog::

doc/build/changelog/changelog_03.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.3 Changelog
-==============
+=============
 
 
 .. changelog::

doc/build/changelog/changelog_04.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.4 Changelog
-==============
+=============
 
 
 .. changelog::

doc/build/changelog/changelog_05.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.5 Changelog
-==============
+=============
 
 
 .. changelog::

doc/build/changelog/changelog_06.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.6 Changelog
-==============
+=============
 
 
 .. changelog::

doc/build/changelog/changelog_07.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.7 Changelog
-==============
+=============
 
 .. changelog::
     :version: 0.7.11

doc/build/changelog/changelog_08.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.8 Changelog
-==============
+=============
 
 .. changelog_imports::
 

doc/build/changelog/changelog_09.rst

@@ -1,7 +1,7 @@
 
-==============
+=============
 0.9 Changelog
-==============
+=============
 
 .. changelog_imports::
 

doc/build/changelog/changelog_10.rst

@@ -1,8 +1,8 @@
 
 
-==============
+=============
 1.0 Changelog
-==============
+=============
 
 .. changelog_imports::
 

doc/build/changelog/changelog_11.rst

@@ -1,8 +1,8 @@
 
 
-==============
+=============
 1.1 Changelog
-==============
+=============
 
 .. changelog_imports::
 

doc/build/changelog/index.rst

@@ -7,7 +7,7 @@ SQLAlchemy changelogs and migration guides are now integrated
 within the main documentation.
 
 Current Migration Guide
-------------------------
+-----------------------
 
 .. toctree::
    :titlesonly:

doc/build/changelog/migration_06.rst

@@ -1,6 +1,6 @@
-==============================
+=============================
 What's New in SQLAlchemy 0.6?
-==============================
+=============================
 
 .. admonition:: About this Document
 

doc/build/changelog/migration_07.rst

@@ -1,6 +1,6 @@
-==============================
+=============================
 What's New in SQLAlchemy 0.7?
-==============================
+=============================
 
 .. admonition:: About this Document
 

doc/build/changelog/migration_08.rst

@@ -1,6 +1,6 @@
-==============================
+=============================
 What's New in SQLAlchemy 0.8?
-==============================
+=============================
 
 .. admonition:: About this Document
 
@@ -527,7 +527,7 @@ the :class:`.Table` to which ``User`` is mapped.
 :ticket:`2245`
 
 Query.update() supports UPDATE..FROM
--------------------------------------
+------------------------------------
 
 The new UPDATE..FROM mechanics work in query.update().
 Below, we emit an UPDATE against ``SomeEntity``, adding
@@ -576,7 +576,7 @@ that were not flushed in the current transaction.
 :ticket:`2452`
 
 Caching Example now uses dogpile.cache
----------------------------------------
+--------------------------------------
 
 The caching example now uses `dogpile.cache <https://dogpilecache.readthedocs.io/>`_.
 Dogpile.cache is a rewrite of the caching portion
@@ -607,7 +607,7 @@ this change is needed as illustrated in the Beaker example::
 :ticket:`2589`
 
 New Core Features
-==================
+=================
 
 Fully extensible, type-level operator support in Core
 -----------------------------------------------------
@@ -686,7 +686,7 @@ as more string, integer and date operators.
 .. _feature_2623:
 
 Multiple-VALUES support for Insert
------------------------------------
+----------------------------------
 
 The :meth:`.Insert.values` method now supports a list of dictionaries,
 which will render a multi-VALUES statement such as
@@ -708,7 +708,7 @@ remains unchanged::
 :ticket:`2623`
 
 Type Expressions
------------------
+----------------
 
 SQL expressions can now be associated with types.  Historically,
 :class:`.TypeEngine` has always allowed Python-side functions which
@@ -753,7 +753,7 @@ to embed PostGIS expressions inline in SQL based on type rules.
 :ticket:`1534`
 
 Core Inspection System
------------------------
+----------------------
 
 The :func:`.inspect` function introduced in :ref:`feature_orminspection_08`
 also applies to the core.  Applied to an :class:`.Engine` it produces
@@ -1241,7 +1241,7 @@ the previous behavior.
 :ticket:`2664`
 
 Repaired the Event Targeting of :class:`.InstrumentationEvents`
-----------------------------------------------------------------
+---------------------------------------------------------------
 
 The :class:`.InstrumentationEvents` series of event targets have
 documented that the events will only be fired off according to

doc/build/changelog/migration_10.rst

@@ -1,6 +1,6 @@
-==============================
+=============================
 What's New in SQLAlchemy 1.0?
-==============================
+=============================
 
 .. admonition:: About this Document
 
@@ -41,7 +41,7 @@ to proceed at speeds that rival direct use of the Core.
 :ticket:`3100`
 
 New Performance Example Suite
-------------------------------
+-----------------------------
 
 Inspired by the benchmarking done for the :ref:`bulk_operations` feature
 as well as for the :ref:`faq_how_to_profile` section of the FAQ, a new
@@ -94,7 +94,7 @@ once, a query as a pre-compiled unit begins to be feasible::
 .. _feature_3150:
 
 Improvements to declarative mixins, ``@declared_attr`` and related features
-----------------------------------------------------------------------------
+---------------------------------------------------------------------------
 
 The declarative system in conjunction with :class:`.declared_attr` has been
 overhauled to support new capabilities.
@@ -322,7 +322,7 @@ object totally smokes both namedtuple and KeyedTuple::
 .. _feature_slots:
 
 Significant Improvements in Structural Memory Use
---------------------------------------------------
+-------------------------------------------------
 
 Structural memory use has been improved via much more significant use
 of ``__slots__`` for many internal objects.  This optimization is
@@ -353,7 +353,7 @@ well as weakrefs, within a basic import of "nova.db.sqlalchemy.models"::
 .. _feature_updatemany:
 
 UPDATE statements are now batched with executemany() in a flush
-----------------------------------------------------------------
+---------------------------------------------------------------
 
 UPDATE statements can now be batched within an ORM flush
 into more performant executemany() call, similarly to how INSERT
@@ -418,7 +418,7 @@ of inheritance-oriented scenarios, including:
 .. _bug_3227:
 
 Session.get_bind() will receive the Mapper in all relevant Query cases
------------------------------------------------------------------------
+----------------------------------------------------------------------
 
 A series of issues were repaired where the :meth:`.Session.get_bind`
 would not receive the primary :class:`.Mapper` of the :class:`.Query`,
@@ -501,7 +501,7 @@ as remaining ORM constructs such as :func:`.orm.synonym`.
 .. _bug_3188:
 
 ColumnProperty constructs work a lot better with aliases, order_by
--------------------------------------------------------------------
+------------------------------------------------------------------
 
 A variety of issues regarding :func:`.column_property` have been fixed,
 most specifically with regards to the :func:`.aliased` construct as well
@@ -583,7 +583,7 @@ New Features and Improvements - Core
 .. _feature_3034:
 
 Select/Query LIMIT / OFFSET may be specified as an arbitrary SQL expression
-----------------------------------------------------------------------------
+---------------------------------------------------------------------------
 
 The :meth:`.Select.limit` and :meth:`.Select.offset` methods now accept
 any SQL expression, in addition to integer values, as arguments.  The ORM
@@ -826,7 +826,7 @@ the :class:`.Constraint` is constructed::
 .. _feature_insert_from_select_defaults:
 
 INSERT FROM SELECT now includes Python and SQL-expression defaults
--------------------------------------------------------------------
+------------------------------------------------------------------
 
 :meth:`.Insert.from_select` now includes Python and SQL-expression defaults if
 otherwise unspecified; the limitation where non-server column defaults
@@ -1354,7 +1354,7 @@ joined loader options can still be used::
 .. _bug_3233:
 
 Changes and fixes in handling of duplicate join targets
---------------------------------------------------------
+-------------------------------------------------------
 
 Changes here encompass bugs where an unexpected and inconsistent
 behavior would occur in some scenarios when joining to an entity
@@ -2155,7 +2155,7 @@ state.
 .. _feature_3084:
 
 MetaData.sorted_tables accessor is "deterministic"
------------------------------------------------------
+--------------------------------------------------
 
 The sorting of tables resulting from the :attr:`.MetaData.sorted_tables`
 accessor is "deterministic"; the ordering should be the same in all cases
@@ -2264,7 +2264,7 @@ flag::
 :ticket:`3319`
 
 New PostgreSQL Table options
------------------------------
+----------------------------
 
 Added support for PG table options TABLESPACE, ON COMMIT,
 WITH(OUT) OIDS, and INHERITS, when rendering DDL via
@@ -2398,14 +2398,14 @@ by PostgreSQL as of 9.4.  SQLAlchemy allows this using
     :class:`.FunctionFilter`
 
 PG8000 dialect supports client side encoding
----------------------------------------------
+--------------------------------------------
 
 The :paramref:`.create_engine.encoding` parameter is now honored
 by the pg8000 dialect, using on connect handler which
 emits ``SET CLIENT_ENCODING`` matching the selected encoding.
 
 PG8000 native JSONB support
---------------------------------------
+---------------------------
 
 Support for PG8000 versions greater than 1.10.1 has been added, where
 JSONB is supported natively.
@@ -2421,12 +2421,12 @@ Support for the pypy psycopg2cffi dialect is added.
     :mod:`sqlalchemy.dialects.postgresql.psycopg2cffi`
 
 Dialect Improvements and Changes - MySQL
-=============================================
+========================================
 
 .. _change_3155:
 
 MySQL TIMESTAMP Type now renders NULL / NOT NULL in all cases
---------------------------------------------------------------
+-------------------------------------------------------------
 
 The MySQL dialect has always worked around MySQL's implicit NOT NULL
 default associated with TIMESTAMP columns by emitting NULL for
@@ -2449,7 +2449,7 @@ columns.
 .. _change_3283:
 
 MySQL SET Type Overhauled to support empty sets, unicode, blank value handling
--------------------------------------------------------------------------------
+------------------------------------------------------------------------------
 
 The :class:`.mysql.SET` type historically not included a system of handling
 blank sets and empty values separately; as different drivers had different
@@ -2582,7 +2582,7 @@ and is generally in decent working order, if someone wants to pick up
 on polishing it.
 
 Dialect Improvements and Changes - SQLite
-=============================================
+=========================================
 
 SQLite named and unnamed UNIQUE and FOREIGN KEY constraints will inspect and reflect
 -------------------------------------------------------------------------------------
@@ -2632,7 +2632,7 @@ to control the behavior completely, based on deprecation guidelines from
 Microsoft.  See :ref:`mssql_large_type_deprecation` for details.
 
 Dialect Improvements and Changes - Oracle
-=============================================
+=========================================
 
 .. _change_3220:
 
@@ -2653,7 +2653,7 @@ CTE support has been fixed up for Oracle, and there is also a new feature
 :ticket:`3220`
 
 New Oracle Keywords for DDL
------------------------------
+---------------------------
 
 Keywords such as COMPRESS, ON COMMIT, BITMAP: