Fix almost all read-level sphinx warnings

There are some related to changelog that I can't figure out
and are likely due to something in the changelog extension.
also one thing with a "collection" I can't figure out.

Change-Id: I0a9e6f4291c3589aa19a4abcb9245cd22a266fe0

15 files changed, 13 insertions, 17 deletions

diff --git a/doc/build/orm/collections.rst b/doc/build/orm/collections.rst
index 9e49f7c1e..cba82ef00 100644
--- a/doc/build/orm/collections.rst
+++ b/doc/build/orm/collections.rst
@@ -13,7 +13,6 @@ This section presents additional information about collection configuration
 and techniques.
 
 .. _largecollections:
-.. currentmodule:: sqlalchemy.orm
 
 Working with Large Collections
 ==============================
@@ -185,6 +184,7 @@ database.
     :paramref:`.orm.mapper.passive_deletes` - similar feature on :func:`.mapper`
 
 .. currentmodule:: sqlalchemy.orm.collections
+
 .. _custom_collections:
 
 Customizing Collection Access
diff --git a/doc/build/orm/composites.rst b/doc/build/orm/composites.rst
index e933e81c9..786a6b5be 100644
--- a/doc/build/orm/composites.rst
+++ b/doc/build/orm/composites.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 .. _mapper_composite:
 
diff --git a/doc/build/orm/constructors.rst b/doc/build/orm/constructors.rst
index 4d7268557..ded70a972 100644
--- a/doc/build/orm/constructors.rst
+++ b/doc/build/orm/constructors.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 .. _mapping_constructors:
 
diff --git a/doc/build/orm/extending.rst b/doc/build/orm/extending.rst
index f20f01c18..31e543a85 100644
--- a/doc/build/orm/extending.rst
+++ b/doc/build/orm/extending.rst
@@ -8,5 +8,4 @@ Events and Internals
     events
     internals
     exceptions
-    deprecated
 
diff --git a/doc/build/orm/internals.rst b/doc/build/orm/internals.rst
index fe35178a6..20ddc2b23 100644
--- a/doc/build/orm/internals.rst
+++ b/doc/build/orm/internals.rst
@@ -21,9 +21,6 @@ sections, are listed here.
 .. autoclass:: sqlalchemy.orm.properties.ColumnProperty
     :members:
 
-.. autoclass:: sqlalchemy.orm.descriptor_props.ComparableProperty
-    :members:
-
 .. autoclass:: sqlalchemy.orm.descriptor_props.CompositeProperty
     :members:
 
diff --git a/doc/build/orm/loading_columns.rst b/doc/build/orm/loading_columns.rst
index f36f520b0..d226ad670 100644
--- a/doc/build/orm/loading_columns.rst
+++ b/doc/build/orm/loading_columns.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 ===============
 Loading Columns
diff --git a/doc/build/orm/mapped_attributes.rst b/doc/build/orm/mapped_attributes.rst
index bce40bfb4..535c075c9 100644
--- a/doc/build/orm/mapped_attributes.rst
+++ b/doc/build/orm/mapped_attributes.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 Changing Attribute Behavior
 ===========================
diff --git a/doc/build/orm/mapped_sql_expr.rst b/doc/build/orm/mapped_sql_expr.rst
index e819e1ba8..367139d19 100644
--- a/doc/build/orm/mapped_sql_expr.rst
+++ b/doc/build/orm/mapped_sql_expr.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 .. _mapper_sql_expressions:
 
diff --git a/doc/build/orm/mapping_api.rst b/doc/build/orm/mapping_api.rst
index cd7c379cd..99e0ba52d 100644
--- a/doc/build/orm/mapping_api.rst
+++ b/doc/build/orm/mapping_api.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 Class Mapping API
 =================
diff --git a/doc/build/orm/mapping_columns.rst b/doc/build/orm/mapping_columns.rst
index 7d7b69140..71e145747 100644
--- a/doc/build/orm/mapping_columns.rst
+++ b/doc/build/orm/mapping_columns.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 Mapping Table Columns
 =====================
diff --git a/doc/build/orm/query.rst b/doc/build/orm/query.rst
index 7d54de354..0c1af27bc 100644
--- a/doc/build/orm/query.rst
+++ b/doc/build/orm/query.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 .. _query_api_toplevel:
 
diff --git a/doc/build/orm/relationship_api.rst b/doc/build/orm/relationship_api.rst
index 03045f698..2766c4020 100644
--- a/doc/build/orm/relationship_api.rst
+++ b/doc/build/orm/relationship_api.rst
@@ -1,4 +1,4 @@
-.. automodule:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 Relationships API
 -----------------
diff --git a/doc/build/orm/relationships.rst b/doc/build/orm/relationships.rst
index f5cbac87e..37f59d345 100644
--- a/doc/build/orm/relationships.rst
+++ b/doc/build/orm/relationships.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 .. _relationship_config_toplevel:
 
diff --git a/doc/build/orm/scalar_mapping.rst b/doc/build/orm/scalar_mapping.rst
index 65efd5dbd..e8829af49 100644
--- a/doc/build/orm/scalar_mapping.rst
+++ b/doc/build/orm/scalar_mapping.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm
+.. currentmodule:: sqlalchemy.orm
 
 ===============================
 Mapping Columns and Expressions
diff --git a/doc/build/orm/session_api.rst b/doc/build/orm/session_api.rst
index 683719945..11e37a2c8 100644
--- a/doc/build/orm/session_api.rst
+++ b/doc/build/orm/session_api.rst
@@ -1,4 +1,4 @@
-.. module:: sqlalchemy.orm.session
+.. currentmodule:: sqlalchemy.orm.session
 
 Session API
 ===========